run-on-device
Build and run Xcode projects directly on specified iOS devices or simulators. Stream logs, set environment variables, and manage configurations for efficient app development and debugging.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| configuration | No | 빌드 구성 (Debug/Release) | |
| device | Yes | 기기 식별자 또는 이름 (한글 이름 지원) | |
| directBundleId | No | 직접 지정할 번들 ID (프로젝트에서 추출하지 않음) | |
| environmentVars | No | 앱에 전달할 환경 변수 (key1=value1,key2=value2 형식) | |
| extraLaunchArgs | No | devicectl launch 명령어에 전달할 추가 인자 | |
| listDevices | No | 실행 전 감지된 모든 디바이스 목록 표시 | |
| projectPath | Yes | Xcode 프로젝트 또는 워크스페이스 경로 | |
| scheme | Yes | 빌드 및 실행할 스킴 | |
| skipBuild | No | 이미 설치된 앱을 재실행할 때 빌드 및 설치 건너뛰기 | |
| startStopped | No | 디버거 연결을 위한 일시 중지 상태로 시작 | |
| streamLogs | No | 앱 실행 후 로그 스트리밍 여부 | |
| xcodePath | No | Xcode 애플리케이션 경로 |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"configuration": {
"description": "빌드 구성 (Debug/Release)",
"type": "string"
},
"device": {
"description": "기기 식별자 또는 이름 (한글 이름 지원)",
"type": "string"
},
"directBundleId": {
"description": "직접 지정할 번들 ID (프로젝트에서 추출하지 않음)",
"type": "string"
},
"environmentVars": {
"description": "앱에 전달할 환경 변수 (key1=value1,key2=value2 형식)",
"type": "string"
},
"extraLaunchArgs": {
"description": "devicectl launch 명령어에 전달할 추가 인자",
"items": {
"type": "string"
},
"type": "array"
},
"listDevices": {
"description": "실행 전 감지된 모든 디바이스 목록 표시",
"type": "boolean"
},
"projectPath": {
"description": "Xcode 프로젝트 또는 워크스페이스 경로",
"type": "string"
},
"scheme": {
"description": "빌드 및 실행할 스킴",
"type": "string"
},
"skipBuild": {
"description": "이미 설치된 앱을 재실행할 때 빌드 및 설치 건너뛰기",
"type": "boolean"
},
"startStopped": {
"description": "디버거 연결을 위한 일시 중지 상태로 시작",
"type": "boolean"
},
"streamLogs": {
"description": "앱 실행 후 로그 스트리밍 여부",
"type": "boolean"
},
"xcodePath": {
"description": "Xcode 애플리케이션 경로",
"type": "string"
}
},
"required": [
"projectPath",
"scheme",
"device"
],
"type": "object"
}