Register additional iOS devices

When testers sign up to test your release on iOS, you can export your testers' device names and identifiers in a CSV file and update them all at once to your app's provisioning profile. You can manually export UDIDs using the Firebase console or Firebase CLI, or you can programmatically export UDIDs using fastlane.

Manually export UDIDs

When testers accept an invitation to test a build that is not signed with an Enterprise profile, they are asked for permission to share their device's identifier with you. If the tester agrees to share the device's identifier path, App Distribution collects the UDID from the device and notifies you of the UDID by email.

When you receive one of these emails, update your provisioning profile with the UDID and distribute a new build to your testers by following these steps either in the Firebase console or Firebase CLI:

  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.

Programatically export UDIDs progammatically using fastlane

When testers accept an invitation to test an ad hoc build, they are asked for permission to share the device's identifier with you. An ad hoc build is a build not signed with an Enterprise profile. If the tester agrees to share their device's identifier path, App Distribution collects the UDID from the device and notifies you of the UDID by email.

When you receive one of these emails, update your provisioning profile with the UDID and distribute a new build to your testers by following these steps:

  1. Gather the UDIDs to add.

    • Option 1: Copy the UDID from the email.

    • Option 2: Export all of your tester device UDIDs as a CSV file from the Firebase console. In the Testers & Groups tab of the App Distribution dashboard, select All testers, then click Export Apple UDIDs to download a CSV file.

    • Option 3: 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. If you exported a CSV, use 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 to update 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 receive notification emails.

Next steps