# run-ios ## Description * Runs a MiniApp on an iOS emulator or connected device ## Syntax `ern run-ios` **Options** `--baseComposite ` * Git or File System path, to the custom Composite repository (refer to the \[custom Composite] documentation for more information). `--descriptor, -d` * complete native application descriptor `--dev [true|false]` * Enable or disable React Native dev support `--host` * Host or ip to launch the local packager on. * By default it will use the IP address that is returned by the `ipconfig getifaddr en0` command, and fallback to `localhost` in the case the command fails. `--launchArgs` * Arguments to pass to the application when launching it (correspond to the `Arguments Passed On Launch` in application scheme run config in XCode as can be seen on screenshot below). * Make sure to use `=` on the command line to provide this option, and keep the string in quotes. For example `--launchArgs="-ArgA -ArgB"` `--launchEnvVars` * Environment variables to pass to the application when launching it (correspond to the `Environment Variables` in application scheme run config in XCode as can be seen on screenshot below). * Make sure to use `=` on the command line to provide this option, and keep the string in quotes. The string should contain `key=value` pairs delimited by spaces. For example `--launchEnvVars="aKey=aValue anotherKey=anotherValue"` ![xcode scheme run](/files/-LqnImIp5JVofvzLQKC5) `--mainMiniAppName` * Name of the MiniApp to launch when starting the Runner application `--miniapps/m` * One or more MiniApps to combine in the Runner Container `--port` * Port on which the local packager should listen on *(default: 8081)* `--usePreviousDevice/-u` * Use the previously selected device to avoid prompt ## Remarks * You can launch the MiniApp located in the current working directory or on a connected iOS device or running emulator if available. If a connected iOS device is not available, the command prompts you to select an emulator to launch from the list of installed emulator images. * The first time you run this command from within a MiniApp directory, it generates an iOS directory containing the iOS Runner application project. If the iOS folder already exists (it is not the first run of the `ern run-ios` command for this MiniApp), the existing runner project is used. * After the runner project is generated, you can safely make native code modifications to it, knowing that the next time the `ern run-ios` command is issued, the project and your changes will remain. * If you want to regenerate the runner project from scratch, remove the iOS directory. * The miniapp can be any Yarn package descriptor, including Git or other file system path schemes. * The `ern run-ios` command is the `ern` equivalent of the `react-native run-ios` command. \[custom Composite]: ./platform-parts/composite/index.md --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://native.electrode.io/v0.40/cli-commands/run-ios.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.