| workspace | Path to the Xcode workspace (.xcworkspace). Mutually exclusive with `project`. | no | — |
| project | Path to the Xcode project (.xcodeproj). Mutually exclusive with `workspace`. | no | — |
| scheme | Scheme to build. | yes | — |
| configuration | Build configuration (e.g. Debug, Release). | no | Release |
| sdk | SDK to build against (e.g. iphoneos, iphonesimulator, macosx). | no | — |
| destination | Destination specifier (e.g. "generic/platform=iOS"). | no | — |
| action | xcodebuild action: build, archive, test, build-for-testing, clean. | no | build |
| archive-path | Output path for the .xcarchive. Required when `action` is `archive`. | no | — |
| export-options-plist | Path to an ExportOptions.plist. When provided after an archive, the archive is exported to `export-path`. | no | — |
| export-path | Directory to export the archive to when `export-options-plist` is provided. Defaults to `<result-bundle-dir>/<scheme>.ipa`. | no | — |
| derived-data-path | Derived data directory. | no | .build/DerivedData |
| result-bundle-path | Path for the .xcresult bundle. Defaults to `.build/Artifacts/<scheme>.xcresult`. | no | — |
| build-number | Value passed to xcodebuild as CURRENT_PROJECT_VERSION. | no | — |
| build-settings | Additional xcodebuild build settings as KEY=VALUE pairs, one per line. | no | — |
| extra-arguments | Additional arguments passed verbatim to xcodebuild (shell-quoted). | no | — |
| output-formatter | Command to pipe xcodebuild output through (e.g. xcbeautify, xcpretty). Set to an empty string to disable. The default uses xcbeautify's github-actions renderer so compile errors and warnings surface as inline PR annotations. | no | xcbeautify --renderer github-actions |
| log-path | Path to write the raw xcodebuild log. Defaults to `.build/<scheme>.log`. | no | — |
| parallelize-targets | Pass -parallelizeTargets to xcodebuild. | no | true |
| show-build-timing-summary | Pass -showBuildTimingSummary to xcodebuild. | no | true |
| disable-automatic-package-resolution | Pass -disableAutomaticPackageResolution to xcodebuild. | no | true |
| zip-result-bundle | Zip the .xcresult bundle next to itself as <result-bundle-path>.zip after the build. | no | false |
| zip-archive | Zip the .xcarchive next to itself as <archive-path>.zip after archiving. | no | false |
| working-directory | Working directory to run xcodebuild in. | no | — |