Producing an iOS Build

Moropo supports running tests on iOS using a .app simulator build file.

Please note: real iOS device builds with the file extension .ipa are currently not supported.

Important: ensure your zip your .app

Because of the way that some operating systems handle .app files, it's essential that you zip your build before uploading it to Moropo.

The file you upload will look like this: How to zip on MacOS, Windows.

Which build type should I use?

You can use any backend environment so long as your build target is simulator.

Many Moropo users configure different test setups for different build types. For example:

  • a simulator build using your Dev Environment that runs a regression suite on each pull request for a single device

  • a simulator build using your Staging Environment that runs a full test suite before each production release across a wide range of devices

Using XCode Command Line to produce a .app

If you're comfortable with the terminal and have a natively-built iOS app, you can use xcrun to produce your build file.

For example, to build an app called "Classy Mall":

xcrun xcodebuild -scheme 'Classy Mall' \
-project 'Class Mall.xcodeproj' \
-sdk 'iphonesimulator' \
-configuration Debug \
-destination 'generic/platform=iOS Simulator' \
-derivedDataPath \

Once successful, your .app simulator build will be found in the ./build folder.

Using XCode UI to produce a .app

If you prefer a user interface, you can use XCode to produce your build file:

  1. Launch XCode.

  2. Open your project.

  3. Click on the Product menu in the top bar, then select Build.

[React Native] Using Expo EAS to produce a .app

If your app is built using React Native, you can use Expo Application Services to build your app.

Ensure your eas.config includes the correct setting:

  "build": {
    "myProfile": {
      "ios": {
        "simulator": true

Note: EAS allows a .app to be produced using various config options; read the official docs.

Run EAS via your terminal to trigger the build:

eas build -p ios --profile myProfile

Using Flutter to produce a .app

If your app is built using Flutter, you can use the flutter command line inside your terminal.

To produce an iOS simulator build, run flutter build ios --debug --simulator

Your .app will appear in the ./build/ios/iphonesimulator/ folder.

Last updated