Xcode Build for Simulator

This Step runs the xcodebuild command to build and deploy an app to an iOS, tvOS, or watchOS simulator. You can use this to perform quick tests of your app, or to show it off in a browser to your clients.

The Step generates the following outputs:

• BITRISE_APP_DIR_PATH: The path to the generated .app file.
• BITRISE_APP_DIR_PATH_LIST: The path to the generated .app file, and the paths to every dependent target app. (Paths are separated by the | (pipe) character.)
• BITRISE_XCODE_BUILD_RAW_RESULT_TEXT_PATH: The path to the raw log file for the build.

The Step also creates an .xctestrun file which you can use to run tests.

Make sure to include this Step after the Steps that install the necessary dependencies — such as Run Cocoapods Install — in your Workflow.

Configuring the Step

Minimum configuration:

1. In the Project path input, enter the path to your Xcode Project or Workspace. (Only necessary if you plan to use a different scheme than the one set in the BITRISE_PROJECT_PATH Environment Variable.)
2. In the Scheme input, enter the name of the Scheme you'd like to use for building your project. (Only necessary if you plan to use a different scheme than the one set in the BITRISE_SCHEME Environment Variable.)

For more configuration options, see the descriptions of other inputs in the step.yml or in the Workflow Editor.

Useful links

• Deploying an iOS app for simulators

Related Steps

• Xcode build for testing for iOS
• Appetize.io deploy