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 for the following roles:

  • Organization Administrator

  • Workspace admin

  • Workspace user

  • Website/Apps user

On this page:

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

Download from Level Access Platform

Level Access Desktop can be installed on macOS and Windows. 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

MacOS

1. Download the Level Access Desktop Installer from the Tools and integrations page.
2. Open the LevelAccessDesktop.dmg file.
3. A new Finder window will appear.
4. Drag the Level Access Desktop app to the Applications folder.

Windows

1. Download the Level Access Desktop Installer from the Tools and integrations page.
2. Open the LevelAccessDesktop.exe file.
3. Following directions on the screen until the installation finishes.

Launch the application

MacOS

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

Windows

1. Click Start on your Windows toolbar
2. Type Level Access Desktop.
3. Click the Level Access Desktop app icon in the search results.

Generate an API Key

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

1. Go 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.

Third-party software

Level Access Desktop requires third-party software to communicate with Android and iOS devices.

Third-party software on MacOS

Android Studio on MacOS

Android Studio is an integrated development environment (IDE) developed by Google for building Android apps. Android Studio includes several command-line tools, which are used by Level Access Desktop to communicate with Android devices. Level Access Desktop requires Android Studio 2023 or newer.

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.

The Standard setup works with Level Access Desktop. Complete the next steps to finish the setup.

Android SDK location

To locate the Android SDK:

1. Once you're done with the setup, a Welcome window should open.

2. Click the Settings icon in the bottom-left corner from the Welcome window.
3. Search for SDK.
4. Open the the Android SDK section.
5. 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

Terminal

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

Open with Spotlight

1. Press the Command ⌘ + Space keys simultaneously.
2. Search for Terminal.
3. Open it by pressing the Return ⏎ key.

Open with Finder

1. Open the Finder application.
2. Go to the Applications folder.
3. Open the Utitilities folder.
4. Find the Terminal.
5. Double click to open.

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.

Third-party software on Windows

Android Studio is an integrated development environment (IDE) developed by Google for building Android apps. Android Studio includes several command-line tools, which are used by Level Access Desktop to communicate with Android devices. Level Access Desktop requires Android Studio 2023 or newer.

1. Please download Android Studio from the Android Developer website.

2. Run the downloaded android-studio.exe installer.

3. Follow the installation wizard.

4. Select the Standard installation option.

5. Complete the setup process and allow Android Studio to download any required SDK components.

1. Open Android Studio.

2. From the Welcome screen, select More Actions → SDK Manager.

   1. If a project is already open, select File → Settings → Android SDK.

3. Locate the Android SDK Location field.

4. Copy the SDK path. Example:

C:\Users\<User>\AppData\Local\Android\Sdk

5. Replace <user> with your Windows username in all remaining examples.

ADB is located inside the platform-tools folder of the Android SDK.

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

   C:\Users\<User>\AppData\Local\Android\Sdk\platform-tools\adb.exe

2. To validate if the adb path is valid, open Command Prompt or PowerShell and run:

   "C:\Users\<User>\AppData\Local\Android\Sdk\platform-tools\adb.exe" --version

3. It should return output similar to:

Android Debug Bridge version 1.0.41 
Version 35.0.2-12147458 
Installed as C:\Users\<User>\AppData\Local\Android\Sdk\platform-tools\adb.exe 
Running on Windows

1. Open the Start menu.

2. Search for Environment Variables.

3. Select Edit the system environment variables.

4. Select Environment Variables.

5. Under User variables, select Path and then Edit.

6. Select New.

7. Add:

C:\Users\<User>\AppData\Local\Android\Sdk\platform-tools

8. Select OK to save all changes

9. Close and reopen any Command Prompt or PowerShell windows

1. Run:

adb --version

2. If configured correctly, the adb version information should be displayed.

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. Click Save.
7. Select Validate.

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.