build_run_sim_name_proj
Build and run an Xcode project on a specified simulator by providing the project path, scheme, and simulator name. Supports custom build configurations, derived data paths, and additional xcodebuild arguments.
Instructions
Builds and runs an app from a project file on a simulator specified by name. IMPORTANT: Requires projectPath, scheme, and simulatorName. Example: build_run_sim_name_proj({ projectPath: '/path/to/project.xcodeproj', scheme: 'MyScheme', simulatorName: 'iPhone 16' })
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| configuration | No | Build configuration (Debug, Release, etc.) | |
| derivedDataPath | No | Path where build products and other derived data will go | |
| extraArgs | No | Additional xcodebuild arguments | |
| preferXcodebuild | No | If true, prefers xcodebuild over the experimental incremental build system, useful for when incremental build system fails. | |
| projectPath | Yes | Path to the .xcodeproj file (Required) | |
| scheme | Yes | The scheme to use (Required) | |
| simulatorName | Yes | Name of the simulator to use (e.g., 'iPhone 16') (Required) | |
| useLatestOS | No | Whether to use the latest OS version for the named simulator |