What are automated checks?
Automated checks are a feature in Accessibility Insights for Android that quickly checks UI elements for some common accessibility issues, such as low contrast, missing names, or inadequate touch target sizes. The rules are based on axe-android, an open source accessibility rules library developed by Deque Systems.
To ensure that an element is checked, it must be visible on the screen when you run automated checks. To thoroughly test an app, you'll need to navigate through all views, reveal hidden elements (such as menu items or combo box options), and scroll offscreen elements into view. Run automated checks each time new content becomes visible.
Running automated checks
- Connect to your device.
- Configure port forwarding.
- On your Android device:
- Launch your test app.
- Navigate to the first screen you want to test.
- On your computer:
Launch Accessibility Insights for Android.
A Connect to your Android device dialog will appear. The dialog includes:
- A help link
- A text field for entering your Android device port number
- A button for validating the port number
- The name of the connected device (if any) and the app that's currently onscreen
- Cancel and Start testing buttons
For Android device port number, enter "62442".
Select Validate port number.
When your device and app appear under Connected device, select Start testing.
Reviewing the automated check results
When the automated checks have completed, results are displayed in a new window. The default view shows:
- The total number of failed instances
- A list of any accessibility rules that were violated
- The number of failed instances for each rule
- A screenshot of the target app, with any failed instances highlighted
A rule can be expanded to show information about its failed instances. Rules can be expanded or collapsed:
- All at once by using Expand all / Collapse all
- Individually by clicking a rule, or by tabbing to it and pressing Enter
Expanding a rule:
- Highlights its failed instances in the screenshot
- Shows the failed instances in a list
Each failed instance includes:
- The class name of the element that failed
- How to fix the detected issue
- Additional information to help identify the element (some rules only)
Selecting a failed instance highlights it in the screenshot. You can select multiple instances. An instance can be selected or deselected by clicking it, or by tabbing to it and pressing Enter.
The Visual helper toggle allows you to quickly show or hide failure instance highlighting in the screenshot.
The Start over button allows you to quickly run the automated checks on whatever content is currently visible on your connected device.