# Accerciser-Handbuch v0.2.0

2006
2007
2008
IBM Corporation
2009
Mario Blättermann (mariobl@gnome.org)
GNOME-Dokumentationsprojekt
Eitan
Isaacson
Accerciser-Team

     eitan@ascender.com

Peter
Parente
Accerciser-Team

     pparent@us.ibm.com

Accerciser-Handbuch v0.2.0
29. Juni 2007

Eitan Isaacson eitan@ascender.com

Accerciser-Team

Dieses Handbuch beschreibt Version 0.1.5 von Accerciser.

Dieses Handbuch beschreibt die Benutzung von Accerciser.

## Rückmeldungen

Um Fehler zu melden oder einen Vorschlag zur Anwendung Accerciser oder zu diesem Handbuch zu machen, folgen Sie den Anweisungen auf der GNOME-Seite für Rückmeldungen.

## Einführung

Accerciser ist ein interaktiver Barrierefreiheits-Untersucher für den GNOME-Desktop. Dabei kommt AT-SPI zum Inspizieren und Steuern von Widgets zum Einsatz, wodurch Sie überprüfen können, ob eine Anwendung korrekte Informationen für Hilfstechnologien und automatisierte Testumgebungen bereitstellt. Accerciser verfügt über eine einfache Plugin-Umgebung, welche Sie zur Erstellung benutzerdefinierter Ansichten der Informationen für Hilfstechnologien nutzen können.

Im Wesentlichen ist Accerciser ein at-poke-Werkzeug der neuesten Generation.

## Erste Schritte

### Accerciser starten

Sie können Accerciser auf folgende Arten starten:

Menü Anwendungen

  Wählen Sie Entwicklung Accerciser.

Befehlszeile

  Geben Sie den folgenden Befehl in einem Konsolenfenster ein und drücken Sie die Eingabetaste:

  `accerciser`

### Beim Start von Accerciser

Wenn Sie Accerciser starten, wird folgendes Fenster angezeigt.

#### Accerciser-Hauptfenster

Zeigt das Accerciser-Hauptfenster. Enthält Titelleiste, Menüleiste, Barrierefreiheits-Baum, rechter Anzeigebereich für Plugins, und unterer Anzeigebereich für Plugins. Die Menüleiste enthält die Menüs »Datei«, »Bearbeiten«, »Lesezeichen«, »Ansicht« und »Hilfe«.

Das Accerciser-Fenster enthält die folgenden Elemente:

Menüleiste

  Die Menüleiste enthält Befehle zum Verwalten von Plugins, zum Verwalten und Benutzen von Lesezeichen, zum Aktualisieren der Barrierefreiheits-Baumansicht und für den Zugriff auf vorliegendes Hilfesystem.

Barrierefreiheits-Baumansicht

  Die Barrierefreiheits-Baumansicht ermöglicht Ihnen die Ansicht aller Accesibles, beginnend auf Desktop-Ebene. Die Auswahl eines Accessibles aktiviert es für die weitere Inspektion unter Verwendung der geladenen Plugins.

Rechte Plugin-Ansicht

  Dies ist eine der beiden vorgegebenen Plugin-Ansichten. Wenn Accerciser zum ersten Mal gestartet wird, dann finden sich die meisten Plugins hier. Sie können Plugins mit der Maus in die untere Plugin-Ansicht oder auf den Desktop ziehen, um zwei oder mehr Plugins gleichzeitig zu betrachten.

Untere Plugin-Ansicht

  Sie können Plugins aus diesem oder in diesen Bereich ziehen, wie beispielsweise in die rechte Plugin-Ansicht.

### Verwaltung der Plugin-Ansicht

Accerciser benutzt zwei verschiedene Modi für die Anzeige der Plugins. Der gegenwärtige Modus kann über das Menü Ansicht Einzelne Plugin-Ansicht oder durch Drücken von Strg t auf den jeweils anderen Modus umgeschaltet werden. Wenn der Einzelmodus aktiviert ist, werden alle Plugins in die rechte Plugin-Ansicht gesetzt und alphabetisch geordnet, was für Bildschirmbenutzer nützlich ist, die keine Verwendung für das flexible räumliche Anordnungsschema von Accerciser haben. Wenn der Einzelmodus deaktiviert ist, dann können die Plugin-Reiter durch Ziehen und Ablegen in verschiedene Plugin-Ansichten verschoben werden, oder auch auf den Desktop, um das Plugin in einer neuen Ansicht darzustellen. Die Platzierung der Plugins kann auch über das Kontextmenü eines Plugins verändert werden. Das Kontextmenü erreichen Sie entweder über den Plugin-Reiter oder über den Einstellungsdialog für Plugins.

## Benutzung

Sie können Accerciser dazu verwenden, jedes beliebige in der Baumansicht angezeigte Accessible-Widget mit Hilfe der verfügbaren Plugins zu inspizieren. Zunächst müssen Sie nach einer der folgenden Vorgehensweisen ein Accessible auswählen:

### Wählen Sie ein Accessible in der Baumansicht aus.

Verwenden Sie die Baumansicht, um sich durch die Hierarchie der Accessible-Objekte zu bewegen, beginnend auf Desktop-Ebene. Ausklappen eines Knotens macht die direkten Kind-Objekte sichtbar, während Einklappen diese wieder verbirgt. Jeder Knoten zeigt ein Symbol für die zugehörige Anwendung oder die zugehörige Widget-Funktion sowie den Accessible-Namen, falls verfügbar. Die zweite Spalte zeigt an, wie viele Knoten angezeigt werden, wenn das Objekt ausgeklappt wird.

### Verwendung von Lesezeichen

Accerciser erlaubt es, gewählte Accessibles als Lesezeichen zu setzen, um diese später zu prüfen. Das könnte nützlich sein, wenn die Zielanwendung neu gestartet werden muss, zum Beispiel nach einer Neukompilierung. Um das gegenwärtig ausgewählte Accessible als Lesezeichen zu setzen, wählen Sie Lesezeichen Lesezeichen hinzufügen … oder drücken Sie Strg d.

Lesezeichen für Accessibles in Accerciser sind durch einen Anwendungsnamen und einen »Pfad« zum Accessible-Lesezeichen in der internen Accessible-Hierarchie der Anwendung definiert. Wenn die Zielanwendung mehrere Zustände hat, zum Beispiel bei mehreren Frames in der obersten Ebene, könnte dieser Pfad inkorrekt sein.

Lesezeichen können im Lesezeichendialog bearbeitet werden, den Sie über Lesezeichen Lesezeichen bearbeiten erreichen.

## Standard-Plugins

Accerciser liefert einige Standard-Plugins mit. Diese Plugins ermöglichen Ihnen die Betrachtung diverser Informationen über das ausgewählte Accessible in der Baumansicht und den anderen Ansichten. Die folgenden Plugins sind in der Version 0.1.5 bereits enthalten:

### Schnittstellenanzeige

Dieses Plugin zeigt Informationen über die verfügbaren Schnittstellen für das in der Baumansicht ausgewählte Accessible an. Nicht unterstützte Schnittstellen werden ausgegraut dargestellt. Verschiedene Werkzeuge für die Ansicht und Steuerung einer Schnittstelle sind durch Ausklappen des jeweiligen Expanders verfügbar.

#### Schnittstellenanzeige

Schnittstellen, die von dem ausgewählten Accessible unterstütz werden, sind anklickbar dargestellt.

### Ereignisüberwachung

Dieses Plugin überwacht die ausgewählten Ereignistypen aus dem in der Baumansicht gewählten Accessible, der in der Baumansicht gewählten Anwendung oder dem gesamten Desktop.

#### Ereignisüberwachung

Der untere Teil der Ereignisüberwachung ermöglicht Ihnen die Auswahl des Typs und der Quelle von Ereignissen.

Durch Drücken von Strg Alt l an einer beliebigen Stelle auf dem Desktop wird das letzte aufgezeichnete Ereignis für spätere Referenz hervorgehoben. Informationen darüber, wie Sie diese Tastenkombination ändern können, finden Sie in .

### IPython-Konsole

Dieses Plugin ist eine ausgewachsene IPython-Konsole. Drücken Sie Tab, um Vervollständigungen für den gegenwärtigen Befehl anzuzeigen. Drücken Sie die Eingabetaste, um jeglichen gültigen Python-Code auszuführen. Die Befehle in der Konsole haben über die Variable `acc` Zugriff auf das gegenwärtig ausgewählte Accessible. Zusätzlich sind alle Funktionen und Konstanten aus dem Paket »pyatspi« lokal in der Konsole verfügbar. Die bedeutendsten dieser Funktionen sind Abfragen anderer Barrierefreiheits-Schnittstellen. Beispielsweise können Sie die Text-Schnittstelle so abfragen: `t = acc.queryText()` . Importieren aus dem aktuellen Arbeitsordner oder Python-Pfad ist ebenfalls möglich.

### API-Browser

Dieses Plugin zeigt die von dem in der Baumansicht gewählten Accessible unterstützten Schnittstellen, Methoden und Attribute.

#### API-Browser

Der API-Browser.

### Skript-Aufzeichner

Der Skript-Aufzeichner von Accerciser ermöglicht Benutzern, die Interaktion der Tastatur mit anderen Desktop-Anwendungen aufzuzeichnen, um diese später in einem Testskript für die betreffende Benutzeroberfläche wiederzuverwenden. Gegenwärtig unterstützt dieses Plugin die Erzeugung von Skripten für drei Plattformen: Dogtail, LDTP, und die in Accerciser eingebaute API. Sobald Sie auf »Auzeichnen« klicken, werden sämtliche Tastatur-Interaktionen in ein Skript geschrieben, das später als ausführbares Shell-Skript gestartet werden kann.

#### Skript-Aufzeichner

Der Skript-Aufzeichner.

### Schnellauswahl

Dieses Plugin stellt globale Tastenkürzel bereit, über die Sie Accessibles einfach über die Benutzeroberfläche der Zielanwendung auswählen können. Durch Drücken von Strg Alt a wählen Sie das letzte fokussierte Accessible eines Widgets in Accerciser aus. Mit Strg Alt t wählen Sie das Accessible des Widgets aus, das sich unter dem Mauszeiger befindet.

### Validierung

Dieses Plugin überprüft Anwendungen auf Barrierefreiheits-Probleme und erzeugt einen Report, der die Wichtigkeit und die Beschreibung der Probleme enthält. Der Report verknüpft Fehler, um zu dokumentieren, wie häufige Probleme behoben werden können. Dieses Plugin ist mit Test-Schemata erweiterbar, welche Regeln für die Überprüfung definieren.

Um die Validierung zu starten, wählen Sie zunächst ein Objekt im Barrierefreiheits-Baum aus. Das Plugin überprüft das ausgewählte Accessible sowie alle seine Abkömmlinge. Klicken Sie dann auf den Knopf Überprüfen, um den Test zu starten. Während der Test ausgeführt wird, können Sie erneut auf den Knopf klicken, um den Test abzubrechen.

Wenn der Test abgeschlossen ist, zeigt die Report-Tabelle die Wichtigkeit und Beschreibung aller Fehler an. Doppelklicken Sie auf eine Zeile in der Tabelle, um das zugehörige Accessible in der Baumansicht anzuzeigen. Wenn das Objekt ausgewählt ist, dann klicken Sie auf Hilfe, um Informationen über Lösungsmöglichkeiten des Problems zu erhalten.

## Einstellungen

Einige Elemente in Accercisersind konfigurierbar:

### Plugin-Layout

Es gibt zwei Methoden zur Konfiguration des Plugin-Layouts in Accerciser. Über das Menü Bearbeiten Einstellungen öffnen Sie den Dialog Einstellungen. Dieser Dialog enthält Reiter für jeden Abschnitt. Wählen Sie den Reiter Plugins. In diesem Abschnitt finden Sie eine Listenansicht aller verfügbaren Plugins. Durch einen Klick mit der rechten Maustaste auf eines der Plugins können Sie dessen Ansicht konfigurieren.

Sie können den Dialog Einstellungen umgehen, indem Sie die Plugin-Reiter durch Ziehen und Ablegen mit der Maus verschieben. Das Ziehen und Ablegen eines Plugins in die jeweils andere Plugin-Ansicht verschiebt es dorthin, das Ablegen auf dem Desktop öffnet hingegen ein neues Plugin-Fenster und legt das Plugin in diesem Fenster ab.

### Globale Konfiguration der Tastenkürzel

Einige Elemente in Accerciser aktivieren verschiedene Funktionalitäten über Tastenkürzel. Die Tastenkombinationen können im Dialog Einstellungen geändert werden, den Sie über Bearbeiten Einstellungen öffnen können. Dieser Dialog enthält Reiter für jeden Abschnitt. Wählen Sie den Reiter Globale Tastenkürzel. In diesem Abschnitt finden Sie eine Listenansicht aller verfügbaren Funktionsmerkmale, die Sie über Tastenkürzel erreichen können. Ändern Sie hier die Tastenkürzel nach Ihren Wünschen.

## Über Accerciser

Accerciser wurde von Eitan Isaacson (eitan@ascender.com) geschrieben. Weitere Informationen über Accerciser finden Sie auf der GNOME Live!-Webseite von Accerciser.

Um Fehler zu melden oder einen Vorschlag zur Anwendung Accerciser oder zu diesem Handbuch zu machen, folgen Sie den Anweisungen in diesem Dokument.

Weiterverbreitung und Benutzung im Binär- oder Quellcodeformat, mit oder ohne Änderungen, sind unter den Bedingungen der BSD-Lizenzt erlaubt.