Install the Axe Accessibility Analyzer
Download the App
The Axe Accessibility Analyzer is available in the Google Play Store. Download the Axe Accessibility Analyzer to a physical device or an emulator. Alternately, scan the QR Code below with your device's camera:
Note: If you are testing on multiple emulators, you will need to download the Analyzer app on each one.
First-Time Setup
Follow the steps below to begin scanning your Android apps for accessibility. If you've done this before, skip ahead to Testing your Android Apps for Accessibility.
Open the Accessibility Analyzer on your device or emulator, and follow the prompts to get the proper permissions in place:
-
Choose your server configuration before signing in. Your organization administrator can provide this information.
- For standard SaaS, choose 'Standard Server.'
- For On Prem or Private Cloud choose 'Custom Server,' and enter the backend URL provided by your organization’s administrator.
-
Choose a sign-in method and select 'Sign In.' A browser window will open.
-
Enter your Deque account credentials to sign in.
-
You will be introduced to Projects. If this is your first mobile project, it will be named automatically.
noteIf you have existing mobile projects in Axe Developer Hub, you are able to select which project you would like to use for results when you start your scanning session. Select the hyperlinked project name on the 'Time to scan' screen to access the project selection screen, and choose where to send results for the current scan session. You can also navigate to Axe Developer Hub to Create a new project for your results.
Note: As a best practice, you should have results from automated test runs and mobile scan sessions in separate projects.
-
Setup draw overlay:
- Select 'Open settings' to enable draw overlay - this allows the Axe DevTools floating action button to be available on the screen no matter what application you have open.
- Select Axe and toggle on.
- Use the back arrow to return to the app.
-
Allow access to accessibility settings:
- On the following screen, select 'Open settings' to return to the device settings.
- Toggle 'Allow modifying system settings' - this unlocks the main functionality of the Analyzer app and allows Axe DevTools access to the accessibility service information within Android.
- Use the back arrow to return to the app.
-
Allow screen recording and casting permission.
Create a New Project in Developer Hub
If you want to create a new project for results rather than saving to an existing one, go to Axe Developer Hub. Select the button to add a new project, and select 'Mobile analyzer' as the integration method. You will see confirmation that your project was created on the next screen. When you return to the Analyzer app, find your new project on the project selection screen.
We recommend keeping results from automated testing and results from the mobile analyzers in separate projects to more accurately track the accessibility health of your apps. If you have been using Axe Developer Hub for results from automated testing with our SDKs and Appium drivers, you may see these as options on the project selection screen. If you don't have an existing project for Analyzer results, you should create a new project.
Stay Up To Date
Be sure you're running the latest version of the app to get the best results. We recommend enabling automatic updates so you're always up to date.
What's Next?
With a project created and proper permissions in place, you can start Testing your Android Apps for Accessibility.
