Appiumを用いたターゲットテスト
Appiumでaxe DevTools Mobileを用いてiOSとAndroidのアクセシビリティテストをセットアップする方法。
axe DevTools Mobile Appiumドライバーを インストールした後、テストを設定してアクセシビリティの問題をチェックできます。
自動化テスト
Appiumサーバーを通常通り起動します:
appiumテストを設定する
Appium自動化スクリプトから、テスト対象プラットフォームに必要なaxe DevTools Mobileの能力を追加します:
必要なAndroidの能力:
| 名前 | タイプ | 説明 |
|---|---|---|
| automationName | String |
アクセシビリティスキャンを実行するために、axe DevTools Mobileを組み込んだドライバーであるため、'AxeUiAutomator2'に設定します。 |
| appPackage | String |
テスト対象アプリのアプリケーションパッケージです。 appPackage はUiAutomator2ドライバーの一部です。既に設定している可能性があります。 |
必要なiOSの能力:
| 名前 | タイプ | 説明 |
|---|---|---|
| automationName | String |
アクセシビリティスキャンを実行するために、axe DevTools Mobileを組み込んだドライバーであるため、'AxeXCUITest'に設定します。 |
| bundleId | String |
テスト対象アプリのバンドル識別子です。 bundleId はXCUITestドライバーの一部です。既に設定している可能性があります。 |
ライブラリを初期化する
テストクラスで initialization、次のいずれかを使用してドライバーに接続します:
Deque APIキーを使ったテストセッションの開始
axe.deque.comでAxe DevTools Mobile APIキーを生成します。 axe.deque.com。結果を Axe Developer Hubに投稿するには、Project IDも必要です。 Execute Script APIを呼び出し、 axeStartSession APIキーとProject IDを渡してテストセッションを開始します。
beforeAll(async () => {
...
const axeAuthSettings = {
apiKey: "<DEQUE_APIKEY>",
projectId: "<DEQUE_PROJECT_ID>"
};
await driver.execute('mobile: axeStartSession', axeAuthSettings);
...
})結果をローカルにのみ保存したい場合は、Project IDを含める必要はありません。
beforeAll(async () => {
...
await driver.execute('mobile: axeStartSession', { apiKey: "<DEQUE_APIKEY>" });
...
})オフラインライセンスキーを使ったテストセッションの開始
オフライン自動化はAppiumドライバーで利用可能ですが、認証のためにオフラインライセンスキーが必要です。Dequeの担当者に連絡するか、 サポートに連絡 してライセンスキーの受け取りを調整してください。その後、以下のスニペットを使用してAppiumドライバーに接続してください。ネットワークリクエストなしでアクセシビリティスキャンを実行するオフラインAppiumドライバーの使用方法の詳細については、 よくある質問をご覧ください。
beforeAll(async () => {
...
await driver.execute('mobile: axeStartSession', { licenseKey: "<DEQUE_OFFLINE_LICENSE_KEY>" });
...
}次はどうする?
Appiumテストの設定が完了したら、 モバイルアプリをスキャンする準備が整いました。オプションとして、さらに 設定をカスタマイズする スキャンする前に、APIを使用してスキャンに名前を付けたり、特定の結果を無視したり、スキャンにタグを付けたりすることができます。
