Device Preview

Creates a shareable Device Preview link for an app artifact from this build. Opening the link boots a fresh iOS Simulator or Android Emulator in the browser, installs the app and launches it — nothing to download, and no local Xcode or Android SDK needed.

The link is exported as $BITRISE_DEVICE_PREVIEW_URL, so you can use it anywhere later in the Workflow: post it to Slack, attach it to a GitHub check, drop it into release notes, or feed it to your own notification tooling. Set post_pr_comment to true and the Step also posts it as a pull request comment for you.

Supported artifacts

• iOS — a zipped simulator .app bundle, for example the $BITRISE_APP_DIR_PATH.zip produced by the Xcode build for simulator Step. A Simulator cannot run a device build, so .ipa files are rejected.
• Android — an .apk. Android App Bundles (.aab) cannot be installed directly and are rejected.

If the file was already uploaded by an earlier Deploy to Bitrise.io Step, this Step reuses that artifact instead of uploading it again.

Good to know

• The Step fails the build if it cannot create a link. Set is_skippable: true on the Step in your Workflow if you would rather a preview problem did not stop the build.
• Links expire after 24 hours by default, and 72 hours is the maximum.
• Each open of a link starts its own session, which shuts down automatically once nobody is watching it.