On-device testing scanning flow

On this page:

• Add mobile applications to test
• Run mobile applications
• Apple Inc. Root
• Start a testing session
• Scan for accessibility issues
• View and manage your results

Add mobile applications to test

To add mobile applications to test:

Bundle ID and App ID 

You must have a mobile Digital asset in your Digital asset portfolio with a valid bundle ID (iOS) or app ID (Android). 

To confirm if you have the bundleID or app ID configured in your digital asset:

1. Navigate to the workspace level.
2. Under Workspace, select Digital assets. The Digital asset portfolio is displayed. 
3. Select the mobile digital asset you want to review.
4. Click the Edit button under App status from the Overview page.
5. Validate your Bundle ID or App ID.

Important! Please reach out to your Account Manager if you need to change the Bundle ID or App ID.

Run mobile applications

You can test mobile applications using Level Access Desktop by installing on a real device, running an application using Android Studio’s emulator functionality, or running an application using Xcode’s Simulator functionality.

Real device

Ensure that the application that you want to test is installed on the real device you want to use for testing.

Android Studio emulators and Xcode simulators

Please refer to their application guides on how to run a mobile application on their emulators and simulators.

Resigning for physical iOS devices

Resigning is required to run automated accessibility tests on physical iOS devices. Resigning is not needed for iOS simulators, Android devices and Android simulators. An Apple Account enrolled in the Apple Developer Program ($99 per year) is required for resigning.

Register device

To find your UDID:

1. Connect your iOS device to your Mac.
2. Open Finder and select your device from the sidebar.
3. Select the device model. The label will change to show your device's UDID.
4. Copy the UDID

Register with Apple

To register with Apple:

1. Log into the Apple Developer Portal.
2. Select Devices in the Certificates, IDs & Profiles section.
3. Click the + button to register a new Device.
4. Fill in the following details:
   • Platform: Select iOS, iPadOS, tvOS, watchOS, visionOS.
   • Device Name: Enter the device name, as used in the portal.
   • Device ID (UDID): Paste the UDID.
5. Select Continue.
6. Click Register.

Register identifier

To register an identifier:

1. Log into the Apple Developer Portal.
2. Select Identifiers in the Certificates, IDs & Profiles section.
3. Click the + button to register a new Identifier.
4. Select App IDs and click Continue.
5. Select App and click Continue.
6. Fill in the following details:
   • Description: A short description of your mobile application.
   • Bundle ID type: Explicit or wildcard.
   • Bundle ID value.
7. Click Continue.
8. Select Register.

Register certificate

To register a certificate:

1. Log into the Apple Developer Portal.
2. Select Certificates in the Certificates, IDs & Profiles section.
3. Click the + button to register a new Certificate.
4. Select iOS App Development under the Software section and click Continue.
5. Follow Apple’s steps for create a certificate signing request.
6. Select the downloaded file.
7. Click Continue.
8. Download as a .cer file.
9. Open Finder, and double click the .cer file to install it.

To use your certificate, you must have Apple's Root Certificates and Intermediate Certificates in your keychain.

This is automatically managed by Xcode. However, if you have never signed an iOS application before, you can download the Apple Inc. Root certificates.

Apple Inc. Root

You can download the the Apple Inc. Root certificates directly from their page:

• Apple Inc. Root

• Apple Root CA - G2 Root

• Apple Root CA - G3 Root

• Worldwide Developer Relations Certificate Authority (Expiring 02/20/2030)

• Worldwide Developer Relations - G4 (Expiring 12/10/2030)

• Developer ID - G2 (Expiring 09/17/2031)

To install each downloaded certificate, right click and open with Keychain Access.

Register Profile

1. Log into the Apple Developer Portal.
2. Click + button to register a new Provisioning Profile.
3. Select the iOS App Development option in the Development section.
4. Click Continue.
5. Select the mobile application that you created when registering the identifier in the App ID dropdown.
6. Click Continue.
7. Select the Certificates that you wish to include.
8. Click Continue.
9. Select the Devices that you wish to include.
10. Click Continue.
11. Enter a name for your Provisioning Profile.
12. Select Generate.
13. Download the Provisioning Profile. The downloaded file can be used to resign.

Perform Resign

To perform a resign:

1. Open Level Access Desktop.
2. Go to Settings in the sidebar.
3. Open the Resigning section.
4. Select the iOS tab.
5. Click the Provisioning Profile field.
6. Select the downloaded Provisioning Profile.
7. Select your Signing Identity.
8. Press the Resign button.

Start a testing session

To test your configuration:

1. Log into Level Access Desktop.
2. Configure the Android and iOS paths within the Desktop Settings.
3. Ensure that your real device is connected to your computer or that your emulator or simulator is open with the mobile application you wish to test installed.
4. Select the device that you want to test with from the available devices.
5. Select your Level Access workspace from the Workspace list.
6. Select your Digital asset.
7. Select your mobile application.
8. Click Run.

Scan for accessibility issues

Create a new scan

To create a new scan:

1. Click New Scan.
2. Enter a title in the Scan title field.
3. Click Create.
4. Select the scan card with the title of your scan.

Create a screen to scan

To create a screen to scan:

1. Select New Screen from Level Access Desktop.
2. Input a name in the Screen name field.
3. Select Create.

Scan screens

1. Use your simulator, emulator or real device to navigate to the screen you wish to scan.
2. Select Scan screen in the Screen card you want to test to activate scanning.
3. Once scanned, the Screen card will be updated with a small screenshot of the Screen and a Scan Completed label.

Complete steps 1 through 3 for as many screens as you need to test.

End Session

To end a session:

1. Click Save and End Session.
2. Confirm the status is Processing or Complete.
   1. If your scan is labelled Processing, select Refresh in the top menu
3. Once it's labeled as Complete, select your Scan card to see high level findings.

View and manage your results

1. Open the Scans tab to view completed scans in the Mobile Scans table.
   • The table includes a Scan Type column to distinguish scan methods.
2. Select View issue to view the:
   • Highlighted location of the issue on the app screen.
3. Go to the Testing results tab to view your results.

4. Select a Scan title to view your scan details.

   

5. Select a Scan title to view your scan results dashboard.

   

6. Go to Findings details to review:
   • What is the problem
   • Where is it located
   • Location by CSS selector
   • XML element
   • Guidance, including:
     • Why it matters
     • What to do
     • How to fix it