120 lines
5.9 KiB
JSON
120 lines
5.9 KiB
JSON
{
|
|
"name": "run-ios",
|
|
"implementation": "/packages/react-native/src/executors/run-ios/run-ios.impl.ts",
|
|
"schema": {
|
|
"version": 2,
|
|
"outputCapture": "direct-nodejs",
|
|
"cli": "nx",
|
|
"$id": "NxReactNativeRunIos",
|
|
"$schema": "http://json-schema.org/schema",
|
|
"title": "Run iOS application",
|
|
"description": "Run iOS target options.",
|
|
"type": "object",
|
|
"presets": [
|
|
{ "name": "Run iOS on a simulator", "keys": ["simulator"] },
|
|
{ "name": "Run iOS on a device", "keys": ["device"] },
|
|
{ "name": "Run iOS on a device with udid", "keys": ["udid"] },
|
|
{
|
|
"name": "Run `pod install` before building iOS app",
|
|
"keys": ["install"]
|
|
}
|
|
],
|
|
"properties": {
|
|
"xcodeConfiguration": {
|
|
"type": "string",
|
|
"description": "Explicitly set the Xcode configuration to use.",
|
|
"default": "Debug",
|
|
"examples": ["Debug", "Release"],
|
|
"x-deprecated": "Use `mode` instead. Deprecated from @react-native-community/cli. Will be removed in Nx 17."
|
|
},
|
|
"simulator": {
|
|
"type": "string",
|
|
"description": "Explicitly set simulator to use. Optionally include iOS version between parenthesis at the end to match an exact version: \"iPhone 6 (10.0)\"",
|
|
"examples": [
|
|
"iPhone 14",
|
|
"iPhone 13",
|
|
"iPhone 12",
|
|
"iPhone 11",
|
|
"iPhone X"
|
|
],
|
|
"x-priority": "important"
|
|
},
|
|
"mode": {
|
|
"type": "string",
|
|
"description": "Explicitly set the scheme configuration to use",
|
|
"default": "Debug",
|
|
"examples": ["Debug", "Release"],
|
|
"x-priority": "important"
|
|
},
|
|
"schema": {
|
|
"type": "string",
|
|
"description": "Explicitly set Xcode scheme to use"
|
|
},
|
|
"device": {
|
|
"type": "string",
|
|
"description": "Explicitly set device to use by name. The value is not required if you have a single device connected."
|
|
},
|
|
"udid": {
|
|
"type": "string",
|
|
"description": "Explicitly set device to use by udid"
|
|
},
|
|
"verbose": {
|
|
"type": "boolean",
|
|
"description": "Do not use xcbeautify or xcpretty even if installed"
|
|
},
|
|
"port": {
|
|
"type": "number",
|
|
"description": "The port where the packager server is listening on.",
|
|
"default": 8081
|
|
},
|
|
"xcconfig": {
|
|
"type": "string",
|
|
"description": "Explicitly set xcconfig to use"
|
|
},
|
|
"buildFolder": {
|
|
"type": "string",
|
|
"description": "Location for iOS build artifacts. Corresponds to Xcode's \"-derivedDataPath\". Relative to ios directory.",
|
|
"buildFolder": "./build"
|
|
},
|
|
"interactive": {
|
|
"type": "boolean",
|
|
"description": "Explicitly select which scheme and configuration to use before running a build"
|
|
},
|
|
"extraParams": {
|
|
"type": "string",
|
|
"description": "Custom params that will be passed to xcodebuild command."
|
|
},
|
|
"install": {
|
|
"type": "boolean",
|
|
"description": "Runs `pod install` for native modules before building iOS app.",
|
|
"default": false
|
|
},
|
|
"sync": {
|
|
"type": "boolean",
|
|
"description": "Syncs npm dependencies to `package.json` (for React Native autolink).",
|
|
"default": true
|
|
},
|
|
"resetCache": {
|
|
"type": "boolean",
|
|
"description": "Resets metro cache.",
|
|
"default": false
|
|
},
|
|
"packager": {
|
|
"type": "boolean",
|
|
"description": "Launch packager while building",
|
|
"default": true
|
|
},
|
|
"binaryPath": {
|
|
"type": "string",
|
|
"description": "Path relative to project root where pre-built .app binary lives."
|
|
}
|
|
},
|
|
"examplesFile": "`project.json`:\n\n```json\n{\n \"name\": \"mobile\",\n //...\n \"targets\": {\n //...\n \"run-ios\": {\n \"executor\": \"@nx/react-native:run-ios\",\n \"options\": {}\n }\n }\n}\n```\n\n```bash\nnx run mobile:run-ios\n```\n\n## Examples\n\n{% tabs %}\n{% tab label=\"Build the Debug/Release app\" %}\nThe `mode` option allows to specify the xcode configuartion schema, such as `Debug` or `Release`.\n\n```json\n \"run-ios\": {\n \"executor\": \"@nx/react-native:run-ios\",\n \"options\": {\n \"mode\": \"Release\"\n }\n }\n```\n\n```bash\nnx run-ios <app-name> --mode=Debug\n```\n\n{% /tab %}\n{% tab label=\"Run on a simulator\" %}\nThe `simulator` option allows you to launch your iOS app in a specific simulator.\n\nTo see all the available simulators, run command:\n\n```bash\nxcrun simctl list devices available\n```\n\n```json\n \"run-ios\": {\n \"executor\": \"@nx/react-native:run-ios\",\n \"options\": {\n \"simulator\": \"iPhone 14 Pro (16.2)\"\n }\n }\n```\n\n```bash\nnx run-ios <app-name> --simulator=\"iPhone 14 Pro (16.2)\"\n```\n\n{% /tab %}\n{% tab label=\"Run on a device\" %}\nThe `device` option allows you to launch your iOS app in a specific device.\n\nTo see all the available devices, run command:\n\n```bash\nxcrun simctl list devices available\n```\n\n```json\n \"run-ios\": {\n \"executor\": \"@nx/react-native:run-ios\",\n \"options\": {\n \"device\": \"deviceName\"\n }\n }\n```\n\n```bash\nnx run-ios <app-name> --device=\"deviceName\"\n```\n\n{% /tab %}\n{% tab label=\"Set Device by udid\" %}\nThe `udid` option allows you to explicitly set device to use by udid.\n\nTo see all the available simulators and devices with udid, run command:\n\n```bash\nxcrun simctl list devices available\n```\n\n```json\n \"run-ios\": {\n \"executor\": \"@nx/react-native:run-ios\",\n \"options\": {\n \"udid\": \"device udid\"\n }\n }\n```\n\n```bash\nnx run-ios <app-name> --udid=\"device udid\"\n```\n\n{% /tab %}\n{% /tabs %}\n\n---\n"
|
|
},
|
|
"description": "Runs iOS application.",
|
|
"aliases": [],
|
|
"hidden": false,
|
|
"path": "/packages/react-native/src/executors/run-ios/schema.json",
|
|
"type": "executor"
|
|
}
|