ios-maven-plugin

The ios-maven-plugin plugs in to the Maven build lifecycle to automate compilation and deployment of iOS applications. This enables continuous integration for the iOS platform with ease.

Features

Compilation of iOS applications
Distribution of iOS applications
Versioning of iOS applications
One-step HockeyApp deployment
Packaging of iOS applications (.ipa & .dSYM) for deployment to Nexus/Artifactory

Requirements

The plugin relies on several tools that are only available on Mac OS X: xcodebuild, xcrun and agvtool.
To let ios-maven-plugin take care of versioning, be sure to set 'Versioning System' in the project settings to apple-generic

Maven Goals

ios:build

Compiles the application and generates an IPA package

Parameters

ios.sourceDir
ios.appName
ios.scheme
ios.sdk
ios.codeSignIdentity
ios.configuration
ios.buildId

ios:deploy

Deploys the IPA package as well as the generated dSYM.zip to HockeyApp

Parameters

ios.sourceDir
ios.appName
ios.scheme
ios.sdk
ios.codeSignIdentity
ios.configuration
ios.buildId
ios.hockeyAppToken
ios.releaseNotes

Getting started with ios-maven-plugin and Jenkins

Configure a basic POM for your iOS project or module and add:

<plugin>
    <groupId>com.brewinapps.maven.plugins</groupId>
    <artifactId>ios-maven-plugin</artifactId>
    <version>1.1-SNAPSHOT</version>
    <extensions>true</extensions>                
    <configuration>
        <codeSignIdentity>iPhone Distribution: ACME Inc</codeSignIdentity>
        <appName>AcmeApp</appName>
    </configuration>				                
</plugin>

Compile to verify

mvn clean compile

Allow jenkins to access your keychain

To sign the package, unlock the keychain on the jenkins node. The two commands below can be set up as a pre-build shell script.

security list-keychains -s ~/Library/Keychains/jenkins.keychain
security unlock-keychain -p CHANGEME ~/Library/Keychains/jenkins.keychain

Deploy to HockeyApp

To deploy to HockeyApp add -Dios.hockeyAppToken=YOUR_TOKEN as an argument and invoke mvn ios:deploy.

Tips

ios-maven-plugin sets the CFBundleShortVersionString to the Maven project version by default. You can override this behaviour by adding the -Dios.version argument.
To set CFBundleVersion to the svn revision or git commit add -Dios.buildId=$SVN_REVISION or -Dios.buildId=$GIT_COMMIT respectively.

License

ios-maven-plugin is licensed under the Creative Commons 3.0 License. Details can be found in the file LICENSE.

WARNING: This is a work in progress, use with care.

License

firstim/ios-maven-plugin

ErrorLooks like something went wrong!

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Error
Looks like something went wrong!

Packages