API-Referenz
Informationen zu den öffentlichen Klassen und Funktionen der Bibliothek.
Wenn Sie automatisierte Tests einrichten, setzen Sie das Instrumentierungsregister, das es Axe DevTools für Android ermöglicht, sich mit den Informationen der Accessibility-Nodes zu verbinden. Beziehen Sie sich auf die öffentlichen Klassen und Funktionen der Bibliothek unten, während Sie Ihre Tests erstellen.
Initialisierung von AxeDevTools
Verwenden Sie die folgenden APIs, wenn Sie die AxeDevTools-Bibliothek initialisieren.
startScanSession(params)
Authentifiziert einen API-Schlüssel und initialisiert eine Testsitzung. Die Projekt-ID ist erforderlich, um Ergebnisse im Axe Developer Hub zu veröffentlichen.
Erforderlich param:
| Name | Typ | Beschreibung |
|---|---|---|
| apiKey | String |
Deque API-Schlüssel |
Optional param:
| Name | Typ | Beschreibung |
|---|---|---|
| projectId | String |
Axe Developer Hub Projekt-ID |
| axeAccountUrl | String |
Definiert die Server-URL zur Verbindung |
startSession(params)
Erzeugt ein Auth-Token und initialisiert eine Testsitzung. Fügen Sie die Projekt-ID hinzu, um Ergebnisse im Axe Developer Hub zu veröffentlichen. Diese API wird 2026 veraltet sein. Verwenden Sie startScanSession stattdessen.
Erforderlich param:
| Name | Typ | Beschreibung |
|---|---|---|
| apiKey | String |
Deque API-Schlüssel |
Optional param:
| Name | Typ | Beschreibung |
|---|---|---|
| projectId | String |
Axe Developer Hub Projekt-ID |
| serverUrl | String |
Definiert die Server-URL zur Verbindung |
loginWithUsername(params)
Erzeugt ein Auth-Token zur Verbindung mit dem Dashboard. Diese API wird 2026 veraltet sein. Verwenden Sie startScanSession stattdessen.
Erforderlich params:
| Name | Typ | Beschreibung |
|---|---|---|
| Benutzername | String |
Deque-Benutzername |
| Passwort | String |
Deque-Passwort |
Optional param:
| Name | Typ | Beschreibung |
|---|---|---|
| serverConfig | String |
Definiert die Server-URL, zu der verbunden werden soll |
loginWithApiKey(param)
Erzeugt ein Authentifizierungstoken, um sich mit dem Dashboard zu verbinden. Diese API wird 2026 veraltet sein. Verwenden Sie stattdessen startScanSession .
Erforderlich param:
| Name | Typ | Beschreibung |
|---|---|---|
| apiKey | String |
Deque-API-Schlüssel |
Optional param:
| Name | Typ | Beschreibung |
|---|---|---|
| serverUrl | String |
Definiert die Server-URL, zu der verbunden werden soll |
setInstrumentation(param)
Ermöglicht es der Bibliothek, die Ansichtsstruktur der zu testenden Anwendung zu erhalten.
Erforderlich param:
| Name | Typ | Beschreibung |
|---|---|---|
| instrumentation | android.app.Instrumentation |
Instrumentierungsregistrierungsobjekt, das den Anwendungskontext und die Instrumentierung bereitstellt. |
isUserAuthenticated()
Gibt einen booleschen Wert zurück, um anzuzeigen, ob der Benutzer authentifiziert ist und bereit ist, Scans zu senden.
Gibt zurück:
| Typ | Beschreibung |
|---|---|
| Boolean | Gibt an, ob ein Benutzer für Axe DevTools Mobile authentifiziert ist |
disconnect()
Löscht die aktuelle Axe DevTools-Netzwerksitzung, um eine neue Verbindung zu ermöglichen.
Scannen
Sobald Sie die AxeDevTools Bibliothek importiert und initialisiert haben, sind Sie bereit zum Scannen.
scan()
Durchsucht die Informationen, die vom Instrumentierungsregister-Objekt übergeben wurden, nach Problemen und gibt ein setInstrumentation(param) zurück. ScanResultHandler.
Rückgabe:
| Name | Typ | Beschreibung |
|---|---|---|
| ScanResultHandler | Nullable | ScanResultHandler bietet eine Möglichkeit, detailliertere Informationen über das Ergebnis zu erhalten oder den Scan weiter zu aktualisieren, indem ein Name oder Tags bereitgestellt werden |
getResult(param)
Fordert das Ergebnis eines Scans an, indem der bereitgestellte Ergebnisschlüssel abgeglichen wird.
Erforderlich param:
| Name | Typ | Beschreibung |
|---|---|---|
| axeDevToolsResultKey | AxeDevToolsResultKey |
Der Bezeichner des Ergebnisses, das Sie abrufen möchten |
Rückgabe:
| Typ | Beschreibung |
|---|---|
| AxeDevToolsResult | Nullable AxeDevToolsResult bietet Zugang zu Details des Ergebnisses |
Umgang mit Ergebnissen
Verwenden Sie diese APIs mit dem ScanResultHandler -Objekt, das von einem Scan zurückgegeben wird.
uploadToDashboard()
Laden Sie das Ergebnis des Barrierefreiheitsscans hoch. Rückgabe:
| Typ | Beschreibung |
|---|---|
| AxeDevToolsResult | Nullable AxeDevToolsResult bietet Zugang zu Details des Ergebnisses |
saveResultToLocalStorage(param)
Speichern Sie das Ergebnis des Barrierefreiheitsscans in einer lokalen Datei auf Ihrem Testgerät.
Erforderlich param:
| Name | Typ | Beschreibung |
|---|---|---|
| prefixFilename | String |
Anfang des Dateinamens, unter dem das Ergebnis gespeichert wird. |
getSerializedResult()
Greifen Sie auf das Ergebnis Ihres Scans zu, um es innerhalb des Tests zu verwenden.
Anpassen Ihrer Konfiguration
Benennen und markieren Sie Ihre Scans, entscheiden Sie sich dafür, bestimmte Regeln zu ignorieren, oder erstellen Sie Ihre eigenen benutzerdefinierten Regeln.
setScanName(param)
Geben Sie dem Scan einen Namen, bevor Sie ihn hochladen.
Erforderlich param:
| Name | Typ | Beschreibung |
|---|---|---|
| name | String |
Name für den Scan |
addCustomRule(param)
Fügen Sie eine Regel hinzu, die während der Scans gegen Ihre Anwendung ausgeführt wird.
Erforderlich param:
| Name | Typ | Beschreibung |
|---|---|---|
| customRule | Class<AxeDevToolsRule> |
Regel zum Hinzufügen |
ignoreRules(param)
Ignoriert Regeln vollständig und verhindert deren Ausführung gegen jede Ansicht.
Erforderlich param:
| Name | Typ | Beschreibung |
|---|---|---|
| rulesToIgnore | List<String> |
Liste der zu ignorierenden Regeln |
ignoreByViewIdResourceName(params)
Erforderliche Parameter:
| Name | Typ | Beschreibung |
|---|---|---|
| viewIdResourceName | String |
Ressourcen-ID-Name für die Ansicht |
| ruleList | List<String> |
Liste der zu ignorierenden Regeln |
ignoreExperimental()
Meldet experimentelle Regeln ab. Ergebnisse für experimentelle Regel(n) werden den Status AxeStatus.IGNORED.
resetIgnoredRules()
Löscht die durch die ignorierten Regeln-APIs gesetzte Ignorierliste. Nützlich zur Änderung der Regelkonfiguration zwischen automatisierten Tests.
tagScanAs(param)
Kennzeichnet einen Scan, bevor er hochgeladen wird.
Erforderlich param:
| Name | Typ | Beschreibung |
|---|---|---|
| tags | Set<String> |
Liste von Tags, die dem Scan hinzugefügt werden sollen. |
tearDown()
Setzt Tags zurück und löscht den Testzustand von vorhergehenden Tests.
deleteResult(param)
Löschen Sie das Ergebnis eines Scans, das mit dem bereitgestellten Ergebnisschlüssel übereinstimmt. (Nur Mobile Dashboard)
Erforderlich param:
| Name | Typ | Beschreibung |
|---|---|---|
| axeDevToolsResultKey | AxeDevToolsResultKey |
Der Bezeichner des Ergebnisses, auf das Sie zugreifen möchten. |