Skip to main content

Registering a test device

Abstract

You can register a test device easily by opening Safari on your iOS device and accessing the Test devices page from your Profile. With other browsers, you can manually register one using the Register device manually button.

You have multiple options to register test devices on bitrise.io:

  • Open Safari on your iOS device and access the Test devices tab from your Profile settings page.

  • Manually register a device from the Test devices tab from your Profile settings page.

After registering your device on Bitrise, make sure to register it on the Apple Developer Portal as well. Alternatively, you can set the Xcode Archive & Export for iOS Step's Register test devices on the Apple Developer Portal input to true under the Automatic code signing category to register all available test devices of the app.

Apple Developer Portal device limit

There is a limit on registrable devices on the Apple Developer Portal, so make sure to check the list of available test devices of an app before you use the Xcode Archive & Export for iOS Step's Register test devices on the Apple Developer Portal input to register devices!

Register an iOS device using Safari

The most comfortable way to register your iOS test device on bitrise.io is to open bitrise.io with Safari. This way we can open your device’s Settings and create a temporary profile to get your Unique Device Identifier (UDID). This way you don’t have to look for it and manually copy/paste it.

Clear the cache

When trying to install an app from the public install page, you should clear the cache: click the link appearing in the If you synced your settings from your old device, you need to clear the cache and register your new device line. The link redirects to the Profile settings page where you can follow the procedure described below.

Read more about installing an app from the public install page in our Deploying an iOS app to Bitrise.io guide.

  1. Open Safari in non-incognito mode on your iOS device and log into bitrise.io.

  2. Go to your Profile.

  3. Tap Account Settings.

  4. Tap Test devices on the left.

  5. Tap Register this device.

  6. In the pop-up window, Tap Allow so that bitrise.io can show your configuration profile.

  7. Tap Install when the Install Profile dialog appears.

  8. Enter your devices’s passcode.

  9. Tap Install on the Install Profile again. Now you can see your UDID and your iOS device name in the Register device dialog.

  10. Tap Register device.

  11. Register this test device to the Apple Developer Portal with the correct provisioning profile added to your device or use our Auto Provisioning step with enabling profile generation.

If you go back to Test devices, you can see the registered device:

test_devices.png

You can delete the registered device any time if you click on the Remove button.

Register a test device manually

  1. On bitrise.io, open the account selector menu on the top right and select Profile settings.

    profile-settings-menu.png
  2. On the menu on the left side, select Test devices.

    test-devices-menu.png
  3. Click on Register device manually.

    register-device-button.png
  4. In the Register device dialog, fill out the Title field and the Identifier field with your device’s UDID.

  5. Click Register Devices.

    You can get your UDID if you plug your device into a computer, and open iTunes. Under Summary, you should see a Serial Number. If you click on it, it will reveal your device’s UDID which you can paste into the Identifier field on our Test Devices.

  6. Register this test device to the Apple Developer Portal with the correct provisioning profile added to your device or use our Auto Provisioning Step with enabling profile generation.

Now you can see your registered test device under the Registered test devices section.

You can remove this registered device any time if you click the orange x icon.

Checking the available test devices for an app

For any Bitrise app, you can check out the registered test devices available on the App Settings page. This will show an aggregated list of all registered test devices associated with users who have access to your app, regardless of their role. You can use any of those devices to run tests of your app.

You can also download the list of registered devices as a .json file.

Admin access only

Only users with the role of admin on the app's team can access all functions of the App Settings page of an app.

  1. Open your app on Bitrise.

  2. On the main page of the app, click on the App Settings icon: settings.svg.

    app-settings.png
  3. On the menu on the left side, select Test devices.

    test-devices-menu.png
  4. Optionally, you can download the entire list as a .json file: click the Download as json button.