Migrieren Sie das Appium-Plugin zur Appium-Treiber-Integration
Anleitung zur Migration von Early Adopters zu den neuesten Änderungen von axe DevTools Mobile für Appium.
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
-
Neu bei der Treiberlösung ist die Aktualisierung Ihrer Funktionen für
automationName
entwederAxeXCUITest
iOS-Tests oderAxeUiAutomator2
Android-Tests. -
Um Konflikte zu vermeiden, sollte der
driver.execute
Code wie folgt aktualisiert werdenawait driver.execute('mobile: axeScan', axeSettings)
, wobei das axeSettings-Objekt immer noch dasselbe Objekt ist, das dieapiKey
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()