Previewing apps in the browser

Workflow Editor Testing Previewing apps in the browser

How to preview and test your iOS or Android app on a simulator or emulator running in the browser

Codemagic allows you to launch your iOS or Android app on an iOS simulator or Android emulator running in the browser, regardless of the operating system you are using. Test your app against different device and OS configurations, emulate GPS location or demo the latest app version without needing access to a physical device.

This feature is available for teams on request. You can request access in the application.

Tip: The following sections describe creating previewable artifacts using the Flutter Workflow Editor. If you’re using codemagic.yaml, follow the instructions here.

Creating iOS .app binaries for previewing on the simulator

You can preview any .app artifact built in Codemagic that targets the iPhoneSimulator.

  1. In the Build section of the Workflow Editor, set the Mode to Debug.
  2. In the Build arguments field, add --simulator next to the iOS --debug section.
  3. On a successful build, you will see the Quick Launch button available next to the .app artifact in the build overview.

Creating Android .apk binaries for previewing on the emulator

You can preview any .apk artifact built in Codemagic.

In the Build section of the Workflow Editor, select an Android build format that outputs an .apk file. On a successful build, you will see the Quick Launch button available next to the .app artifact in the build overview.

Previewing apps

Clicking Quick Launch next to a suitable artifact launches an iOS simulator or an Android emulator respectively with your app installed on it, right in your browser.

To use a different device and OS combination, click the three dots on the controls menu and select Change device.

The preview session remains active for a maximum of 20 minutes and is limited to one concurrent session by default. To end the ongoing session, select Stop session from the menu.