Gezieltes Testen mit Appium

This page is not available in the language you requested. You have been redirected to the English version of the page.

Link to this page copied to clipboard

Bereiten Sie sich mit Axe DevTools Mobile in Appium für Barrierefreiheitstests auf iOS und Android vor.

Not for use with personal data

Nachdem Sie die Axe DevTools Mobile Appium-Treiber installiert haben, können Sie Ihre Tests so konfigurieren, dass sie auf Barrierefreiheitsprobleme prüfen.

Automatisiertes Testen

Starten Sie den Appium-Server wie gewohnt:

appium

Konfigurieren Sie Ihre Tests

Fügen Sie von Ihren Appium-Automatisierungsskripten die erforderlichen Fähigkeiten für Axe DevTools Mobile für die getestete Plattform hinzu:

Erforderliche Android-Fähigkeit:

Name	Typ	Beschreibung
automationName	`String`	Auf 'AxeUiAutomator2' setzen, um den Treiber mit dem eingebetteten Axe DevTools Mobile zu nutzen und Barrierefreiheitsscans durchzuführen.
appPackage	`String`	Das Anwendungs-Paket der zu testenden App. Beachten Sie, dass `appPackage` ein Teil des UiAutomator2-Treibers ist; möglicherweise haben Sie es bereits eingestellt.

Erforderliche iOS-Fähigkeit:

Name	Typ	Beschreibung
automationName	`String`	Auf 'AxeXCUITest' setzen, um den Treiber mit dem eingebetteten Axe DevTools Mobile zu nutzen und Barrierefreiheitsscans durchzuführen.
bundleId	`String`	Der Bundle-Identifier der zu testenden App. Beachten Sie, dass `bundleId` ein Teil des XCUITest-Treibers ist; möglicherweise haben Sie es bereits eingestellt.

Die Bibliothek initialisieren

In der Testklasse initialization verbinden Sie sich mit dem Treiber mithilfe eines Deque-API-Schlüssels oder eines Deque-Offline-Lizenzschlüssels.

Starten Sie eine Testsitzung mit einem Deque-API-Schlüssel

Erzeugen Sie einen Axe DevTools Mobile API-Schlüssel unter axe.deque.com. Um Ergebnisse an Axe Developer Hub zu senden, benötigen Sie außerdem eine Projekt-ID. Rufen Sie die Execute Script API auf und übergeben Sie axeStartSession zusammen mit dem API-Schlüssel und der Projekt-ID, um die Testsitzung zu starten.

    beforeAll(async () => {
        ...
        const axeSettings = {
            apiKey: "<DEQUE_APIKEY>",
            projectId: "<DEQUE_PROJECT_ID>"
        };
        await driver.execute('mobile: axeStartSession', axeSettings);
        ...
    })

Hinweis: Während Sie in der Lage sein werden, Ergebnisse weiterhin lokal zu speichern, wird das Weglassen von projectId eine Veraltungswarnung auslösen. Wir empfehlen dringend, diesen Wert mit axeStartSession einzuschließen.

Wenn Sie beabsichtigen, die Ergebnisse nur lokal zu speichern, setzen Sie axeUploadResults auf false. Bei axeUploadResults: false müssen Sie keinen projectId angeben.

    beforeAll(async () => {
        ...
        const axeSettings = {
            apiKey: "<DEQUE_APIKEY>",
            axeUploadResults: false
        };
        await driver.execute('mobile: axeStartSession', axeSettings);
        ...
    })

Starten Sie eine Testsitzung mit einem Offline-Lizenzschlüssel

Offline-Automatisierung ist für die Appium-Treiber verfügbar, erfordert jedoch einen Offline-Lizenzschlüssel für Authentifizierungszwecke. Bitte wenden Sie sich an Ihren Deque-Vertreter oder den Support, um die Bereitstellung Ihres Lizenzschlüssels zu koordinieren. Verwenden Sie dann den folgenden Codeausschnitt, um sich mit dem Appium-Treiber zu verbinden. Erfahren Sie mehr darüber, wie Sie unsere Offline-Appium-Treiber verwenden können, um Barrierefreiheitsscans ohne Netzwerk-Anfragen durchzuführen, in Häufig gestellten Fragen.

    beforeAll(async () => {
        ...
        await driver.execute('mobile: axeStartSession', { licenseKey: "<DEQUE_OFFLINE_LICENSE_KEY>" });
        ...
    }

Was kommt als Nächstes?

Da Ihre Appium-Tests nun eingerichtet sind, sind Sie bereit, um scannen. Optional können Sie anpassen, bevor Sie scannen, um unsere APIs zu verwenden, um Ihre Scans zu benennen, bestimmte Ergebnisse zu ignorieren, Scans zu taggen und mehr.