Espresso/UIAutomatorを使ったターゲットテスト

テスト内でアクセシビリティスキャンが実行されるタイミングと場所を完全に制御したい場合は、ターゲットテストを実装する必要があります。UIテスト内でAxeDevToolsライブラリをセットアップしてアクセシビリティ問題をチェックするためのステップに従ってください。コード内の特定のポイントでaxe.scan()メソッドを明示的に呼び出します。

注意： これはあなたがすでにプロジェクトにライブラリを追加したことを前提としています。Gradleプラグインをインストールする手順については、クイックスタートを参照してください。

自動テスト

ライブラリの初期化

テストクラスinit内で、以下のいずれかの方法でライブラリに接続します。

テストセッションを開始する

axe.deque.comでAPIキーを生成してください。Axe Developer Hubに結果を投稿するには、startScanSessionをAPIキーとDeveloper HubからのプロジェクトIDを使用して行います。

private val axe = AxeDevTools()

init {
  ...
  axe.startScanSession(apiKey = "<DEQUE_APIKEY>",
            projectId = "<DEVHUB_PROJECT_ID>")
  ...
}

結果をローカルに保存するだけの場合は、プロジェクトIDを含める必要はありません。

private val axe = AxeDevTools()

init {
  ...
  axe.startScanSession(apiKey = "<DEQUE_APIKEY>")
  ...
}

オフラインライセンスキーで接続

オフラインオートメーションはAndroid SDKに利用可能ですが、認証目的でオフラインライセンスキーが必要です。ライセンスキーの配布調整のためにDequeの担当者またはサポートに連絡に連絡してください。その後、以下のスニペットを使用してaxeDevToolsライブラリに接続します。ネットワークリクエストなしで最適化されたパフォーマンスを提供するオフラインSDKの使用に関する詳細はFAQをご覧ください。

val axe = AxeDevTools()

init {
    axe.setOfflineLicenseKey("OFFLINE_LICENSE_KEY")
}

インストルメンテーションレジストリを設定

これはAxe DevTools for Androidがビュー階層に接続するために必要な部分です。テストを実行する前に@Before fun setup()ブロック内で設定できます。

private val axe = AxeDevTools()

@Before
fun setup()  {
  axe.setInstrumentation(InstrumentationRegistry.getInstrumentation())
}

次は何をしますか？

Now that you have created a project and imported the AxeDevTools library, you are all set to モバイルアプリをスキャン. Optionally, you can 設定をカスタマイズ before you scan, using our APIs to name your scans, ignore certain results, create custom rules, tag scans and more.