@nrwl/react-native:build-ios

Build iOS app.

Options can be configured in project.json when defining the executor, or when invoking it. Read more about how to configure targets and executors here: https://nx.dev/reference/project-configuration#targets.

project.json:

{
  "name": "mobile",
  //...
  "targets": {
    //...
    "build-ios": {
      "executor": "@nrwl/react-native:build-ios",
      "options": {}
    }
  }
}

nx run mobile:build-ios

Examples

The buildFolder option allows to specify the location for ios build artifacts. It corresponds to Xcode's -derivedDataPath.

    "build-ios": {
      "executor": "@nrwl/react-native:build-ios",
      "options": {
        "buildFolder": "dist/ios/build"
      }
    }

The mode option allows to specify the xcode configuartion, such as Debug or Release.

    "build-ios": {
      "executor": "@nrwl/react-native:build-ios",
      "options": {
        "mode": "Release"
      }
    }

Options playground

Try out this interactive editor of the configuration object. Values are validated as you type and hovering over labels will give you more information.

Examples

These buttons show the config object for specific common tasks.

Options

mode

string

Default: Debug

Explicitly set the scheme configuration to use

simulator

string

Explicitly set simulator to use. Optionally include iOS version between parenthesis at the end to match an exact version: "iPhone 6 (10.0)"

buildFolder

string

Default: ./build

Location for iOS build artifacts. Corresponds to Xcode's "-derivedDataPath". Relative to ios directory

device

string

Explicitly set device to use by name. The value is not required if you have a single device connected.

extraParams

string

Custom params that will be passed to xcodebuild command.

interactive

boolean

Explicitly select which scheme and configuration to use before running a build

install

boolean

Runs pod install for native modules before building iOS app.

port

number

Default: 8081

The port where the packager server is listening on.

packager

boolean

Default: true

Launch packager while building

resetCache

boolean

Default: false

Resets metro cache.

schema

string

Explicitly set Xcode scheme to use

sync

boolean

Default: true

Syncs npm dependencies to package.json (for React Native autolink).

udid

string

Explicitly set device to use by udid

verbose

boolean

Do not use xcbeautify or xcpretty even if installed

xcconfig

string

Explicitly set xcconfig to use