AppiumプラグインからAppiumドライバーソリューションへの移行
Axe DevTools Mobile for Appiumの最新の変更点に初期ユーザーを移行するためのガイド。
注意: Axe DevTools Mobile for Appiumを始めたばかりの方は、セットアップガイドをご覧ください。
私たちは業界をリードするAppiumアクセシビリティテストソリューションのために、2つの新しいAppiumドライバーを発表できることを嬉しく思います。私たちのドライバーは実績のあるSDKによって駆動されており、すべてのAxe DevTools Mobileコンポーネントと同様に、堅固で高精度な結果を提供します。私たちのAppiumドライバーはDequeの利用可能なモバイルルールをすべてカバーしており、セットアップには数分しかかかりません。
Axe DevTools Mobile Appiumプラグインのバージョン2.0.0+を導入した場合は、このガイドに従って簡単にドライバーソリューションに切り替えましょう。
プラグインをアンインストールする
appium plugin uninstall axeDevToolsMobileドライバーをインストールする
必要なドライバーをコマンドラインを通してAppiumインスタンスにインストールします:
iOSテスト用Axe XCUITestドライバー
appium driver install --source=npm @axe-devtools/axe-appium-xcuitest-driverいつでもアンインストールが必要な場合は、コマンドラインを通してアンインストールできます:
appium driver uninstall axexcuitestAndroidテスト用Axe UIAutomator2ドライバー
appium driver install --source=npm @axe-devtools/axe-appium-uiautomator2-driverいつでもアンインストールが必要な場合は、コマンドラインを通してアンインストールできます:
appium driver uninstall axeuiautomator2Appiumを通してアクセシビリティテストを始める
通常通りにAppiumサーバーを開始します:
appiumテストを構成する
Appiumプラグインのセットアップコードの多くは、Appium Axeドライバー用に再利用できます。
更新
-
ドライバーソリューションでは、新たに
automationNameをiOSテスト用のAxeXCUITestまたはAndroidテスト用のAxeUiAutomator2に更新することが必要です。 -
競合を避けるために、
driver.executeコードをawait driver.execute('mobile: axeScan', axeSettings)に更新すべきであり、axeSettingsオブジェクトはapiKeyやその他のカスタマイズを含む同じオブジェクトのままです。
完全な例
Pythonテストを用いたAxe UiAutomator2ドライバーの例
以下の例はPythonで書かれていますが、他のAppiumクライアントライブラリにもロジックを転用できます。
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()Pythonテストを用いたAxe XCUITestドライバーの例
以下の例はPythonで書かれていますが、他のAppiumクライアントライブラリにもロジックを転用できます。
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()