gradle-xcodePlugin

gradle-xcodePlugin makes it easier to build Mac and iOS projects by specifying the build settings in a single configuration file. The goal is to keep the build file as simple as possible, but also enable a great flexibility for the build.

The gradle-xcodePlugin uses the Apple command line tools (like xcodebuild) to perform the build.

Here a brief overview of the features:

Build iOS and Mac projects
Override sign settings for iOS builds
Perform unit tests
Support for multiple Xcodes (on one machine)
Cocoapods support
Appledoc support
Code coverage support (using gcovr )
Hockeykit, HockeyApp, DeployGate , Apple TestFlight
OCLint (Works not with Xcode 7-beta)

Note

With version 0.11 the identifier of the plugin has changed to org.openbakery.xcode-plugin see: https://plugins.gradle.org/plugin/org.openbakery.xcode-plugin

Requirements

Xcode 5 or greater
Gradle 2.0 or greater
Java 1.6 or greater

Current stable version is 0.11.6

0.9.x up to 0.11.x supports Xcode 5, Xcode 6.* and Xcode 7

Note:

When you use gradle 1.x you you can use version 0.10.3-gradle1

Documentation

Parameters Documentation

Usage

Create a build.gradle file and place it in the same directory where xcodeproj file lies.

Here the minimal content you need in your build.gradle file:

plugins {
  id "org.openbakery.xcode-plugin" version "0.11.6"
}

xcodebuild {
  scheme = 'MY-SCHEMA'
  target = 'MY-TARGET'
}

Example

You find example projects in example/ with a working build.gradle file. After you have fetched the example go to the example/iOS/Example directory and you build the project different targets:

Build with gradle xcodebuild
Run the unit tests with gradle test
Perform a device build and upload it to hockeyapp with gradle integration. Here you need to specify your sign settings first (see Signing ). Open the build.gradle file an follow the instructions.
Perform an appstore build with gradle appstore. (Also the sign settings are needed).

Collaborate

I'm always happy to receive pull requests with new features and if you send a pull request please consider the following things:

Use the develop branch for pull requests, because all the new stuff is implemented in the develop branch and also pull requests are always merge into develop
Use Tabs instead of spaces.
Make sure that all unit tests are working before you send the pull request. Just run 'gradle test'
I urge you to write unit tests.
For unit test please use the spock framework for mocking. I want to remove the old gmock framework and port the old tests to use spock.
If a pull request does not contain any unit tests, I always think twice if I should merge it at all.

Ant-Robot / gradle-xcodePlugin