第八章 gradle自动化构建系列文章 之 gradle中的属性

查看 “Android自动化构建系列” 全部文章

gradle属性定义概要

在gralde项目中，每个project都会对应一个build.gradle 文件，编译过程中 build.gradle 都会被编译为 .project字节码，所有的脚本gradle文件最终会被编译器编译成 .script字节码,因此所有的脚本相当于在一个project类中书写的

上面是

gradle

中

project

类的源代码，主要定义了一下的语法规范

名称	解释	备注
build.gradle	工程默认的配置文件读取路径	每个项目都会有包括根项目和子项目
:	gralde工程中工程或者任务的分隔符	所有操作系统中通用
build	存放每个工程的产出	每个项目对应自己的一个
gradle.property

项目演变改造

通过前几个部分的接触我们发现 gradle不是一个简单的脚本而是一个完整的编程框架，如果我们还是以脚本的特征看待未免显得太低端了，本着学以致用我们应该一步步的改进我们的项目

在学习gradle之前我的项目是这样的，在工程的 build.gradle 文件中我只会写字符串和值得配置

上面这样配置本身没有什么问题，只是分类不明确，就像杂乱的文件夹里面存放着杂乱的属性，不利于代码的统一管理和维护

还有一个更致命的缺陷，当我们的项目变动需要更改依赖配置或者依赖配置的时候，我们需要手动的对每个项目的gradle.build文件更改，工作你量大，效率低而且很容易出错，导致打包失败

因为原有的方案不完美，我们要对项目进行演变

1. 使用 ext{} 定义扩展属性

我们可以在项目中定义ext扩展属性，并且在项目中直接引用，如下图

//定义扩展属性
	ext {
	    mMinSdkVersion = 16
	    mTargetSdkVersion = 26
	    mVersionCode = 1
	    mVersionName ="1.0"
	}
	
	android {
	    compileSdkVersion 26
	    buildTypes {
	        defaultConfig {
	            applicationId "com.example.demomore"
	
	            minSdkVersion this.mMinSdkVersion
	            targetSdkVersion this.mTargetSdkVersion
	            versionCode this.mVersionCode
	            versionName this.mVersionName
		}
	}
           

上面的扩展属性是定义在一个工程文件中的，实际开发项目必然包含非常多的库工程，替换依赖文件的时候我们不可能逐个修改，太费时间而且非常容易出错，导致无法打包

进一步演变，既然子工程可以获取

rootProject

那我们也可以获取

rootProject

定义的扩展属性， 于是我们可以在

rootProject

定义公共的扩展属性，在子 project中使用

1. 在rootproject 中定义扩展属性

2. 在子 project中直接引用这些属性

备注：其实我们是可以这样简化书写的

这样使用的原因很简单，gradle 规定父project的所有属性都是可以被子project继承的，可以在子project中直接使用

编译依旧完美，同样完成了我没想要的效果

在进一步演化，我们完成最终的版本（通过引入gradle文件的方式完成）

1. 在项目的根工程或子工程位置定义xxx.gradle文件

2. 在这个文件中定义配置数据等，比如可以使用数组的形式，每个部分定义一个数组

//用来存放项目中的所有配置，统一管理而不是每个moudle自己写一份，
// 修改起来更加方便
ext {
    android = [compileSdkVersion: 25,
               buildToolsVersion: '25.0.3',
               minSdkVersion    : 17,
               targetSdkVersion : 22,
               versionCode      : 1,
               versionName      : "1.0.0"]

    signingConfigs = [storeFile    : "electicPowerAppKey.jks",
                      storePassword: "123456789",
                      keyAlias     : "ElecticPower",
                      keyPassword  : "123456789"]
    java = [sourceCompatibility: JavaVersion.VERSION_1_7,
            targetCompatibility: JavaVersion.VERSION_1_7]
    dependencies = [multidex    : "com.android.support:multidex",
                    gson        : "com.google.code.gson:gson:2.8.0",
                    okhttp      : "com.squareup.okhttp3:okhttp:3.9.0",
                    recyclerview: "com.android.support:recyclerview-v7:25.4.0"]
}
           

• 效如下

  

3. 在rootProject中引入这个gradle文件，基本类似c的

include

或java的

import

apply from: this.file("common.gradle")
           

• apply from:file(String path)

  默认会从调用的项目位置向子项目中查找，直到找到这个gradle文件，如果找不到会报错 not found ，修改一下路径直到找到这个文件就可以了

4. 在需要完成配置的子项目中配置应用我们完成的调用

• 执行编译完美运行

总结： 通过上面的演化，我们实现了功能分离，当我们想要项目中的依赖库文件升级的时候我们只需要修改 common.gradle 文件

2. 通过gradle.properties定义扩展属性

1. 在文件 property文件中定义操作属性（注意只支持键值对方式的定义）

2. 在setting.gradle中这样使用

if(hasProperty("isLoadMyLibrary")?isLoadMyLibrary.toBoolean():false){
	include ':mylibrary'
}
           

注意，我们这属性有可能回去不到，我们使用 hasproperty判断属性的存在与否

直接用属性获取的值时object类型的，需要我们转换成我们需要的类型

当然我们还可以将SDK相关的属性配置在这个地方,然后可以在这个项目工程中去使用

android {
	//注意，如果定义属性的名称在这个项目工程中已经存在，那么定义将会失败，报错属性找不到
	compileSdkVersion mCompileSdkVersion.toInteger()
	....
}
           

查看 “Android自动化构建系列” 全部文章