README.md

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
• Sparkle

Requirements

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

Current stable version is 0.10.2

0.9.15 and 0.10.1 supports Xcode 5, Xcode 6 and Xcode 6.1

Note:

When you use gradle 1.x you you can use version 0.10.2-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:

buildscript {
  repositories {
    maven {
      url('http://openbakery.org/repository/')
    }
    mavenCentral()
  }
  dependencies {
    classpath group: 'org.openbakery', name: 'xcodePlugin', version: '0.10.+'
  }
}
apply plugin: 'xcode'

xcodebuild {
  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 or gradle
• 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).