Skip to main content

Register New iOS Devices (for iOS Ad-Hoc Distribution)

add-devices Command


When you or your app’s testers add new iOS devices to DeployGate, DeployGate sends a notification requesting that you add new UDIDs to the Provisioning Profile.

Run dg add-devices on Terminal in order to add devices.

dg add-devices

When run, it will automatically obtain a list of UDIDs awaiting registration, register these with Apple Developer, update the Provisioning Profile, rebuild the project, and upload the new app to DeployGate.

Register UDIDs of iOS Devices

Once the iOS device completes its registration with Apple Developer, the Provisioning Profile will be updated, the project will be rebuilt, and the new app will be uploaded to DeployGate.

dg add-devices --udid ${udid}

--device-name option also can be used to specify your iOS device’s name for your Apple Developer registration.

dg add-devices --udid ${udid} --device-name 'new ios device'

Automatically Register UDIDs When Adding New iOS Devices

--server option will activate a server that automatically registers the iOS device’s UDID with Apple Developer when a new iOS device is added to the app or distribution page.

dg add-devices --server

Once the iOS device completes its registration with Apple Developer, the Provisioning Profile will be updated, the project will be rebuilt, and the new app will be uploaded to DeployGate, so you can install the app on the newly registered device immediately. Terminate the server with Ctrl-c.

--distribution-key option to specify the distribution page’s hash. iOS device’s UDID registration will take place when a new iOS device is registered to the distribution page (when a new user starts a test on the distribution page).

dg add-devices --server --distribution-key ${distribution_key}

add-devices Command Options

add-devices command has the following available options.

オプション説明
userThe upload target’s post-rebuild username or Organization name
udidiOS device’s UDID
device-nameDevice name upon UDID registration with Apple Developer
distribution-keyserver option and the distribution page’s hash (the “xxxx” portion of the distribution page’s URL /distributions/xxxx) are specified, then it will automatically register the UDID when a new iOS device is registered to the distribution page
serverActivates a server that automatically registers the UDID when a new iOS device is added to the app
configurationSets the Build Configuration for the build

Examples

Specify and add the UDID
dg add-devices --udid ${udid} --device-name 'new ios device'
Automatically register a UDID when a new iOS device is registered to the distribution page
dg add-devices --server --distribution-key ${distribution_key}