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

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

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

自動テスト

ライブラリの初期化

テストクラスで、ライブラリに接続するには次のいずれかを使用します： init

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

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

private val axe = AxeDevTools()

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

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

private val axe = AxeDevTools()

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

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

オフラインの自動化はAndroid SDKで利用可能ですが、認証にオフラインライセンスキーが必要です。Dequeの代表者または サポートに連絡 してライセンスキーの配信を調整してください。その後、以下のスニペットを使用して axeDevTools ライブラリに接続します。「 FAQ 」を参照して、ネットワークリクエストを行わずに最適化されたパフォーマンスを実現するオフラインSDKについての詳細を確認してください。

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())
}

次は何をしますか？

プロジェクトを作成し、 AxeDevTools ライブラリをインポートしたので、 モバイルアプリをスキャンする準備が整いました。オプションとして、 設定をカスタマイズ して、スキャンに名前を付けたり、特定の結果を無視したり、カスタムルールを作成したり、スキャンにタグを付けたりするなど、APIを使用してスキャンを実行する前に行うことができます。