Appiumを用いたターゲットテスト

Axe DevTools Mobile Appium ドライバーをインストールしました後、アクセシビリティの問題をチェックするためのテストを設定できます。

自動化テスト

Appiumサーバーを通常通り起動します:

appium

テストを設定する

Appium の自動化スクリプトから、テスト対象プラットフォーム用の Axe DevTools Mobile に必要な機能を追加します。

必要なAndroidの能力:

必要なiOSの能力:

ライブラリを初期化する

テストクラスinitializationで、次のいずれかを使用してドライバーに接続します。

Deque APIキーを使ったテストセッションの開始

axe.deque.comで Axe DevTools Mobile API キーを生成します。結果を Axe Developer Hub に投稿するには、プロジェクト ID も必要です。Execute Script API を呼び出して、API キーとプロジェクト ID をaxeStartSessionとともに渡し、テストセッションを開始します。

    beforeAll(async () => {
        ...
        const axeAuthSettings = {
            apiKey: "<DEQUE_APIKEY>",
            projectId: "<DEQUE_PROJECT_ID>"
        };
        await driver.execute('mobile: axeStartSession', axeAuthSettings);
        ...
    })

注: 結果をローカルに保存することはできますが、projectIdを省略すると非推奨警告が表示されます。この値をaxeStartSessionと一緒に含めることを強くお勧めします。

オフラインライセンスキーを使ったテストセッションの開始

Appium ドライバーにはオフラインオートメーションが利用可能ですが、認証目的のためにオフラインライセンスキーが必要です。Deque の担当者またはサポートに連絡してライセンスキーの配布調整をお願いします。その後、以下のスニペットを使用して Appium ドライバーに接続してください。ネットワーク要求を行わずにアクセシビリティスキャンを実行するためのオフライン Appium ドライバーの使用についての詳細はよくある質問をご覧ください。

    beforeAll(async () => {
        ...
        await driver.execute('mobile: axeStartSession', { licenseKey: "<DEQUE_OFFLINE_LICENSE_KEY>" });
        ...
    }

次はどうする？

Appium テストのセットアップが完了したので、モバイルアプリをスキャンする準備が整いました準備ができました。オプションとして、スキャンの前に設定をカスタマイズするすることができます。API を使用してスキャンに名前を付けたり、特定の結果を無視したり、スキャンにタグを付けたりすることができます。