Install Self-Hosted
Get Started on Cloud
BasicsPipelinesActions & ServicesEnvironmentsIntegrationsTargetsTestsDomainsSandboxesAgents & TunnelsYAML

YAML for Xcode

View as Markdown

Execute commands on a native macOS virtual machine for iOS/macOS development.

YAML parameters for Xcode

PARAMETERS
typerequiredstring

Value: NATIVE_BUILD_MAC

actionrequiredstring
Unique identifier for the action within the pipeline.
sync_pathsSyncPathYaml[]
File paths that should be copied before and after the execution.
shellstring enum
Shell to use for executing commands.
Allowed enum:
SH,
BASH,
POWERSHELL
xcode_versionstring
The version of Xcode to use
pre_start_simulatorsstring[]
The list of simulators to start before the build
certificatesstring[]
The list of certificates to use for signing
provision_profilesstring[]
The list of provisioning profiles to use
working_directorystring
Directory where commands are executed.
execute_every_commandboolean
When true, execute all commands even if earlier ones fail.
commandsstring[]
The commands to execute in the native build environment
trigger_timestring enum
Specifies when the action should be executed.
Allowed enum:
ON_EVERY_EXECUTION,
ON_SUCCESS,
ON_FAILURE,
ON_BACK_TO_SUCCESS,
ON_WARNING,
ON_WAIT_FOR_APPROVE,
ON_TERMINATE
loopstring[]
The list of variables for dynamic action execution. The action runs once for each value.
run_only_on_first_failureboolean
Defines whether the action should be executed on each failure. Restricted to and required if the trigger_time is ON_FAILURE.
disabledboolean
When set to true the action is disabled. By default it is set to false.
timeoutinteger
The timeout in seconds.
ignore_errorsboolean
If set to true the execution will proceed, mark action as a warning and jump to the next action. Doesn't apply to deployment actions.
retry_intervalinteger
Delay time between auto retries in seconds.
retry_countinteger
Number of retries if the action fails.
run_nextstring enum
Defines whether the action should run in parallel with the next one.
Allowed enum:
WAIT_ON_SUCCESS,
IN_SOFT_PARALLEL,
IN_HARD_PARALLEL
trigger_conditionsTriggerConditionYaml[]
The list of trigger conditions to meet so that the action can be triggered.
variablesVariableYaml[]
The list of variables you can use in the action.

Last modified on Jul 31, 2025

Previous pageWP CLINext pageZIP

YAML examples for Xcode

Run commands on macOS

yaml
  - action: "Run commands on macOS"
    type: "NATIVE_BUILD_MAC"
    trigger_time: "ON_EVERY_EXECUTION"
    working_directory: "/Users/buddy/project"
    shell: "SH"
    xcode_version: "15.0"
    commands:
      - "xcodebuild -project MyApp.xcodeproj -scheme MyApp build"
    certificates:
      - "my_distribution_cert"
    provision_profiles:
      - "my_provision_profile"