The following plugin provides functionality available through Pipeline-compatible steps. Read more about how to integrate steps into your Pipeline in the Steps section of the Pipeline Syntax page.

For a list of other such plugins, see the Pipeline Steps Reference page.

Xcode integration

importDeveloperProfile: Import developer profile

  • importIntoExistingKeychain : boolean (optional)
  • keychainId : String (optional)
  • keychainName : String (optional)
  • keychainPath : String (optional)
  • keychainPwd (optional)
    • Type: class hudson.util.Secret
  • profileId : String (optional)

exportIpa: Export IPA

  • appURL : String (optional)
  • archiveDir : String (optional)

    Specify the location of the path (usually BUILD_DIR specified by xcodebuild) to read the Archive for exporting the IPA file.
    Supports all macros and also environment and build variables from the Token Macro Plugin.
    For example you can use the value :

    ${WORKSPACE}/build
  • assetPackManifestURL : String (optional)
  • compileBitcode : boolean (optional)
  • copyProvisioningProfile : boolean (optional)
  • developmentTeamID : String (optional)
  • developmentTeamName : String (optional)
  • displayImageURL : String (optional)
  • fullSizeImageURL : String (optional)
  • ipaExportMethod : String (optional)
  • ipaName : String (optional)
  • ipaOutputDirectory : String (optional)
  • keychainId : String (optional)
  • keychainName : String (optional)
  • keychainPath : String (optional)
  • keychainPwd (optional)
    • Type: class hudson.util.Secret
  • manualSigning : boolean (optional)
  • packResourcesAsset : boolean (optional)
  • provisioningProfiles (optional)
      Array / List of Nested Object
    • provisioningProfileAppId : String
    • provisioningProfileUUID : String
  • resourcesAssetURL : String (optional)
  • signingMethod : String (optional)
  • stripSwiftSymbols : boolean (optional)
  • symRoot : String (optional)
  • thinning : String (optional)
  • unlockKeychain : boolean (optional)
  • uploadBitcode : boolean (optional)
  • uploadSymbols : boolean (optional)
  • xcodeName : String (optional)
  • xcodeProjectPath : String (optional)
  • xcodeSchema : String (optional)
  • xcodeWorkspaceFile : String (optional)

unlockMacOSKeychain: Unlock macOS X Keychain

  • keychainId : String (optional)
  • keychainName : String (optional)
  • keychainPath : String (optional)
  • keychainPwd (optional)
    • Type: class hudson.util.Secret

xcodeBuild: Xcode

  • allowFailingBuildResults : boolean (optional)

    Checking this option will prevent a build step from failing if xcodebuild exits with a non-zero return code.
    This can be useful for build steps that run unit tests and also have a post-build task to publish unit test results: the test step will not fail the entire build for a failing unit test, but will instead mark the build unstable in the "publish test" phase.

  • appURL : String (optional)
  • assetPackManifestURL : String (optional)
  • assetPacksBaseURL : String (optional)
  • assetPacksInBundle : boolean (optional)
  • buildDir : String (optional)

    The value to use for the BUILD_DIR setting. You only need to supply this value if you want the product of the Xcode build to be in a location other than the one specified in project settings and this job 'SYMROOT' parameter.
    Supports all macros and also environment and build variables from the Token Macro Plugin.
    For example you can use the value :

    ${WORKSPACE}/build
  • buildIpa : boolean (optional)

    Checking this option will create a .ipa for each .app found in the build directory.
    An .ipa is basically a zipped up .app.
    This is quite handy for distributing ad-hoc builds to testers as they can just double-click the .ipa and it will import into iTunes.

  • bundleID : String (optional)

    The new bundle ID. Usually something like com.companyname.projectname.

  • bundleIDInfoPlistPath : String (optional)

    The path to the info.plist file which contains the CFBundleIdentifier of your project.
    Usually something like:

    • ${WORKSPACE}/ProjectName/Project-Info.plist
  • cfBundleShortVersionStringValue : String (optional)

    This will set the CFBundleShortVersionString to the specified string.
    Supports all macros and also environment and build variables from the Token Macro Plugin.

  • cfBundleVersionValue : String (optional)

    This will set the CFBundleVersion to the specified string.
    Supports all macros and also environment and build variables from the Token Macro Plugin.
    For example the value ${BUILD_NUMBER} will be replaced with the current build number.
    We advice you to generate a unique value for each build if you want for example deploy it into a private store.
    In that case, for example, you can use : ${JOB_NAME}-${BUILD_NUMBER}

  • changeBundleID : boolean (optional)

    Checking this option will replace the bundle identifier.
    You will need to specify which bundle ID (CFBundleIdentifier) to use and where is the Info.plist file located.
    This is handy for example when you want to use a different code signing identity in your development projects.

  • cleanBeforeBuild : boolean (optional)

    This will delete the build directories before invoking the build. This will force the rebuilding of ALL dependencies and can make large projects take a lot longer.

  • cleanResultBundlePath : boolean (optional)

    This will delete the ResultBundlePath before invoking the build.
    If the directory already exists in the location specified by ResultBundlePath, xcodebuild will be an error and should be checked.

  • cleanTestReports : boolean (optional)
  • compileBitcode : boolean (optional)
  • configuration : String (optional)

    This is the name of the configuration as defined in the Xcode project.
    By default there are Debug and Release configurations.

  • copyProvisioningProfile : boolean (optional)
  • developmentTeamID : String (optional)
  • developmentTeamName : String (optional)
  • displayImageURL : String (optional)
  • fullSizeImageURL : String (optional)
  • generateArchive : boolean (optional)

    Checking this option will create an .xcarchive .app found in the build directory.
    An .xcarchive is useful for submission to the app store or third party crash reporters.
    You must specify a Scheme to perform an archive.

  • ignoreTestResults : boolean (optional)
  • interpretTargetAsRegEx : boolean (optional)

    Build all entries listed under the "Targets:" section of the xcodebuild -list output that match the regexp.

  • ipaExportMethod : String (optional)
  • ipaName : String (optional)
  • ipaOutputDirectory : String (optional)
  • keychainId : String (optional)
  • keychainName : String (optional)

    The name of this configured keychain. Each job will specify a keychain configuration by the name.

  • keychainPath : String (optional)

    The path of the keychain to use to retrieve certificates to sign the package (default : ${HOME}/Library/Keychains/login.keychain).

  • keychainPwd (optional)

    The password of the keychain to use to retrieve certificates to sign the package.

    • Type: class hudson.util.Secret
  • logfileOutputDirectory : String (optional)

    Specify the directory to output the log of xcodebuild.
    If you leave it blank, it will be output to "project directory/builds/${BUILD_NUMBER}/log" with other logs.
    If an output path is specified, it is output as a xcodebuild.log file in a relative directory under the "build output directory"

  • manualSigning : boolean (optional)
  • noConsoleLog : boolean (optional)
  • provideApplicationVersion : boolean (optional)
  • provisioningProfiles (optional)
      Array / List of Nested Object
    • provisioningProfileAppId : String
    • provisioningProfileUUID : String
  • resultBundlePath : String (optional)

    Specify the directory to output the output the test result.
    If you leave it blank, it will not output a test result and will not analyze the test results.
    If an output path is specified, it is output as a test result in a relative directory under the "ResultBundlePath".
    The plug-in analyzes the test result here and outputs a JUnit compatible XML file under the ${WORKSPACE}/test-reports.

  • sdk : String (optional)

    You only need to supply this value if you want to specify the SDK to build against. If empty, the SDK will be determined by Xcode. If you wish to run OCUnit tests, you will need to use the iPhone Simulator's SDK, for example:

    /Developer/Platforms/iPhoneSimulator.platform/Developer/SDKs/iPhoneSimulator4.1.sdk/
  • signingMethod : String (optional)
  • stripSwiftSymbols : boolean (optional)
  • symRoot : String (optional)

    You only need to supply this value if you want to specify the SYMROOT path to use.
    If empty, the default SYMROOT path will be used (it could be different depending of your Xcode version).
    Supports all macros and also environment and build variables from the Token Macro Plugin.
    For example you can use the value :

    ${WORKSPACE}/symroot
  • target : String (optional)

    The target to build. If left empty, this will build all targets in the project.
    If you wish to build your binary and the unit test module, it is best to do this as two separate steps each with their own target.
    This was, the iPhone Simulator SDK can be specified for the unit tests.

  • thinning : String (optional)
  • unlockKeychain : boolean (optional)
  • uploadBitcode : boolean (optional)
  • uploadSymbols : boolean (optional)
  • useLegacyBuildSystem : boolean (optional)

    Instead of "New Builld System" which became available from Xcode 9, we build the application using the legacy build system.
    There is a possibility that you can handle old projects that cause problems with the new build system.
    Also, since new output formats of logs are changed in the new build system, it is also useful when you want to handle logs with legacy third party tools.

  • xcodeName : String (optional)
  • xcodeProjectFile : String (optional)
  • xcodeProjectPath : String (optional)
  • xcodeSchema : String (optional)
  • xcodeWorkspaceFile : String (optional)
  • xcodebuildArguments : String (optional)

    Extra xcodebuild parameters, added after the command that jenkins generates based on the rest of the config


Was this page helpful?

Please submit your feedback about this page through this quick form.

Alternatively, if you don't wish to complete the quick form, you can simply indicate if you found this page helpful?

    


See existing feedback here.