Gradle的Properties

Wed, 23 Jul 2014 00:00:00 +0000

问题背景

团队一起在开发一个Android项目，工程师有的使用Eclipse，有个使用Intellij IDEA，有的使用Android Studio。每个人安装的Android SDK build-tools可能都不一样，有的是19.0.3，有的是19.1.0，不同版本的build-tools对Gradle Plugin也有相应的要求，如19.0.3对应的是com.android.tools.build:gradle:0.10.+，19.1.0对应的是com.android.tools.build:gradle:0.12.+，下面是一个典型的build.gradle配置文件。

buildscript {
 repositories {
 mavenCentral()
 }

 dependencies {
 classpath 'com.android.tools.build:gradle:0.10.+'
 }
}

apply plugin: 'android-library'

android {
 compileSdkVersion 19
 buildToolsVersion 19.0.3

 defaultConfig {
 minSdkVersion 8
 targetSdkVersion 19
 }
}

在合作开发中遇到的一个尴尬的问题是，IDEA最新版还不能很好的支持Gradle Plugin 0.12+，而Android Studio最新版则要求使用0.12+。大家又共用一个Git仓库。可能的解决方案是，从Git checkout出来的项目需要有一个基础的版本号，但是开发者可以在本地通过一处文件（不check in到git）来重载版本号。

解决方案

Gradle支持三种Properties, 这三种Properties的作用域和初始化阶段都不一样，下面分别列出了其部分特点。:

System Properties：
1. 可通过gradle.properties文件，环境变量或命令行-D参数设置 2. 可在setting.gradle或build.gradle中动态修改，在setting.gradle中的修改对buildscript block可见；
2. 所有工程可见，不建议在build.gradle中修改
3. 多子工程项目中，子工程的gradle.properties会被忽略掉，只有root工程的gradle.properties有效；
Project Properties：
1. 可通过gradle.properties文件，环境变量或命令行-P参数设置，优先级是:
2. 可在build.gradle中动态修改，但引用不存在的project properties会立即抛错
3. 动态修改过的project properties在buildscript block中不可见
Project ext properties：
1. 可在项目的build.gradle中声明和使用，本工程和子工程可见
2. 不能在setting.gradle中访问

如果有多处设置，加载次序如下（注意：gradle 2.0是这样的, 1.10~1.12有bug）, 后面的覆盖前面的设置

from gradle.properties located in project build dir.
from gradle.properties located in gradle user home.
from system properties, e.g. when -Dsome.property is used in the command line.
setting.gradle
build.gradle

根据其特点，这里给出一个使用System Properties来解决问题的方案。

Gradle on All about Raspberry Pi

Gradle的Properties

问题背景

解决方案