Setup procedure for recording and test execution on a local device (iOS)

Local device setup guide

0. What you will need

When using an Ad-hoc build, the UDID of the physical device you plan to use must be registered in the build file in advance.

1. Install and configure Xcode (~1 hour)

Install Xcode and the iOS SDK

If Xcode is not installed, or is out of date, download the latest version from the App Store.

The iOS SDK must also be installed.
Open Xcode ▸ Settings ▸ Components to confirm that the SDK is present.

Sign in with your Apple ID

Next, sign in with your Apple ID in Xcode.
Open Xcode ▸ Settings ▸ Accounts.

If the Apple IDs list is empty, or you are signed in with a free account, add a paid Apple Developer account:

Click + in the lower-left corner and sign in with an Apple ID enrolled in the paid Apple Developer Program.

2. Enable Developer Mode on iPhone (~15 mins)

Developer Mode must be enabled to run automated tests on an iPhone.

On the iPhone, open Settings ▸ Privacy & Security, scroll to the bottom, and tap Developer Mode to enable it.

If Developer Mode does not appear:

• Connect the iPhone to the Mac via USB and launch Xcode.
• Open Window ▸ Devices and Simulators.
• Follow the on-screen instructions until the iPhone shows under Connected. This may take a few minutes.
• Quit and relaunch Settings on the iPhone.

After that, Developer Mode should appear under Privacy & Security.
Enabling Developer Mode requires the device to restart.

3. Install the Autify CLI (~15 mins)

Install the software needed to connect the device to Autify NoCode Mobile.

Install Homebrew

Autify CLI is installed via Homebrew.
If Homebrew is not installed, open Terminal and run the command shown under Install Homebrew on the Homebrew website.

Configure PATH

After installing Homebrew, add it to your PATH:
You should see a message similar to the following displayed in your terminal. Please execute the command that is written there (the content displayed will vary depending on your machine).

・For MacOS devices

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/$USER/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

・For Linux devices

echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"' >> ~/.bashrc
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"

Install the Autify CLI

Run the following command in Terminal:

brew install autifyhq/tap/autify-cli

If you encounter errors during installation, please contact Support.

When the command completes successfully, run the command below to verify that the Autify CLI was downloaded correctly:

autify help

If the installation succeeded, you will see the message “Autify Command Line Interface (CLI)” along with the version and available commands.

If you see the error command not found, your PATH variable may not be set.
Check the instructions under PATH Settings.

4. Generate a Personal Access Token in Autify NoCode Mobile (~5 mins)

In the NoCode Mobile user settings page, generate a Personal Access Token and store it in a safe place.

5. Prepare the device connection (~15 mins)

First, register the Personal Access Token you generated in the previous step with the Autify CLI.
In Terminal, run:

autify mobile auth login

Next, run the following command, which installs the components required to connect your mobile device to Autify NoCode Mobile and lets you enter the necessary information:

autify mobile link setup

Follow the on-screen prompts to complete setup.

• Enter the Workspace ID
  • You can obtain the Workspace ID as follows:
    • Go to http://mobile-app.autify.com/ and log in.
    • The URL changes to: https://mobile-app.autify.com/projects/XXXXXXX?by=test_plan
    • The XXXXXXX part is your Workspace ID.
• Consent to log upload
  • Enter Yes to allow log files related to recording and test runs to be sent to NoCode Mobile, which helps Support resolve issues more smoothly.
• Enter the Apple Developer Team ID
  • Enter the Team ID associated with the Apple ID you used to sign in earlier.
  • See Apple’s documentation for how to find your Team ID.
• Signing ID
  • Press Enter to accept the default.
• WebDriverAgent Bundle ID
  • Press Enter to accept the default.
  • (WebDriverAgent is an open-source automation tool by Facebook; nothing unrelated to test automation is installed.)

6. Start the connection

Run the following command in Terminal to connect your device to Autify NoCode Mobile:

autify mobile link start

After the command starts, log in to Autify NoCode Mobile on the account that created the access token and open the Create New Scenario screen.

If the connection is successful, select Local Device in the dropdown at the bottom of the modal; your device name will appear.

Using the local device

Prerequisites

Before recording or running tests on a local device, make sure the iPhone is connected via USB and unlocked.

If you intend to use the device for an extended period, open Settings ▸ Display & Brightness on the iPhone and set Auto-Lock to Never.

Recording

Follow the steps in Start the connection, select the displayed device, and start recording.

If you encounter errors during preparation, confirm with a developer that the build can be installed on the device. Contact Support if issues persist.

Test execution

As with cloud devices, you can run tests on a local device either by clicking Run now on the scenario details page or by running them from a test plan.

Troubleshooting

Please see this article.