Creating iOS Simulator Build

To start capturing and tagging screens of an iOS app, the system has to be provided with the iOS app's zipped simulator build

This document helps in understanding how to generate the simulator build for an iOS app.

The simulator build can be created in two methods

• Via Command Line
• Via Xcode

Via Command Line

The simulator build can be created via the command line. Open terminal and go to the app directory. Enter the command below in the terminal

xcodebuild -sdk iphonesimulator

This will build the Xcode project and generate the build.

If the application is developed in a workspace (if the project directory has a .xcworkspace file) use the command below instead

xcodebuild -workspace <workspace filename> -scheme <scheme name> -sdk iphonesimulator

The build will be generated inside the app directory under ../Build/Release-iphonesimulator folder

Via Xcode

Open the app in Xcode and build the application with a simulator target (preferably a recent device with the latest iOS version). Once the build has been successfully completed, right-click the app name under Products folder in file navigator and select 'Show in Finder'. This will open the folder with the simulator build. By default this

The simulator build is a container with .app extension. Zip this folder .app container. Upload this zip file to our platform.

Issues that can occur

• When running the command in the terminal, the .app container may fail to include the app binary. In this case, the build can be generated using the Xcode approach.

• The xcodebuild command has multiple options. The main options are scheme, target, architecture etc. The correct scheme should be used to generate the expected build. xcodebuild -list will help in understanding what all are the available schemes, targets, architectures. The developer has to use the correct options to create the simulator build to be uploaded