Skip to content

Xcode - Steps

Steps

Steps

Process steps in the Xcode plug-in

Apple Generic Versioning

Apply a marketing or technical version to a project using the agvtool command.

NameTypeDescriptionRequired
Marketing VersionStringThe marketing version to set.No
VersionStringThe technical version to set.No
agvtool PathStringThe fully-qualified path of the agvtool command.Yes

Package Application

Package the application to a .ipa file using the xcrun tool.

NameTypeDescriptionRequired
Application NameStringThe name of the application to package. Typically, this is the name of the built project.Yes
Developer NameStringThe name of the developer to sign the package.Yes
Keychain NameStringThe name of the keychain to use when signing code. Keychains are in the $HOME/Library/Keychains directory on the agent.No
Keychain PasswordPasswordThe keychain password used to unlock the login keychain for the agent running the build. The password is used only if the keychain is locked.No
Provision ProfileStringThe path to the provisioning profile file to embed.Yes
SDKStringThe name or path of the SDK to create the package for. For example: iphoneosYes
TargetStringThe name of the build target to package.Yes
TimeoutStringThe number of seconds to keep the keychain unlocked. Set the value to 0 to disable timeout on the keychain.No
xcrun PathStringThe fully-qualified path to the xcrun tool. The default value is /usr/bin/xcrun.Yes

Xcode Build

Build an Xcode project using the xcodebuild command.

NameTypeDescriptionRequired
ARCHStringThe architectures to build for each target. The value in this property overrides architectures that are defined in the project.No
Build Active Architecture OnlyBooleanBuild only the currently active architecture. If cleared, the ONLY_ACTIVE_ARCH=NO parameter is passed to xcodebuild.No
ConfigurationStringThe name of the configuration to build, typically Debug or Release. Leave blank for the default configuration.No
Keychain NameStringThe name of the keychain to use for signing code. Keychains are in the $HOME/Library/Keychains directory on the agent. This value is required if Perform Code Signing is selected.No
Keychain PasswordPasswordIf the build automatically packages and signs the code, the keychain password to unlock the login keychain for the agent running the build. The password is used only if the keychain is locked.No
Max Parallel JobsStringThe maximum number of jobs that can be built at the same time.No
Parallelize TargetsBooleanBuild all targets at the same time.No
Perform Code SigningBooleanPackaging and code signing occurs automatically during the build.No
Project FileStringThe relative path to the project file to build. To build all projects, leave this property blank.No
SDK pathStringThe name or path of the base SDK to use with the build.No
SchemeStringThe scheme name to build.No
TargetStringThe target name to build. To build all targets, leave this property blank.No
TimeoutStringThe number of seconds to keep the keychain unlocked. Set the value to 0 to disable timeout on the keychain.No
ToolchainStringUse the toolchain with identifier or name.No
Workspace FileStringThe relative path to the workspace file to build. To build a project, leave this property blank.No
xcodebuild PathStringThe full path to xcodebuild.Yes