Migrieren Sie das Appium-Plugin zur Appium-Treiber-Integration

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

Anleitung zur Migration von Early Adopters zu den neuesten Änderungen von axe DevTools Mobile für Appium.

Not for use with personal data

Hinweis: Wenn Sie gerade erst mit axe DevTools Mobile für Appium beginnen, gehen Sie zum Setup-Handbuch.

Wir freuen uns, zwei neue Appium Treiber für eine branchenführende Appium Lösung zum Testen der Barrierefreiheit ankündigen zu können. Unsere Treiber basieren auf unseren bewährten SDKs und liefern Ihnen dieselben robusten und hochpräzisen Ergebnisse, die Sie mit allen unseren axe DevTools Mobile-Komponenten erhalten. Unsere Appium-Treiber decken alle verfügbaren mobilen Regeln von Deque ab und die Einrichtung dauert nur wenige Minuten.

Wenn Sie Version 2.0.0+ des axe DevTools Mobile Appium-Plugin implementiert haben, folgen Sie dieser Anleitung, um problemlos zur Treiberlösung zu wechseln.

Deinstallieren Sie das Plugin

appium plugin uninstall axeDevToolsMobile

Installieren Sie die Treiber

Installieren Sie die erforderlichen Treiber über die Befehlszeile auf Ihrer Appium-Instanz:

Axe XCUITest Driver für iOS-Tests

appium driver install --source=npm @axe-devtools/axe-appium-xcuitest-driver

Wenn Sie die Deinstallation zu irgendeinem Zeitpunkt durchführen müssen, können Sie dies über die Befehlszeile tun:

appium driver uninstall axexcuitest

Axe UIAutomator2-Treiber für Android-Tests

appium driver install --source=npm @axe-devtools/axe-appium-uiautomator2-driver

Wenn Sie die Deinstallation zu irgendeinem Zeitpunkt durchführen müssen, können Sie dies über die Befehlszeile tun:

appium driver uninstall axeuiautomator2

Starten Sie Zugänglichkeitstests über Appium

Starten Sie den Appium-Server wie gewohnt:

appium

Konfigurieren Sie Ihre Tests

Ein Großteil des Setup-Codes für das Appium-Plugin kann für die Appium-axe-Treiber wiederverwendet werden.

Aktualisierungen

  1. Neu bei der Treiberlösung ist die Aktualisierung Ihrer Funktionen für automationName entweder AxeXCUITest iOS-Tests oder AxeUiAutomator2 Android-Tests.

  2. Um Konflikte zu vermeiden, sollte der driver.execute Code wie folgt aktualisiert werden await driver.execute('mobile: axeScan', axeSettings), wobei das axeSettings-Objekt immer noch dasselbe Objekt ist, das die apiKey und andere Anpassungen enthält.

Ausführliche Beispiele

Axe UiAutomator2-Treiberbeispiel mit Python-Tests

Während das folgende Beispiel in Python geschrieben ist, ist die Logik auf andere Appium-Clientbibliotheken übertragbar.


from appium import webdriver
from appium.options.android import UiAutomator2Options
from appium.webdriver.appium_connection import AppiumConnection

class DemoWithAxeDevToolsMobile:

    def setup(self):
        success = True
        desired_caps = {}
        # Add your required capabilities for testing:
        desired_caps['platformName'] = 'Android'
        desired_caps['appActivity'] = "com.app.package.MainActivity"

        # Add axe DevTools Mobile required capabilities for testing:
        desired_caps['appPackage'] = "com.app.package"
        desired_caps['automationName'] = 'AxeUiAutomator2'

        # Initialize Appium Server Connection
        options = UiAutomator2Options().load_capabilities(desired_caps)
        self.driver = webdriver.Remote('http://localhost:4723', options=options)

    def runAccessibilityScan(self):
        settings = {}
        settings['apiKey'] = "<your-api-key-here>"
        return self.driver.execute_script('mobile: axeScan', settings)


demo = DemoWithAxeDevToolsMobile()
demo.setup()

# <Navigate To Screen>
demo.runAccessibilityScan()

# <Navigate To Another Screen>
demo.runAccessibilityScan()

axe XCUITest-Treiberbeispiel mit Python-Tests

Während das folgende Beispiel in Python geschrieben ist, ist die Logik auf andere Appium-Clientbibliotheken übertragbar.


from appium import webdriver
from appium.options.ios import XCUITestOptions
from appium.webdriver.appium_connection import AppiumConnection

class DemoWithAxeDevToolsMobile:

    def setup(self):
        success = True
        desired_caps = {}
        # Add your required capabilities for testing:
        desired_caps['platformName'] = 'iOS'

        # Add axe DevTools Mobile required capabilities for testing:
        desired_caps['bundleId'] = "com.bundle.identifier"
        desired_caps['automationName'] = 'AxeXCUITest'

        # Initialize Appium Server Connection
        options = XCUITestOptions().load_capabilities(desired_caps)
        self.driver = webdriver.Remote('http://localhost:4723', options=options)

    def runAccessibilityScan(self):
        settings = {}
        settings['apiKey'] = "<your-api-key-here>"
        return self.driver.execute_script('mobile: axeScan', settings)

demo = DemoWithAxeDevToolsMobile()
demo.setup()

# Navigate To Screen
demo.runAccessibilityScan()

# Navigate To Another Screen
demo.runAccessibilityScan()