Installing builds

Register test devices

Testers can register their devices from Runway's desktop site by navigating to Profiles and devices and selecting Add a test device. Runway provides the option to register devices via a QR code or manually.

The QR code device registration flow is currently supported on mobile devices using Chrome and Safari.

Installing builds

Builds can be installed on a compatible mobile (iOS or Android) device either from the Runway desktop site, or by navigating to the Runway site on your mobile device’s browser. Note that on iOS, only .ipa builds are currently installable.

Supported binary file types are:

• .apk

• .aab

• .ipa

Android AAB builds cannot be directly installed on Android devices by default.

Runway can automatically generate installable universal APKs from AABs being pulled into a bucket. To enable this functionality you must upload your app's signing key to Runway under App settings > Signing keys.

List of builds in buckets

Bucket detail with installation action

Installing a build from the Runway desktop site

To install a build from the Runway desktop site, click one of the two options on the “Install” menu for the desired build:

• Install on mobile device from QR code: a QR code will be surfaced that you can scan with the camera app on your phone. You will be prompted to sign in on the Runway mobile site, after which the appropriate build installation page will open. Clicking “Install” from the build details page on your mobile device will install the build

• Share a link with myself on Slack: A link to the installation page will be sent to you via Direct Message (DM) on Slack. Open the link on your mobile device, and then click “Install” on the build details page from your mobile device to install the build

iOS builds must be properly signed and provisioned for installation before you can install them on your device. See the signing & provisioning cheatsheet section for more details on how to sign and provision builds for installation.