Matt Bruce 370647c882 more edits

Signed-off-by: Matt Bruce <matt.bruce1@toyota.com>

2026-02-12 16:50:00 -06:00

1.3 KiB

Raw Blame History

xcodebuildmcp/config.yaml Reference

This file is required for XcodeBuildMCP to automate builds, tests, and simulator actions. It tells the tool which workspace, scheme, configuration, and simulator to use.

Example config.yaml

schemaVersion: 1
sessionDefaults:
  workspacePath: ./OneApp.xcworkspace
  scheme: ToyotaOneApp
  configuration: Debug
  simulatorName: iPhone 17 Pro Max
  simulatorId: <SIMULATOR_UDID>
  useLatestOS: true

Key Fields

workspacePath: Path to your .xcworkspace or .xcodeproj
scheme: The Xcode scheme to build/test
configuration: Build configuration (Debug, Release, etc.)
simulatorName: Name of the simulator to use
simulatorId: UDID of the simulator (optional; takes precedence over name)
useLatestOS: If true, always use the latest available iOS version

Where to put it

Place this file at .xcodebuildmcp/config.yaml in your repo root.

Why it matters

This config lets XcodeBuildMCP run builds, tests, and launches without manual setup. It ensures all developers and CI jobs use the same settings.

Troubleshooting

If builds fail, check workspacePath and scheme.
If the simulator isn’t found, check simulatorName or simulatorId.
If you change project structure, update config.yaml accordingly.

1.3 KiB Raw Blame History Unescape Escape