iOS Build Distribution

How to get started

If you already have an existing Emerge CI integration: check out your Installable Builds, if you don't see any builds listed you will need to ensure there are uploads with proper signing profiles.
If this is your first time using Emerge, check out our docs on how to complete a CI integration.

Installable Builds

Easily see all of the builds that can be installed with all the filters you want to make sure you're sharing the right builds.

Easy Installation

Any build with a valid signing profile will have automatically generated install codes that are easily accessible from the desktop/mobile web UI.

Auto-update prompt SDK

ETDistribution is a Swift library that simplifies the process of distributing new app versions and checking for updates. It provides an easy-to-use API to verify if a new version is available and handles the update process seamlessly, ensuring your users are always on the latest release.

FAQ

"Unable to install app" error
If you see an "Unable to install app" alert, it's likely because the app wasn't signed for your device. Emerge Tools does not handle app signing. Here's what you can do:

Ask your team to add your device to the provisioning profile.
Verify that the app's certificate hasn't expired.

"Untrusted Enterprise Developer" error
This message appears when you're launching an app from a new or untrusted developer certificate. To resolve it:

Open Settings -> General -> Profiles & Device Management.
Find the developer certificate associated with the app.
Tap "Trust" to allow the app to run on your device.

"Developer Mode Required" error
This error occurs when you're launching an app signed with an ad-hoc certificate and Developer Mode is not enabled. To enable Developer Mode:

Open Settings -> Privacy & Security -> Security -> Developer Mode (scroll to the bottom).
Toggle Developer Mode to enable it.
Restart your device.
After rebooting, you'll be prompted to enable Developer Mode. Tap Turn On to complete the process.