Appium-Plugin auf Appium-Treiber-Lösung migrieren

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 auf die 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 zur Einrichtungsanleitung.

Wir freuen uns, zwei neue Appium-Treiber für eine branchenführende Appium-Accessibility-Testlösung ankündigen zu können. Unsere Treiber werden von unseren erprobten SDKs unterstützt, die Ihnen die gleichen robusten und hochgenauen Ergebnisse bieten, die Sie von all 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-Plugins implementiert haben, folgen Sie dieser Anleitung, um einfach zur Treiberlösung zu wechseln.

Das Plugin deinstallieren

appium plugin uninstall axeDevToolsMobile

Die Treiber installieren

Installieren Sie die benötigten Treiber über die Kommandozeile in Ihrer Appium-Instanz:

Axe XCUITest-Treiber für iOS-Tests

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

Falls Sie die Deinstallation zu einem späteren Zeitpunkt vornehmen müssen, können Sie dies über die Kommandozeile tun:

appium driver uninstall axexcuitest

Axe UIAutomator2-Treiber für Android-Tests

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

Falls Sie die Deinstallation zu einem späteren Zeitpunkt vornehmen müssen, können Sie dies über die Kommandozeile tun:

appium driver uninstall axeuiautomator2

Accessibility-Tests mit Appium starten

Starten Sie den Appium-Server wie gewohnt:

appium

Ihre Tests konfigurieren

Ein Großteil des Einrichtungscodes für das Appium-Plugin kann für die Appium-Axe-Treiber wiederverwendet werden.

Updates

  1. Neu bei der Treiberlösung ist, dass Sie Ihre Fähigkeit für automationName entweder auf AxeXCUITest für iOS-Tests oder AxeUiAutomator2 für Android-Tests aktualisieren.

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

Vollständige Beispiele

Axe UIAutomator2-Treiber-Beispiel mit Python-Tests

Obwohl das folgende Beispiel in Python geschrieben ist, kann die Logik auf andere Appium-Client-Bibliotheken übertragen werden.


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-Treiber-Beispiel mit Python-Tests

Obwohl das folgende Beispiel in Python geschrieben ist, kann die Logik auf andere Appium-Client-Bibliotheken übertragen werden.


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()