Skip to main content

Managing distributable builds

You can access all your distributable builds on the Build distribution page: these are the builds you can distribute to internal testers. Distributable builds are the following:

  • For iOS apps, they are IPAs with Development, Ad-hoc, or Enterprise provisioning.

  • For Android apps, only APKs are distributable to testers. AABs are not.

Each distributable build has its own page that includes installation instructions and metadata. The metadata includes, among other things, the source of the artifact, its creation time, size, and supported device types.

You can set up tester groups so that testers can get access to the build details page and install the app from there. Workspace owners, Workspace managers and project admins can also send notification emails to tester groups from the build page. For details, see Tester groups.

You can upload installable artifacts to the page from Bitrise CI builds or via our dedicated API. For details, see Uploading installable artifacts.

Accessing the build details page

To access the build details page on Bitrise:

Login required

You need a Bitrise user account to access the build details page. The account must be a member of the project's team.

  1. Open your connected app in Release Management.

  2. Select Build distribution on the left.

  3. Select the Builds tab.

  4. Find the build you need and click the arrow on the right.

    build-details-access.png

Installing artifacts

You can install build artifacts from its build details page. To do so:

  1. Access the build details page of the build.

    You can also access the build details page from a notification email.

  2. Click Download artifact on the top right.

    build-details-page.png

    • If your app is an Android app, the download will start immediately.

    • If your app is an iOS app, you'll see a dialog that provides instructions for installing the app on a device.

      ios-download-rm.png

Enabling the public install page

The public install page allows you to distribute your installable artifacts to testers who don't have Bitrise accounts.

  1. Access the build details page of the build.

  2. In the Install this version section, toggle the Public install page option on.

    Required access

    Only Workspace owners, Workspace managers, and project admins have the right to enable or disable the public install page for a build.

    build-details-page.png

  3. Click Get link to open a dialog that contains both a URL and a QR code.

In this section: