Join us in person and online for Firebase Summit on October 18, 2022. Learn how Firebase can help you accelerate app development, release your app with confidence, and scale with ease. Register now

Register additional iOS devices

Stay organized with collections Save and categorize content based on your preferences.

If you want to distribute ad hoc iOS builds using App Distribution, you must follow this guide to register your tester's devices. An ad hoc build is a build not signed with an Enterprise profile. A device can only install an ad hoc build if the device's unique device identifier (UDID) is included in the build's provisioning profile.

When a tester accepts an invitation to test your app, App Distribution requests permission to share the tester's device identifier with you, the developer. Before downloading an ad hoc build, App Distribution asks the tester to register their device. If the tester registers their device, App Distribution collects the UDID from the device and notifies you of the UDID by email.

When you receive an email containing a UDID, update your provisioning profile with the UDID and distribute a new build to your testers. You can manually export UDIDs using the Firebase console or Firebase CLI, or you can programmatically export UDIDs using fastlane.

Manually export UDIDs

  1. Add the devices to your Apple developer portal.
    • Option 1: Import the device UDIDs as a CSV file.

      In the Testers & Groups tab of the App Distribution dashboard, select All testers, then click Export Apple UDIDs to download a CSV file. Next, import the file into your Apple developer account using the Register Multiple Devices option. Refer to Apple's documentation to learn more.

      Note that your Apple developer account may only allow you to import a limited number of devices per year.

    • Option 2: Collect and enter the UDIDs by email.

      On the Add Devices page of the Apple developer portal, register the new UDID specified in the email you received.

  2. Add the registered devices to your provisioning profile.
  3. Download the provisioning profile and use it to rebuild your app. If you are rebuilding only to update the registered devices, don't update the build number or version.
  4. Re-distribute your app from the Firebase console or CLI. If you have already distributed a build with the same build number and version, only users of newly-registered devices receive notification emails.

Programmatically export UDIDs using fastlane

  1. Export all of your tester device UDIDs as a CSV file from fastlane. For example, create and run a new download_udids lane:

    lane :download_udids do
        firebase_app_distribution_get_udids(
            app: "<your Firebase app ID>",
            output_file: "<path to output file>",
        )
    end
    
  2. Import the UDID(s) into your Apple developer account using the Register Multiple Devices option. To learn more, see Apple's documentation. Note that your Apple developer account may only allow you to import a limited number of devices per year.

  3. Add the registered devices to your provisioning profile.

  4. Download the provisioning profile and use it to rebuild your app. If you are rebuilding only for the purposes of updating the registered devices, don't update the build number or version.

  5. Re-distribute your app. If you already distributed a build with the same build number and version, only users of newly-registered devices will receive notification emails.

Next steps