オートスキャン

This page is not available in the language you requested. You have been redirected to the English version of the page.

Link to this page copied to clipboard

既存のUIテストがアプリと連携する際にアクセシビリティの問題を自動的に特定します

Not for use with personal data

概要

オートスキャンは、既存のEspressoやUIAutomatorテストがアプリと連動する際にアクセシビリティの問題を自動的に識別します。個別のスキャン呼び出しやテストの変更を行う必要はありません。オートスキャンは画面の変化を検知し、各ユニークな画面を自動的にスキャンします。

tip

テスト内でより細かい制御が必要な場合は、ターゲットテスト。

仕組み

私たちのGradleプラグインは、JUnitインストゥルメンテーションランナーをカスタムランナーに置き換えます。これにより、テストスイートを観察し、適切なタイミングで結果を処理することができます。 AxeDevToolsMobile Gradleプラグインを入手。テストが終了すると、オートスキャンは結果を処理し、各画面のJSON結果と自己完結型HTMLレポートを保存します。 AxeDevToolsMobileResults、オプションで結果をDeveloper Hubにアップロードします。

始めに

ユーザーの設定および認証のためにいくつかの値を設定する必要があります。キーを安全に保つために、これらをコンピュータおよびCI/CDパイプライン上の環境変数として追加することをお勧めします。

Groovy (build.gradle):
```
axeDevTools {
    axeMobileApiKey = ''
    axeAutoScanMode = true
    axeProjectId = ''
}
```
Kotlin DSL (build.gradle.kts):
```
axeDevTools {
    axeMobileApiKey = ""
    axeAutoScanMode = true
    axeProjectId = ""
}
```
ツールを使用してオフラインモードで結果を取得することを希望する場合は、 axeOfflineLicenseKey の代わりに値を設定します。 axeMobileApiKey と axeProjectId。

Groovy (build.gradle):
```
axeDevTools {
    axeOfflineLicenseKey = ''
    axeAutoScanMode = true
}
```
Kotlin DSL (build.gradle.kts):
```
axeDevTools {
    axeOfflineLicenseKey = ""
    axeAutoScanMode = true
}
```

結果の解釈

コンソール要約

テストスイートが終了すると、Gradleログ内でポストプロセスが見られ、その後要約が表示されます。

HTML rule report written to: /Users/user/Documents/workspace/android/project-name/app/build/reports/AxeDevToolsMobileResults/AxeDevToolsMobile_1773882427726.html
---- Axe DevTools Mobile Accessibility Summary ----
Scan 1:
  Screen: Home Page
  Issues: 6
  Issues by rule:
    - TouchSizeWcag: 3
    - LabelAtFront: 1
    - LabelInName: 1
    - FocusableText: 1
    
Scan 35:
  Screen: Wikipedia Alpha
  Issues: 5
  Issues by rule:
    - LabelAtFront: 1
    - LabelInName: 1
    - TouchTargetSpacing: 1
    - TouchSizeWcag: 1
    - ColorContrast: 1
    
Total Scans: 35
❌ Total Issues: 123
---------------------------------------------------

出力ファイル

オートスキャンはスクリーンショット、ビュー階層データ、詳細な問題情報を含む自己完結型HTMLレポートを生成します。各スキャンごとに個別のJSON結果が axe-test-data ディレクトリに保存されます。すべてのファイルは app/build/reports/AxeDevToolsMobileResults ディレクトリに保存されます。

ファイル	形式
`AxeDevToolsReport.html`	各画面の問題、要素の詳細、影響レベルを含むインタラクティブなHTMLレポート
`<timestamp>-axe-node-hierarchy.json`	各スキャンごとに1つの個別JSON結果

note

特定のディレクトリに結果を保存したい場合は、プラグイン設定ブロックでこれを指定できます。その中の build.gradle ファイル。

axeDevTools {
    axeMobileApiKey = "AXE_API_KEY"
    axeProjectId = "DEVHUB_PROJECT_ID"
    axeAutoScanMode = true
    axeHtmlReportPath = 
        "User/Desktop/reports/AxeDevToolsMobileResults"
    axeAccountUrl = "https://axe.deque.com"