オートスキャン

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プラグインを入手。テストが終了すると、Auto Scanが結果を処理し、各画面のJSON結果とAxeDevToolsMobileResultsに自給自足型のHTMLレポートを保存し、オプションで結果を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
---------------------------------------------------

出力ファイル

Auto Scanは、スクリーンショット、ビュー階層データ、および詳細な問題情報を含む自給自足型の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"