Step 1: Install and run the agent on your iOS device

First the iOS device that is going to be used to create and replay test cases needs to be registered to the Jamo Cloud. For doing so, install the agent and run the agent.

Install the agent on iOS

The e-mail that you got when activating your account contains the URL to download the agent for iOS. Open safari on the iOS device and type in the link. An html page with only one link is displayed. Click on the link. A dialog box opens in which you have to specify the UDID of the device.

ios step 1 image 1

To retrieve the UDID of the device, open a new tab in safari and enter the URL: Start the process and accept the download of the provisioning profile. The web site will display your UDID in a tab of safari. Copy this UDID and go back to the tab for the installation of the agent. Fill in the UDID in the dialog box and touch the ‘OK’ button. Wait for a few seconds. Now the device will ask confirmation to download the agent. Confirm by touching the ‘Install’ button and the agent will be installed on the device.

If the website is not returning your UDID because of specific settings on your device, then you can retrieve the UDID by connecting your phone to a MacOS machine. The XCode environment of Apple will list your device in its ‘Devices’ window. Select your device and retrieve the UDID.

Once the number if filled in, Safari will download the agent. You will have to confirm the download by touching the ‘Install’ button in the dialog box that opens.

ios step1 image 2

After the agent is installed, you can find it back by looking for the app named ‘JamoAutomator’ or by looking up following icon


Run now the agent. The agent has just one purpose: connect the device or simulator to the Jamo Cloud. In order to make this connection, you have to login. Use your account, your login name and our new password to login. Do no use the password that has been sent by the automatic e-mail. As explained, after getting the e-mail, login to the product in your browser. The tool will ask you to change the password. Only after you have specified your password, continue the login through the agent.

Now that the agent is installed and running with your credentials, your iOS device is displayed in the list of devices. If not yet logged in trough a browser, open a browser and log in to the tool. Click on the ‘Devices’ tab. You get the list of known devices.

If your device is not listed, press the ‘Refresh’ button located in the upper right corner of the form.

ios step 1 image 3

In the above example, an iPhone has been added to the list of known devices. The device is characterized by its type, name, manufacture, model, mobile OS and OS version. The name of the device is the name that you specified on your device. The tool also characterize the device by its orientation: portrait or landscape and the language that is used on the device. If the agent is running and logged in, then the device is an active device. A device needs to be active in order to install automatically the app under test or to execute a test case from the cloud or a Continuous Integration system.

The next step is now to install the app that need to be tested.