NetBeans 6.1 a Nástroje na testování accessibility - a11y

Autor české verze: Jaromír Uhřík

Nástroj na testování a11y je distribuován jako .nbm (NetBeans modul) od doby, kdy byl vypuštěn produkt NetBeans ve verzi 4.0. To proto, že tento nástroj je nejběžněji používán uvnitř NetBeans. Momentálně je k dispozici následující .NBM tohoto modulu:

• 2.5.1 - compatibilní s NetBeans 6.1 a novějšími (jdk1.5 a novější)

Aktuální verze 2.5.1 je primárně kompatibilní se současnými NetBeans 6.1 buildy. Tento dokument ukazuje jak stáhnout, nainstalovat a používat Nástroj pro testování a11y ( a11y.nbm) verze 2.5.1 uvnitř NetBeans 6.1 IDE (postup pro předchozí verze je analogický):

1. instalace z update centra (preferovaný způsob instalace)
2. ostatní způsoby instalace
   1. stažení modulu
   2. instalace modulu
   3. testování oken NetBeans
   4. testování oken u aplikací (mimo NetBeans !!! - samostatné aplikace)
   5. testování oken aplikací pomocí XTest-testů

 

1. Instalace z update centra (preferovaný způsob instalace)

Pro instalaci z update centra pomocí plugin manageru je nejprve zapotřebí přidat update provider do seznamu providerů v plugin manageru. Poté je možné nainstalovat plugin standardním způsobem. Postup přidání update provideru do NetBeans je následující:

• vybereme v main menu Tools|Plugins
• zvolíme záložku Settings a zmačkneme tlačítko Add
• do políčka URL vložíme "http://a11y.netbeans.org/nbms/updates.xml"
• potvrdíme dialog a v záložce Available Plugins se objeví plugin Accessibility
• po nainstalování pluginu Accessibility je vynucen restart IDE
• po restartu IDE se v toolbaru objeví ikona accessibility testeru

 

2.1. Stažení modulu

Existují 3 standardní cesty jak získat modul:

• stáhnou si jej z webových stránek http://a11y.netbeans.org/nbms/v2.3/a11y.nbm
• vyčekovat z cvs (nachází se pod modulem a11y na cestě www/nbms/v2.5.1/org-netbeans-modules-a11y.nbm)
• vybuildovat .nbm ze zdrojových souborů

Uložte si soubor a11y.nbm lokálně na váš hard-disk a následujte kroky standardní instalace přes NetBeans Plugin Manager.

 

2.2. Instalace a spuštění modulu

Nezbytné jsou pouze následující kroky:

1. Ke spuštění Accessibility Testeru pro testování dialogů IDE musíte spustit IDE s přepínačem:
   -J-Da11ytest.IDE=true
   Od verze accessibility testeru 2.5.1 je tento přepínač odstraněn.
2. Spusťte Plugin Manager (vyberte z hlavního menu Tools|Plugins)
3. Zvolte "Downloaded" tab, stiskněte tlačítko "Add Plugins..." instalaci lokálních modulů a najděte stažený a11y.nbm modul
4. Postupujte wizardem přes proces stahování
5. Po úspěšném nainstalování se v NetBeans toolbaru objeví nová kategorie s ikonou symbolizující postižení (   - UIAccessibilityTester)
6. Stačí kliknout na ikonu a tester tool se spustí

 

2.3. Testování oken NetBeans (MDI,SDI)

Ke spuštění AccessibilityTesteru pro testování oken a dialogů IDE musíte nainstalovat a11y.nbm a spustit IDE s přepínačem:
-J-Da11ytest.IDE=true Od verze accessibility testeru 2.5.1 je tento přepínač odstraněn.

Po instalaci se objeví nový toolbar s akcí pro spuštění nástroje.

Musíme provést následující kroky:

• stlačit tlačítko (   - UIAccessiibilityTester) z Accessibility Toolbaru
• nové okno (UIAccessibilityTester) se otevře (poze při prvním spuštění)
• připravíme si nastavení pro testování
• klikneme na tlačítko "Run"
• otevřeme okno, které chceme testovat
• stlačíme Ctrl-F11
• výsledky testování jsou zapsány do nastaveného výstupu (nastavuje se v záložce Test results)
• nový AWT-strom testovaného okna je přidán jako záložka do panelu UIAccessibilityTesteru

 

2.4. Testování oken applikací (bez NetBeans - jako nezávislé aplikace)

Pro spuštění UIAccessibilityTester je třeba mít a11y.jar a nainstalované JDK. Získat a11y.jar je snadné. Jelikož a11y.nbm je vlastnž .zip soubor - stačí jej přejmenovat na a11y.zip a rozbalit. A11y.jar file se nachází v adresáři /netbeans/modules/ souboru a11y.zip.

Třída UIAccessibilityTester se nachází v org.netbeans.a11y.tester adresáři obsaženém v tomto a11y.jar. Před tím, než ji spustíte, potřebujete nastavit příslušnou proměnnou prostředí a to podle těchto instrukcí:

1. Nakopírovat a11y.jar do $JDKHOME/jre/lib/ext adresáře vaší JDK instalace.
2. Modifikovat (pokud neexistuje, tak vytvořit) soubor $JDKHOME/jre/lib/accessibility.properties tak aby obsahoval následujíci řádek:

              assistive_technologies=org.netbeans.a11y.tester.UIAccessibilityTester

Po těchto krocích máme vše připraveno pro spuštění UIAccessibilityTesteru.

Poznámka:
Po provedení předchozích instrukcí se bude UIAccessibilityTester automaticky spouštět pokaždé když spustíte libovolnou Java aplikaci.

 

2.5. Testování oken applikací pomocí XTest-testů

Abyste mohli spouštět AccessibilityTester pro testování accessibility oken pomocí XTest musíte napsat třídu, která rozšiřuje org.netbeans.a11y.harness.XTestAccessibilityTestCase.

Musíte udělat přesně tyto kroky:

• nechat aby vaše třída extendovala XTestAccessibilityTestCase
• musíte napsat metodu getTestedComponent() vracející testovanou komponentu
• můžete napsat metodu setSettingsFile() vracející soubor s nastavením pro accessibility test (pokud není použito defaultní nastavení)

a11y.jar musí být dostupný pro kompilaci a běh testů:

• nakopírujte a11y.jar do přístupného adresáře, například do <test directory>/qa-funstional/jars
• úpravy v konfiguračním souboru XTestu build.xml.
  
  - extends xtest.extra.jars.path, například :

                  <property name="xtest.extra.jars.path" location="${ffj.repository}/testtools/jemmy/;qa-functional/jars"/>
                 

  - extends xtest.extra.jars, například :

                  <property name="xtest.extra.jars" value="a11y.jar"/>
                 

• vyrobíme golden file testAccessibility.pass do příslušného adresáře, například do
  <test directory>/qa-functional/src/data/goldenfiles/MainFrameTest/