On-device testing installation

Who can use this feature?

• Available for Enterprise as part of the full suite, and as an add-on for Accelerate and Essentials.

On this page:

• Download from Level Access Platform
• Terminal
• Third-party software
• Log into Level Access Desktop
• Set up Android and iOS paths

Download from Level Access Platform

Level Access Desktop can only be installed on macOS. Other operating systems are not supported.

Requirements

• The minimum supported macOS version is 14.0.
• Up to 50 GB of free disk space is needed for Xcode and Android Studio.
• An Apple Developer Membership ($99 per year) is required for resigning for testing on physical iOS devices.

Installation steps

1. Download the Level Access Desktop Installer from the Tools & Extensions page in the Level Access Platform.
2. Open the LevelAccessDesktop.dmg file, a new Finder window will appear.
3. Drag the Level Access Desktop app to the Applications folder.

Launch the application

1. Open a new Finder window.
2. Go to the Applications folder.
3. Select Level Access Desktop.

Generate an API Key

To generate an API key to be able to log into Level Access Desktop:

1. Navigate to the organizational level.
2. Under Manage, select Tools and integrations, and then API.
3. Click on Add API token to generate an unique API token and save it in a secure location.

Terminal

Terminal is a macOS application that allows you to interact with the operating system through text-based commands. The Terminal can be opened in multiple ways.

Open with Spotlight

To open the terminal with Spotlight:

1. Press the Command ⌘ + Space keys simultaneously.
2. Search for Terminal.
3. Press Enter/Return.

Open with Finder

To open the terminal through Finder:

1. Open the Finder application.
2. Navigate to the Applications folder.
3. Click the Utilities folder.
4. Find the Terminal and double-click it.

Third-party software

Level Access Desktop requires some software to communicate with Android and iOS devices.

Android Studio

Android Studio is an integrated development environment (IDE) developed by Google for building Android apps.

Android Studio installation and setup

To setup Android Studio:

1. Download Android Studio from the Android Developer website.
2. Open the downloaded android-studio.dmg file.
3. From the pop-up window, drag Android Studio to your Applications folder.
4. Open Android Studio from your Applications folder and follow the setup guide.

Android SDK location

To locate the Android SDK:

1. Press the Settings icon in the bottom-left corner from the Welcome window.
2. Search for SDK.
3. Open the the Android SDK section.
4. Copy the location listed in the Android SDK Location field.

The copied location points to the Android SDK, for example: /Users/<User>/Library/Android/sdk. For all remaining steps, please replace <user> with your macOS username.

ADB location

ADB is located in the subfolder /platform-tools/adb of Android SDK.

Paste the Android SDK location, and append the subfolder. Example:

/Users/<User>/Library/Android/sdk/platform-tools/adb

To validate if the adb path, run the following command in the Terminal:

/Users/<User>/Library/Android/sdk/platform-tools/adb --version

The output should be similar to:

Android Debug Bridge version 1.0.41
Version 35.0.2-12147458
Installed as /Users/<User>/Library/Android/sdk/platform-tools/adb
Running on Darwin 24.3.0 (arm64)

Update PATH

Add the adb path to your global PATH, using the following command:

export PATH=$PATH:/Users/<User>/Library/Android/sdk/platform-tools/adb

Next, refresh your paths by running:

source ~/.zshrc

Xcode

Xcode is an integrated development environment (IDE) developed by Apple for building software applications for macOS, iOS, watchOS, and tvOS.

Xcode installation and setup

To setup Xcode:

1. Download Xcode from the Mac App Store.
2. Open Xcode and accept the agreement.
3. Install the macOS and iOS components.
4. Complete the next steps to finish the setup.

Log into Level Access Desktop

To log into Level Access Desktop:

1. Input your organization’s tenant URL in the Organizational URL field
   • Example: organization.hub.essentia11y.com
2. Input the API Key that you generated on the Level Access Platform
   • Please refer to the instructions on how to Generate API Key.

Set up Android and iOS paths

Android

The Android paths have to be set to communicate with Android devices.

1. Open Level Access Desktop.
2. Press the Level Access Desktop Settings button in the sidebar.
3. Open the Paths section.
4. Select the Android tab.
5. Fill in the required fields: adb
   • example: /Users/<User>/Library/Android/sdk/platform-tools/adb.
   • Refer to the instructions on how to find ADB location.
   • Save your adb location for ease of use with Level Access Desktop.
6. Press the Save button.
7. Press the Validate button.

iOS

The iOS paths have to be set to communicate with iOS devices.

1. Open Level Access Desktop.
2. Press the Level Access Desktop Settings button in the sidebar.
3. Open the Paths section.
4. Select the iOS tab.

If the required fields are not filled, use the following steps to fill in the required fields:

1. xcrun

   1. Open the Terminal and run:

      which xcrun

      Example of valid path:

      /usr/bin/xcrun

2. devicectl

   1. Open the Terminal and run:

      xcrun --find devicectl

      Example of valid path:

      /Applications/Xcode.app/Contents/Developer/usr/bin/devicectl

3. simctl

   1. Open the Terminal and run:

      xcrun --find simctl

      Example of valid path:

      /Applications/Xcode.app/Contents/Developer/usr/bin/simctl

4. xcodebuild

   1. Open the Terminal and run:

      xcrun --find xcodebuild

      Example of valid path:

      /Applications/Xcode.app/Contents/Developer/usr/bin/xcodebuild

5. codesign

   1. Open the Terminal and run:

      which codesign

      Example of valid path:

      /usr/bin/codesign

6. security

   1. Open the Terminal and run:

      which security

   2. Example of valid path:

      /usr/bin/security

   3. Press the Validate button.