xcode:verification-check

Full name:

com.sap.prd.mobile.ios.mios:xcode-maven-plugin:1.14.5:verification-check

Description:

Provides the possibility to perform verification checks.
The check classes and their severities are described in an additional xml document, defined in xcode.verification.checks.definitionFile.
The specific checks have to be implemented in separate projects. These projects define dependency to Xcode Maven Pugin Verification API and must not reference the xcode-maven-plugin project. The Xcode Maven Plugin Verification API project could be found here The coordinates of that projects need to be provided on the check node belonging to the test as attributes groupId, artifactId and version.
The classpath for this goal will be extended by the jars found under the specified GAVs.
Example checks definition: 
<checks>
  <check groupId="my.group.id" artifactId="artifactId" version="1.0.0" severity="ERROR" class="com.my.MyVerificationCheck1"/>
  <check groupId="my.group.id" artifactId="artifactId" version="1.0.0" severity="WARNING" class="com.my.MyVerificationCheck2"/>
</checks>

Attributes:

  • Requires a Maven project to be executed.

Optional Parameters

Name Type Since Description
buildActions List - The Xcode build action to to execute (e.g. clean, build, install). By default clean and build are executed.
checkDefinitionFile String 1.9.3 The location where the check definition file is present. Could be a file on the local file system or a remote located file, accessed via http or https.
Examples:
  • -Dxcode.verification.checks.definitionFile=file:./checkDefinitionFile.xml
  • -Dxcode.verification.checks.definitionFile=http://example.com/checkDefinitionFile.xml
  • -Dxcode.verification.checks.definitionFile=https://example.com/checkDefinitionFile.xml
checkoutDirectory File - The original Xcode sources located in the src/xcode directory stay untouched during the whole Maven build. However, as we might have to modify the info.plist or the project itself we copy the whole Xcode source directory during the build into another "checkout" directory that by default named checkout and located below the Maven build ( target) directory.
codeSignIdentity String 1.2.0 The code sign identity is used to select the provisioning profile (e.g. iPhone Distribution, iPhone Developer).
codeSigningRequired boolean 1.14.1 The code signing required is used to disable code signing when no developer provisioning certificate is available (e.g. NO, YES).
Default value is: true.
configurations Set - The Xcode configurations that shall be built (e.g. Debug and Release). If no configuration is provided in the plugin's configuration section of the pom.xml it defaults to the values provided in the defaultAppConfigurations or defaultLibConfigurations parameters
defaultAppConfigurations String 1.2.0 Comma separated list of the default Xcode build configurations that should be built for apps (in contrast to libraries). These values only apply if no "configurations" are explicitly provided in the POM.
Default value is: Release,Debug.
defaultAppSdks String 1.2.0 Comma separated list of the default Xcode SDKs that should be used for apps (in contrast to libs). These values only apply if no "sdks" are explicitly provided in the POM.
Default value is: iphoneos,iphonesimulator.
defaultLibConfigurations String 1.2.0 Comma separated list of the default Xcode build configurations that should be built for libraries (in contrast to apps). These values only apply if no "configurations" are explicitly provided in the POM.
Default value is: Release,Debug.
defaultLibSdks String 1.2.0 Comma separated list of the default Xcode SDKs that should be used for libraries (in contrast to apps). These values only apply if no "sdks" are explicitly provided in the POM.
Default value is: iphoneos,iphonesimulator.
defaultxcconfig String 1.14.5 For simple application central team manages the xcconfig. This will be managed in settings.xml
options Map 1.6.2 Options to pass to XCode - if any are explicitly defined here, this plugin will not provide default options to XCode.
productName String - (no description)
provisioningProfile String 1.2.1 Can be used to override the provisioning profile defined in the Xcode project target. You can set it to an empty String if you want to use the default provisioning profile.
sdks Set - Explicit lists of sdks (iphoneos,iphonesimulator) the Xcode project shall be built for. If no configuration is provided in the plugin's configuration section of the pom.xml it defaults to the values provided in the defaultAppSdks or defaultLibSdks parameters
settings Map 1.6.2 Settings to pass to XCode - if any are explicitly defined here, this plugin will not provide default settings to XCode.
skip boolean 1.9.3 Parameter, which controls the verification goal execution. By default, the verification goal will be skipped.
Default value is: true.
symRootDir String 1.14.4 Allowed developers to override the SYMROOT settings
Default value is: build.
target String 1.4.1 The Xcode target to be built. If not specified, the default target (the first target) will be built.
watchapp String 1.14.3 (no description)
xcconfigDir String 1.14.5 Allowed developers to override the xcconfig settings through pom.xml Signing methodology has been changed with xcode8 onwards, to enable this we are expecting dev to give singing related parameters This is only for the Apps with Entitlements like Push notification, Wallet etc...
xcodeCompileDirectory File - The xcode directory of the copied sources below the checkout directory.

Parameter Details

buildActions:

The Xcode build action to to execute (e.g. clean, build, install). By default clean and build are executed.
  • Type: java.util.List
  • Required: No

checkDefinitionFile:

The location where the check definition file is present. Could be a file on the local file system or a remote located file, accessed via http or https.
Examples:
  • -Dxcode.verification.checks.definitionFile=file:./checkDefinitionFile.xml
  • -Dxcode.verification.checks.definitionFile=http://example.com/checkDefinitionFile.xml
  • -Dxcode.verification.checks.definitionFile=https://example.com/checkDefinitionFile.xml
  • Type: java.lang.String
  • Since: 1.9.3
  • Required: No
  • Expression: ${xcode.verification.checks.definitionFile}

checkoutDirectory:

The original Xcode sources located in the src/xcode directory stay untouched during the whole Maven build. However, as we might have to modify the info.plist or the project itself we copy the whole Xcode source directory during the build into another "checkout" directory that by default named checkout and located below the Maven build ( target) directory.
  • Type: java.io.File
  • Required: No
  • Expression: ${xcode.checkoutDirectory}

codeSignIdentity:

The code sign identity is used to select the provisioning profile (e.g. iPhone Distribution, iPhone Developer).
  • Type: java.lang.String
  • Since: 1.2.0
  • Required: No
  • Expression: ${xcode.codeSignIdentity}

codeSigningRequired:

The code signing required is used to disable code signing when no developer provisioning certificate is available (e.g. NO, YES).
  • Type: boolean
  • Since: 1.14.1
  • Required: No
  • Expression: ${xcode.codeSigningRequired}
  • Default: true

configurations:

The Xcode configurations that shall be built (e.g. Debug and Release). If no configuration is provided in the plugin's configuration section of the pom.xml it defaults to the values provided in the defaultAppConfigurations or defaultLibConfigurations parameters
  • Type: java.util.Set
  • Required: No

defaultAppConfigurations:

Comma separated list of the default Xcode build configurations that should be built for apps (in contrast to libraries). These values only apply if no "configurations" are explicitly provided in the POM.
  • Type: java.lang.String
  • Since: 1.2.0
  • Required: No
  • Expression: ${xcode.app.defaultConfigurations}
  • Default: Release,Debug

defaultAppSdks:

Comma separated list of the default Xcode SDKs that should be used for apps (in contrast to libs). These values only apply if no "sdks" are explicitly provided in the POM.
  • Type: java.lang.String
  • Since: 1.2.0
  • Required: No
  • Expression: ${xcode.app.defaultSdks}
  • Default: iphoneos,iphonesimulator

defaultLibConfigurations:

Comma separated list of the default Xcode build configurations that should be built for libraries (in contrast to apps). These values only apply if no "configurations" are explicitly provided in the POM.
  • Type: java.lang.String
  • Since: 1.2.0
  • Required: No
  • Expression: ${xcode.lib.defaultConfigurations}
  • Default: Release,Debug

defaultLibSdks:

Comma separated list of the default Xcode SDKs that should be used for libraries (in contrast to apps). These values only apply if no "sdks" are explicitly provided in the POM.
  • Type: java.lang.String
  • Since: 1.2.0
  • Required: No
  • Expression: ${xcode.lib.defaultSdks}
  • Default: iphoneos,iphonesimulator

defaultxcconfig:

For simple application central team manages the xcconfig. This will be managed in settings.xml
  • Type: java.lang.String
  • Since: 1.14.5
  • Required: No
  • Expression: ${xcode.xcconfig.default}

options:

Options to pass to XCode - if any are explicitly defined here, this plugin will not provide default options to XCode.
  • Type: java.util.Map
  • Since: 1.6.2
  • Required: No

productName:

(no description)
  • Type: java.lang.String
  • Required: No
  • Expression: ${product.name}

provisioningProfile:

Can be used to override the provisioning profile defined in the Xcode project target. You can set it to an empty String if you want to use the default provisioning profile.
  • Type: java.lang.String
  • Since: 1.2.1
  • Required: No
  • Expression: ${xcode.provisioningProfile}

sdks:

Explicit lists of sdks (iphoneos,iphonesimulator) the Xcode project shall be built for. If no configuration is provided in the plugin's configuration section of the pom.xml it defaults to the values provided in the defaultAppSdks or defaultLibSdks parameters
  • Type: java.util.Set
  • Required: No

settings:

Settings to pass to XCode - if any are explicitly defined here, this plugin will not provide default settings to XCode.
  • Type: java.util.Map
  • Since: 1.6.2
  • Required: No

skip:

Parameter, which controls the verification goal execution. By default, the verification goal will be skipped.
  • Type: boolean
  • Since: 1.9.3
  • Required: No
  • Expression: ${xcode.verification.checks.skip}
  • Default: true

symRootDir:

Allowed developers to override the SYMROOT settings
  • Type: java.lang.String
  • Since: 1.14.4
  • Required: No
  • Expression: ${xcode.symroot}
  • Default: build

target:

The Xcode target to be built. If not specified, the default target (the first target) will be built.
  • Type: java.lang.String
  • Since: 1.4.1
  • Required: No
  • Expression: ${xcode.target}

watchapp:

(no description)
  • Type: java.lang.String
  • Since: 1.14.3
  • Required: No
  • Expression: ${xcode.watchapp}

xcconfigDir:

Allowed developers to override the xcconfig settings through pom.xml Signing methodology has been changed with xcode8 onwards, to enable this we are expecting dev to give singing related parameters This is only for the Apps with Entitlements like Push notification, Wallet etc...
  • Type: java.lang.String
  • Since: 1.14.5
  • Required: No
  • Expression: ${xcode.xcconfig}

xcodeCompileDirectory:

The xcode directory of the copied sources below the checkout directory.
  • Type: java.io.File
  • Required: No
  • Expression: ${xcode.compileDirectory}