diff --git a/docs/running-on-simulator-ios.md b/docs/running-on-simulator-ios.md index 20c1f384cbe..5f99870ce42 100644 --- a/docs/running-on-simulator-ios.md +++ b/docs/running-on-simulator-ios.md @@ -9,6 +9,14 @@ Once you have your React Native project initialized, you can run `npx react-nati ## Specifying a device -You can specify the device the simulator should run with the `--simulator` flag, followed by the device name as a string. The default is `"iPhone 13"`. If you wish to run your app on an iPhone SE (2nd generation), run `npx react-native run-ios --simulator="iPhone SE (2nd generation)"`. +You can specify the device the simulator should run with the `--simulator` flag, followed by the device name as a string. The default is `"iPhone 13"`. If you wish to run your app on an iPhone SE (2nd generation), run `npx react-native run-ios --simulator='iPhone SE (2nd generation)'`. The device names correspond to the list of devices available in Xcode. You can check your available devices by running `xcrun simctl list devices` from the console. + +### Specifying a version of device + +If you have multiple iOS versions installed, you also need to specify it's appropiate version. E.g. run `npx react-native run-ios --simulator='iPhone 13 Pro (15.5)'` in order to specify the iOS version. + +## Specifying an UDID + +You can specify the device UDID returned from `xcrun simctl list devices` command. E.g. run `npx react-native run-ios --udid='AAAAAAAA-AAAA-AAAA-AAAA-AAAAAAAAAAAA'`.