1. 什么是Gradle?
Gradle 是一个基于Ant和Maven概念的项目自动化建构工具。
2. Gradle 基本概念
下图是很基本的Android Gradle工程,目录结构也是正常的Gradle工程的样式。下载地址
2.1 StudyGradle/build.gradle(图标1)
这个文件是整个项目的gradle基础配置文件:
buildscript {// 脚步运行环境
repositories {// 用于项目依赖
// 中央远程仓库
jcenter()
}
dependencies {
// gradle版本
classpath'com.android.tools.build:gradle:1.2.3'
// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files
}
}
allprojects {
repositories {
jcenter()
}
}
这里主要描述了两个方面:
1. gradle 版本
2. 仓库的源地址
2.2 StudyGradle/app/build.gradle(图标2)
这个文件是Module名称为app的gradle的配置文件,在此项目中是主要的gradle配置文件。
//声明插件类型,这里声明的是Android程序
apply plugin:'com.android.application'
android {
//编译SDK的版本
compileSdkVersion22
//build tools 的版本 对应Android SDK Build-tools
buildToolsVersion"21.1.2"
defaultConfig {
//应用包名
applicationId"com.example.dpt.studygradledemo"
minSdkVersion21
targetSdkVersion22
versionCode1
versionName"1.0"
}
buildTypes {//构建类型,常用的有release和debug两种,可以在这里面启用混淆,启用zipAlign以及配置签名信息等
release {
//是否进行混淆
minifyEnabled false
//混淆文件位置
proguardFiles getDefaultProguardFile('proguard-android.txt'),'proguard-rules.pro'
}
}
// 移除lint检查的error
lintOptions {
abortOnError false
}
}
dependencies {
// 编译依赖libs目录下的所有jar包
compile fileTree(dir:'libs', include: ['*.jar'])
// //应用格式: packageName:artifactId:version
// 依赖 support-v4
compile'com.android.support:support-v4:22.2.0'
// 依赖 card view
compile'com.android.support:cardview-v7:22.2.0'
// 依赖 library module
compile project(':demolibrary')
compile'com.android.support:palette-v7:22.2.0'
}
ps:
1. 开头第一行apply plugin: ‘com.android.application’,这表示该module是一个app module,应用了com.android.application插件,如果是一个android library,那么这里的是apply plugin: ‘com.android.library’。'com.android.application'是较新的写法,但不是最新的写法。
2. buildToolsVersion 对应Android SDK Build-tools的版本,如图
2.2.1 buildTypes{}
buildTypes是构建类型,常用的有release和debug两种,可以在这里面启用混淆,启用zipAlign以及配置签名信息等。
2.2.2 defaultConfig{}
这里描述的是一些项目基础默认配置
常用的属性有:versionCode,versionName,minSdkVersion,targetSdkVersion,applicationId等
2.2.3 dependencies{}
dependencies就不属于Android专有的配置了,它定义了该module需要依赖的jar,aar,jcenter库信息。
1. compile fileTree(dir: 'libs', include: ['*.jar']) 编译依赖libs目录下的所有jar包
2. compile 'com.android.support:support-v4:22.2.0' 依赖 support-v4
3. compile project(':demolibrary') 依赖其他module
ps:
其中依赖开源组件的格式为:packageName:artifactId:version 例如,compile 'com.android.support:support-v4:22.2.0'
StudyGradle/demolibrary/build.gradle(图标2)
这个是一个依赖库的module配置文件
//声明Android library
apply plugin:'com.android.library'
android {
//编译SDK版本
compileSdkVersion22
//build tools 的版本 对应Android SDK Build-tools
buildToolsVersion"21.1.2"
defaultConfig {
minSdkVersion21
targetSdkVersion22
versionCode1
versionName"1.0"
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'),'proguard-rules.pro'
}
}
}
dependencies {
compile fileTree(dir:'libs', include: ['*.jar'])
}
ps:
1. 这里需要注意的是apply plugin 这里声明为Android library
2.3 StudyGradle/build.gradle(图标3)
这个文件是全局的项目配置文件,里面主要声明一些需要加入gradle的module
include':app',':demolibrary'
2.4 Gradle Wrapper(图标4)
android studio希望你能在电脑上不安装gradle的情况下,依然使用gradle管理android项目,因此通过AS创建的每个项目都会内嵌一个gradle wrapper,作用是检查你当前的共工作环境是否安装了创建本项目时所用的gradle版本。
如果没有,它会自动下载相应的gradle放在~/.gradle/wrapper.目录下。这样当你在你的项目里使用gradle时,可以通过gradlw命令使用当前项目环境的gradle版本,而不受环境变量的影响。
很多人会遇到一个项目build很久,很大一部分原因就是因为这个,他会去下载自带的gradle wrapper,50多M,大部分情况下需要翻墙
如果不能翻墙,也可以更改**gradle-wrapper.properties**的配置
1
2
3
4
5distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-2.2.1-all.zip
3. 打包
3.1 Gradle Flavor
写项目的时候经常会遇到以下的情况:
1. 需要生成测试版本和正式版本的apk
2. 测试版本和正式版本的URL是不一样的
3. 测试版本和正式版本的包名需要不一致,这样才能安装到同一部手机上面。
4. 不同apk需要应用名不同,图标不同,某些常量不同....
>通过Productflavor你可以配置此flavor对应的包名,签名信息,版本名, 版本号等,具体可配置项可以到这里[查看](http://apdr.qiniudn.com/com.android.build.gradle.internal.dsl.ProductFlavor.html)。
productFlavors{
max1 {
applicationId"com.example.dpt.gradle.max1"
}
x1 {
applicationId"com.example.dpt.gradle.x1"
}
}
输出所有apk
1
./gradlewassemble
输出任意flavor
1
./gradlewassembleX1
> 生成的apk在StudyGradle/app/build/outputs/apk/目录下
3.2 简单使用场景
3.2.1 使用不同包名
国内应用市场、渠道众多,更换包名是最简单的需求了
productFlavors{
max1 {
applicationId"com.example.dpt.gradle.max1"
}
x1 {
applicationId"com.example.dpt.gradle.x1"
}
}
3.2.2 buildConfig(控制变量)
Gradle会在产生源码阶段为flavor生成一个BuildConfig.java文件。BuildConfig类默认提供了一些常量字段,比如应用的版本名(VERSION_NAME),应用的包名(PACKAGE_NAME)等。更强大的是,开发者还可以添加自定义的一些字段。
android {
defaultConfig {
//自定义boolean型常量
buildConfigField ('boolean','AUTO_UPLOAD','false')
//自定义String型常量
buildConfigField('String','SERVER_URI','"默认 uri"')
}
productFlavors{
max1 {
applicationId"com.example.dpt.gradle.max1"
//自定义boolean型常量
buildConfigField ('boolean','AUTO_UPLOAD','true')
//自定义String型常量
buildConfigField('String','SERVER_URI','"Max uri"')
//自定义res常量
resValue('string','app_name','MAX')
}
x1 {
applicationId"com.example.dpt.gradle.x1"
//自定义String型常量
buildConfigField('String','SERVER_URI','"X1 uri"')
//自定义res常量
resValue('string','app_name','X1')
}
}
}
3.2.3 这还远远不够
>如果我们想更换大量文案,图标,布局,甚至是不同版本使用有差异的控件怎么办?
可在**src**文件夹下创建同**Flavor**,在里面可以对各种不同的Flavor,编写不同的需求。
在Demo中,两个不同的Flavor在详情页,使用了不同的布局和控件。
![enter image description here](http://7d9pic.com1.z0.glb.clouddn.com/gradle_flavor.png)
具体代码在Demo中的part2,分支