Requirements
Gradle 2.5 only
Android NDK r10e (if you are using NDK)
SDK with Build Tools at least version 19.0.0 and we aim to minimize the amount of changes needed for the migration process in the future. Some features may require a more recent version.
Migrating from Traditional Android Gradle Plugin
A typical Android Studio project may have a directory structure as follows. File that needs to be change is highlighted in red:
There are some significant changes in the DSL between the new plugin and the traditional one.
.
├── app/
│ ├── app.iml
│ ├── build.gradle
│ └── src/
├── build.gradle
├── gradle/
│ └── wrapper/
│ ├── gradle-wrapper.jar
│ └── gradle-wrapper.properties
├── gradle.properties
├── gradlew*
├── gradlew.bat
├── local.properties
├── MyApplication.iml
└── settings.gradle
./gradle/wrapper/gradle-wrapper.properties
The new plugin supports only gradle-2.5.
#Wed Apr 10 15:27:10 PDT 2013
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-2.5-all.zip
./build.gradle
Classpath for the plugin is com.android.tools.build:gradle-experimental instead of com.android.tools.build:gradle.
The current version is 0.2.0.
// Top-level build file where you can add configuration options common to all sub-projects/modules.
buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle-experimental:0.2.0'
// NOTE: Do not place your application dependencies here
// in the individual module build.gradle files
}
}
allprojects {
repositories {
jcenter()
}
}
./app/build.gradle
There are significant changes to the DSL of the plugin. We understand that many of the changes are frustrating and seem unnecessary, and our goal is to remove some of these current changes to minimize the migration process from the traditional plugin in the future.
DSL Changes:
Plugin name is com.android.model.application instead of com.android.application. Or useapply plugin: 'com.android.model.library'if you want to create an Android aar library.
Configuration is wrapped with the model { } block
Most properties require the = operator
Adding elements to a Collection should be done using the += operator.
Current DSL Limitations that will hopefully go away:
buildTypes, productFlavors and signingConfigs must be place outside of the android { } block.
Nested options within the android { } block must be configured using the with keyword.
Properties are only set with their direct types only, with no way to accept other types and adapting them. For instance:
Properties of type File accepts only File instead of File and String objects.
minSdkVersion cannot directly receive either an integer or string (for codename).
Creating a buildType or productFlavor requires calling the create method. Modifying an existing one such as the release and debug buildType can be done using the just the name.
The DSL for modifying variants and their tasks is very, very limited right now.
apply plugin: 'com.android.model.application'
model {
android {
compileSdkVersion = 22
buildToolsVersion = "22.0.1"
defaultConfig.with {
applicationId = "com.example.user.myapplication"
minSdkVersion.apiLevel = 15
targetSdkVersion.apiLevel = 22
versionCode = 1
versionName = "1.0"
buildConfigFields.with {
create() {
type = "int"
name = "VALUE"
value = "1"
}
}
}
}
android.buildTypes {
release {
minifyEnabled = false
proguardFiles += file('proguard-rules.pro')
}
}
android.productFlavors {
create("flavor1") {
applicationId = ‘com.app’
}
}
// Configures source set directory.
android.sources {
main {
java {
source {
srcDir 'src'
}
}
}
}
}
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
compile 'com.android.support:appcompat-v7:22.2.0'
}
Ndk Integration
The experimental plugin comes with NDK integration for creating native applications. To use the NDK integration:
Use the SDK Manager inside Studio to download the NDK.
Set ndk.dir in local.properties or the ANDROID_NDK_HOME environment variable to the directory containing the NDK.
Add an android.ndk block to the model in build.gradle.
Known Limitations
There’s no support for NDK-only modules. The only supported project types are hybrid app projects and hybrid Library Projects.
Consumed Library project don’t impact compilation of jni code in the consuming project (ie the AAR so files are simply packaged in the APK)
No support for creating and depending on static libraries
No support for using a NDK modules like cpu_features
No support for integrating external build systems.
The build.gradle of a simple NDK application may look like this:
Vim
apply plugin: 'com.android.model.application'
model {
android {
compileSdkVersion = 22
buildToolsVersion = "22.0.1"
}
android.ndk {
moduleName = "native"
}
}
1
2
3
4
5
6
7
8
9
10
11
applyplugin:'com.android.model.application'
model{
android{
compileSdkVersion=22
buildToolsVersion="22.0.1"
}
android.ndk{
moduleName="native"
}
}
*Note that themoduleName is required. It determines the name of the resulting native library.
By default, it will look in src/main/jni for C/C++ file. Configure android.sources to change the source directory.
Vim
model {
android {
compileSdkVersion = 22
buildToolsVersion = "22.0.1"
}
android.ndk {
moduleName = "native"
}
android.sources {
main {
jni {
source {
srcDir 'src'
}
}
}
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
model{
android{
compileSdkVersion=22
buildToolsVersion="22.0.1"
}
android.ndk{
moduleName="native"
}
android.sources{
main{
jni{
source{
srcDir'src'
}
}
}
}
}
Various build options can be set within the android.ndk { } block. For example,
Vim
model {
android {
compileSdkVersion = 22
buildToolsVersion = "22.0.1"
}
android.ndk {
// All configurations that can be changed in android.ndk.
moduleName = "native"
toolchain = "clang"
toolchainVersion = "3.5"
// Note that CFlags has a capital C, which is inconsistent with
// the naming convention of other properties. This is a
// technical limitation that will be resolved
CFlags += "-DCUSTOM_DEFINE"
cppFlags += "-DCUSTOM_DEFINE"
ldFlags += "-L/custom/lib/path"
ldLibs += "log"
stl = "stlport_static"
}
android.buildTypes {
release {
ndk.with {
debuggable = true
}
}
}
android.productFlavors {
create("arm") {
ndk.with {
// You can customize the NDK configurations for each
// productFlavors and buildTypes.
abiFilters += "armeabi-v7a"
}
}
create("fat") {
// If ndk.abiFilters is not configured, the application
// compile and package all suppported ABI.
}
}
// You can modify the NDK configuration for each variant.
components.android {
binaries.afterEach { binary ->binary.mergedNdkConfig.cppFlags.add("-DVARIANT=\"" + binary.name + "\"")}
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
model{
android{
compileSdkVersion=22
buildToolsVersion="22.0.1"
}
android.ndk{
//Allconfigurationsthatcanbechangedinandroid.ndk.
moduleName="native"
toolchain="clang"
toolchainVersion="3.5"
//NotethatCFlagshasacapitalC,whichisinconsistentwith
//thenamingconventionofotherproperties.Thisisa
//technicallimitationthatwillberesolved
CFlags+="-DCUSTOM_DEFINE"
cppFlags+="-DCUSTOM_DEFINE"
ldFlags+="-L/custom/lib/path"
ldLibs+="log"
stl="stlport_static"
}
android.buildTypes{
release{
ndk.with{
debuggable=true
}
}
}
android.productFlavors{
create("arm"){
ndk.with{
//YoucancustomizetheNDKconfigurationsforeach
//productFlavorsandbuildTypes.
abiFilters+="armeabi-v7a"
}
}
create("fat"){
//Ifndk.abiFiltersisnotconfigured,theapplication
//compileandpackageallsuppportedABI.
}
}
//YoucanmodifytheNDKconfigurationforeachvariant.
components.android{
binaries.afterEach{binary->binary.mergedNdkConfig.cppFlags.add("-DVARIANT=\""+binary.name+"\"")}
}
}
Samples
Additional samples can be found at https://github.com/googlesamples/android-ndk.
对于不能正常访问GitHub的,可以点击这里下载最近保存的版本。