Install the axe DevTools Mobile Analyzer

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
Not for use with personal data

Get the App from Deque’s Artifactory

  1. Login to Deque's Artifactory: agora.dequecloud.com.
    Note: When the page loads, do not search for a package. Return to this page and move on to the next step.
  2. Click this link to download the axe DevTools Mobile Analyzer App.
  3. The download will automatically start. The downloaded file will usually be saved to your Downloads folder. If you can’t find it, search your computer for a file that starts with axe-devtools-mobile-analyzer.

Install the App

  1. Double-click the downloaded PKG file to start the installer - this will open a new window.
  2. Follow the instructions to complete the installer.

Configure Xcode for Testing with Physical Devices

This is required for testing on physical devices only. If testing on a simulator, you can skip ahead to Launch the App and Sign In.

  1. Open Xcode.
  2. Open the WebDriverAgent.xcodeproj that was installed with the Mobile Analyzer App:
    1. From Xcode, choose File > Open.
    2. Navigate to the file below, where '{username}' is your user name: /Users/{username}/Library/Application Support/axe DevTools Mobile Analyzer/axe-appium-xcuitest-driver/build/assets/@axe-devtools/axe-appium-webdriveragent/WebDriverAgent.xcodeproj Note: If the Library folder is hidden, press Command + Shift + Period (.) to toggle the visibility of hidden files and folders.\
    3. Click to open the project in Xcode.
  3. Select 'WebDriverAgent' in the File Explorer in Xcode.

screenshot with pink arrow pointing to WebDriverAgent at the top of a menu
  1. Select 'Signing & Capabilities' from the project details.

screenshot with pink arrow pointing to Signing & Capabilities tab
  1. Select 'WebDriverAgentLib' from the Targets list.
    1. Check the box labeled 'Automatically manage signing.'
    2. Select your organization's Team from the Team drop down. (Do not select your Personal Team.)

screenshot with three pink arrows pointing to the WebDriverAgentLib target, checkbox to automatically manage signing, and a Team dropdown menu
  1. Select 'WebDriverAgentRunner' from the Targets list and repeat step 5.
  2. Close Xcode.

What's Next?

Having completed all of the initial setup, you are ready to start Testing iOS Apps for Accessibility!