1、理解根目录下的build.gradle
在使用Android Studio创建工程时,会在根目录创建类似如下的build.gradle。本文将从初学者的角度来解释每一行的意思,具体的细节还需查看gradle的API文档。
如果要学习gradle,推荐一篇写得很好的blog深入理解Android之Gradle。个人认为最重要的一点是不要把build.gradle简单地看作配置文件,而是要把它看作一种编程框架,使用其API或者Groovy编程语言来完成编译、打包、测试等工作。
以下的注释为每一行代码的意思,希望对理解build.gradle有所帮助。
// Top-level build file where you can add configuration options common to all sub-projects/modules.
// Gradle中可以使用“//”或“/**/”来添加注释,与Java类似。
// 根目录下的build.gradle用于添加子工程或模块共用的配置项。
// "buildscript"的类型为script block,而且是最上层的script block,用于配置Gradle的Project实例。其API文档为https://docs.gradle.org/current/dsl/org.gradle.api.Project.html#org.gradle.api.Project:buildscript(groovy.lang.Closure)
// 其余的根script block有"allprojects", "dependencies", "configurations"等,更多的可见https://docs.gradle.org/current/dsl/的“Build script structure”一节。
// Script Block是一种method的调用,传入的参数为configuration closure。执行后会对Project的属性进行配置。
// 此处的"buildscript"用于配置Project的build script的classpath。
buildscript {
// 如果需要的话,从https://jcenter.bintray.com/下载code reposities。
repositories {
jcenter()
}
// 定义classpath,gradle会从“repositories”中下载对应版本的Gradle。如果使用gradle wrapper的话,感觉这个配置会被忽略。Wrapper会自己去下载所使用的gradle版本。
dependencies {
classpath 'com.android.tools.build:gradle:2.1.3'
// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files
}
}
// 该配置会被应用到所有的子工程。
allprojects {
repositories {
jcenter()
}
}
// 运行gradle clean时,执行此处定义的task。
// 该任务继承自Delete,删除根目录中的build目录。
// 相当于执行Delete.delete(rootProject.buildDir)。
// gradle使用groovy语言,调用method时可以不用加()。
task clean(type: Delete) {
delete rootProject.buildDir
}
2、Android Studio gradle 文件中 ${supportLibVersion} 用法
一般我们在项目中的gradle会添加如下库文件:
dependencies {
compile 'com.android.support:appcompat-v7:23.1.0'
compile 'com.android.support:design:23.1.0'
compile 'com.android.support:pallete-v7:23.1.0'
compile 'com.android.support:cardview-v7:23.1.0'
compile 'com.android.support:recyclerview-v7:23.1.0'
}
所以每次升级的时候都要修改后面的23.1.0版本号,Android开发小组的Chris Banes想出了这样的一个方法,不用每次修改每个版本,而只需要修改一次就行了,如下:
ext {
supportLibVersion = "23.1.1"
}
dependencies {
compile "com.android.support:appcompat-v7:${supportLibVersion}"
compile "com.android.support:design:${supportLibVersion}"
compile "com.android.support:recyclerview-v7:${supportLibVersion}"
compile "com.android.support:cardview-v7:${supportLibVersion}"
}
错误的写法:
compile 'com.android.support:appcompat-v7:${supportLibVersion}'
正确的写法:
compile "com.android.support:appcompat-v7:${supportLibVersion}"
3、依赖包冲突解决办法
项目中使用的library版本是23,但是项目引用的包引用的library版本是24,这样就会出现冲突,报错如下:
解决办法,使用exclude,排除冲突的依赖包:
compile ('com.bat:apploginsdk:1.0.1') {
// exclude module : 'okhttp'
// exclude module : 'com.android.support'
exclude group: 'com.android.support', module: 'recyclerview-v7'
exclude group: 'com.android.support', module: 'support-v4'
exclude group: 'com.android.support', module: 'design'
exclude group: 'com.android.support', module: 'appcompat-v7'
}
参考致谢:
(1)、理解根目录下的build.gradle
(2)、gradle 基本配置介绍
(3)、Gradle配置
(4)、Gradle常见配置结点
(5)、理解与配置Android studio中的gradle