• Extensibility / Customization / Stable APIs
• Unified across CI Servers and IDEs
• Standart and advanced features

• Current solutions (aka Ant, Maven) are not ideal

• Powerful Build System
  • Declarative, Flexible
  • Imperative customization
  • Tooling API

• Build System Toolkit
  • Plugins create own DSL, APIs, IDE integration

• Free / Open Source

           
apply plugin: 'java'






        

           
buildscript {
    repositories { mavenCentral() }
    dependencies { classpath 'com.android.tools.build:gradle:0.5.+' }
}

apply plugin: 'android'


android {
    compileSdkVersion 17
    buildToolsVersion: '17.0.0'
}
            
        

           
android {
    sourceSets {
        main {
            manifest.srcFile 'AndroidManifest.xml'
            java.srcDirs ['src']
            res.srcDirs ['res']
        }
        
        instrumentTest.setRoot('tests')
    }
}
        

           
android {
    sourceSets {
        main {
            manifest.srcFile 'AndroidManifest.xml'
            java.srcDirs ['src']
            res.srcDirs ['res', 'res2']
        }
        
        instrumentTest.setRoot('tests')
    }
}
        

assemble


check




build
  -> assemble + check

clean

android {
    defaultConfig {
        versionCode 12
        versionName '2.0'
        
        minSdkVersion 14
        targetSdkVersion 17
    }
}
            

def getVersionCode() {
    def code = ...
    return code
}

android {
    defaultConfig {
        versionCode getVersionCode()
        ...
    }
}
            

• Build/Packaging customization
  • debuggable flag
  • ProGuard
  • signing configuration
  • src/res overlays

• Debug and release prebuild

android {
    buildTypes {
        debug {
            packageNameSuffix '.debug'
            versionNameSuffix '-DEBUG'
        }
        beta {
            ...
        }   
    }
}
            

android {
    signingConfigs {
        debug {
            storeFile file('debug.keystore')
        }
        
        // buildTypes.debug already configured
        // to use signingConfigs.debug
    }
}
            

android {
    buildTypes {
        debugRelease.initWith(buildTypes.release)
        debugRelease {
            debuggable true
            packageNameSuffix '.debugrelease'
            signingConfig signingConfig.debug
        }
        sourceSets.debugRelease.setRoot('src/release')
    }
}
            

android {
    ...
}

android.buildTypes.each { 
    type -> type.packageNameSuffix = ".$type.name"
}

            

dependencies {
    compile fileTree(dir: 'libs', include '*.jar')
}

android {
    ...
}
            

repositories { mavenCentral() }

dependencies {
    compile 'com.actionbarsherlock:actionbarsherlock:4.3.1'
    betaCompile file('libs/protobuf.jar')
}

android {
    ...
}
            

dependencies {
    compile project(':libs:lib1')
}

android {
    ...
}
            

buildscript {
    repositories { mavenCentral() }
    dependencies { classpath 'com.android.tools.build:gradle:0.4' }
}

apply plugin: 'android-library'

android {
    compileSdkVersion 17
    buildToolsVersion: '17.0.0'
}
            

• Binary Bundle (.aar)
  • Uploadable to repositories

• Support for
  • assets
  • ProGuard rules
  • Common Lint rules
  • ...

• Different versions of the same application
  • Paid vs Free
  • Multi .apk support in Google Play

• Different Dimension(s) than Build Types

android {
    productFlavors {
        flavor1 {
            packageName 'com.example.flavor1'
            minSdkVersion 14
        }
        flavor2 {
            packageName 'com.example.flavor2'
        }
    }
}
            

android {
    flavorGroups 'abi', 'version'
    productFlavors {
        arm {
            flavorGroup 'abi'
        }
        paid {
            flavorGroup 'version'
            packageName '.paid'
        }
    }
}
            

Multiple Source Folders, Single Output

Overlays

Priority Order

• Test Source Sets: src/instrumentTest, src/instrumentTestFlavor1


• Dependency Scopes: instrumentTestCompile, instrumentTestFlavor1Compile


• Genearated AndroidManifest.xml


• Only one Build Type is tested


• Library embedded into Test APK

• check


• connectedCheck


• deviceCheck

• Delayed / Queuded tests
  • Upload APKs to service
  • Queued tests
  • Remote report/dashboard
  
  
• Test server API
  • Upload APKs method
  • Plugin register itself to the android plugin
  • Support any number of Servers

• Devices Available on-demand
  • Direct connection to device
  • Local / Cloud emulators
  • Local report / dashboard
  
  
• DeviceProvider / DeviceConnector API
  • Return list of DeviceConnectors
  • Connect, install, run tests, uninstall on each device
  • Support of any number of Providers

• Gradle Version
  • Use the Wrapper!
  
  
• Plugin Version
  • 'com.android.tools.buid:gradle:0.5'
  
  
• Build Tools Version
  • android.buildToolsVersion '17.0'
  
  
• IDE is not responsible for Builds

• Android Plugin User Guide
• Gradle Documentation
• Book: Building and Testing with Gradle
• Hans Dockter, Gradle for Android