This package is part of the [React Native CLI](../../README.md). It contains commands for managing iOS part of React Native app.
npm install @react-native-community/cli-platform-iosThis package is part of the React Native CLI. It contains commands for managing iOS part of React Native app.
``sh`
yarn add @react-native-community/cli-platform-ios
Usage:
`sh`
npx react-native run-ios [options]
Builds your app and starts it on iOS simulator.
#### Options
#### --simulator
> default: iPhone 14
Explicitly set the simulator to use. Optionally include iOS version between parenthesis at the end to match an exact version, e.g. "iPhone 6 (10.0)".
Notes: If selected simulator does not exist, cli will try to run fallback simulators in following order:
- iPhone 14
-
-
-
Notes: simulator_name must be a valid iOS simulator name. If in doubt, open your AwesomeApp/ios/AwesomeApp.xcodeproj folder on XCode and unroll the dropdown menu containing the simulator list. The dropdown menu is situated on the right hand side of the play button (top left corner).
Example: this will launch your project directly onto the iPhone 14 simulator:
`sh`
npx react-native run-ios --simulator "iPhone 14"
#### --mode
Explicitly set the scheme configuration to use. This option is case sensitive.
Example:
`sh`
npx react-native run-ios --mode "Release"
#### --scheme
Explicitly set Xcode scheme to use.
#### --target
Explicitly set Xcode target to use.
#### --device [string]
Explicitly set device to use by name. The value is not required if you have a single device connected.
#### --destination
Explicitly extend destination e.g. "arch=x86_64"
#### --udid
Explicitly set device to use by udid.
#### --no-packager
Do not launch packager while building.
#### --verbose
Do not use xcbeautify or xcpretty even if installed.
#### --port
Runs packager on specified port.
Default: process.env.RCT_METRO_PORT || 8081
#### --xcconfig
Explicitly set xcconfig to use in build.
#### --buildFolder
Location for iOS build artifacts. Corresponds to Xcode's -derivedDataPath.
#### --extra-params
Custom params that will be passed to xcodebuild command.
Example:
`sh`
npx react-native run-ios --extra-params "-jobs 4"
#### --binary-path
Installs passed binary instead of building a fresh one.
#### --list-devices
> default: false
List all available iOS devices and simulators and let you choose one to run the app.
#### --force-pods,
Force running pod install before running an app
#### --only-pods,
Only install Cocoapods, do not build the app.
Usage:
`sh`
npx react-native build-ios [options]
Builds iOS app.
#### Options
#### --mode
Explicitly set the scheme configuration to use. This option is case sensitive.
Example:
`sh`
npx react-native build-ios --mode "Release"
#### --scheme
Explicitly set Xcode scheme to use.
#### --target
Explicitly set Xcode target to use.
#### --device [string]
Explicitly set device to use by name. The value is not required if you have a single device connected.
#### --verbose
Do not use xcbeautify or xcpretty even if installed.
#### --xcconfig
Explicitly pass xcconfig options from the command line.
#### --buildFolder
Location for iOS build artifacts. Corresponds to Xcode's -derivedDataPath.
#### --extra-params
Custom params that will be passed to xcodebuild command.
Example:
`sh`
npx react-native build-ios --extra-params "-jobs 4"
#### --force-pods,
Force running pod install before building an app
#### --only-pods,
Only install Cocoapods, do not build the app.
Usage:
`sh`
npx react-native log-ios
Starts iOS device syslog tail.
#### Options
#### --interactive, -i`
Explicitly select simulator to tail logs from. By default it will tail logs from the first booted and available simulator.