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 |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"configuration": {
"description": "Build configuration (Debug, Release, etc.)",
"type": "string"
},
"derivedDataPath": {
"description": "Path where build products and other derived data will go",
"type": "string"
},
"extraArgs": {
"description": "Additional xcodebuild arguments",
"items": {
"type": "string"
},
"type": "array"
},
"preferXcodebuild": {
"description": "If true, prefers xcodebuild over the experimental incremental build system, useful for when incremental build system fails.",
"type": "boolean"
},
"projectPath": {
"description": "Path to the .xcodeproj file (Required)",
"type": "string"
},
"scheme": {
"description": "The scheme to use (Required)",
"type": "string"
},
"simulatorName": {
"description": "Name of the simulator to use (e.g., 'iPhone 16') (Required)",
"type": "string"
},
"useLatestOS": {
"description": "Whether to use the latest OS version for the named simulator",
"type": "boolean"
}
},
"required": [
"projectPath",
"scheme",
"simulatorName"
],
"type": "object"
}