建议先阅读 关于AS中的Gradle
gradle编译过程
- 将源码转化为
DEX文件编译资源文件 -
APK Packager整合DEX文件和资源文件 对apk进行签名 -
APK Packager会使用zipalign工具优化整个app节省内存
自定义编译
Build Types
关于release和debug的配置就在此编译类型中进行
栗子：
android {
...
defaultConfig {...}
buildTypes {
release {
//开启混淆
minifyEnabled true
//混淆规则文件
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
debug {
//apk的后缀
applicationIdSuffix ".debug"
}
//debug的一个扩展
jnidebug {
// 复制debug的属性和签名配置 相当于继承了debug
initWith debug
applicationIdSuffix ".jnidebug"
//开启Jni调试
jniDebuggable true
}
}
}
注意initWith的使用
Product Flavors
此编译类型负责构建不用版本：为每个版本指定不同的applicationid和版本名称
同一套代码可以生成不同的app
applicationid可以理解成包名 作用是给应用商店和不同设备区分不同的app 但是与Manifest中作用不同 Manifest中的作用是用来在源代码中引用R类和其他类
栗子：
android {
...
defaultConfig {...}
buildTypes {...}
productFlavors {
demo1 {
applicationId "com.example.myapp.demo1"
versionName "1.0-demo"
}
demo2 {
applicationId "com.example.myapp.demo2"
versionName "2.0-demo"
}
}
}
上述的配置会生成4个apk 每一种flavor都会对应生成 release 和 debug 版本
Mutiple Manifest Files
合并多个清单文件
项目中可能会存在多个清单文件 这个时候需要将他们进行合并 此时需要定义规则解决合并冲突
此时可能存在一种情况：
不同的Manifest中同一属性可能存在不同值 合并的时候需要进行优先级对判断
优先级从高到低依次是：
buildTypeproductFlavor- app下的
Manifest文件 - 依赖的第三方的设置
合并规则：
将每个
module里面的buildType写入到Manifest中 比如说minSdkVersiontargetSdkVersionversionCodeVersionName这些属性
合并后的Manifest文件可以在app/intermediates/manifests/*目录下查看同一属性 如果优先级从高到低都是非默认值并且不可以匹配 会产生冲突 此时有两种方式可以解决 具体见下面的栗子
无论高低优先级 如果其中一个设置了默认的属性值或者没设置 另外一个设置了非默认的属性值 则合并后的结果就是此非默认的属性值 项目编译后可以查看合并记录：
app/intermediates/outputs/logs/manifest*.txt
栗子：
主 module: app
依赖的 module: mysdk
app/build.gradle
apply plugin: 'com.android.application'
android {
compileSdkVersion 24
buildToolsVersion "24.0.0"
defaultConfig {
applicationId "com.example.ckc.study"
minSdkVersion 15
targetSdkVersion 24
versionCode 1
versionName "1.0"
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
productFlavors {
demo {
minSdkVersion 7
applicationId "com.ckc.app"
}
}
}
dependencies {
compile fileTree(include: ['*.jar'], dir: 'libs')
testCompile 'junit:junit:4.12'
compile 'com.android.support:appcompat-v7:24.0.0'
compile project(':mysdk')
}
mysdk/build.gradle
apply plugin: 'com.android.library'
android {
compileSdkVersion 24
buildToolsVersion "24.0.0"
defaultConfig {
minSdkVersion 8
targetSdkVersion 24
versionCode 1
versionName "1.0"
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
}
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
testCompile 'junit:junit:4.12'
compile 'com.android.support:appcompat-v7:24.0.0'
}
app下build.gradle 中 minSdkVersion 属性的默认值定义的是15 但在变种中定义的是7 那么编译后app中的 Manifest中对应的值就是7
mysdk中对应的默认值是8 由于mysdk的优先级比较低 所以此时就会产生冲突 解决的方案：
- 提高app中的值 或者降低mysdk的值 但是某种情况下属性值由于项目要求不能随意修改 此时就出现了第二种方案
-
overrideLibrary标签：直接覆盖library中的设置 具体使用：
<uses-sdk tools:overrideLibrary="com.example.mysdk"/>
tools:overrideLibrary 也可以用在 application 标签上
Marker Selectors
标记选择器 让一些属性在某些 libary 上失效 比如我想让 mysdk 这个模组禁掉网络访问的权限 那么就可以这样设置：
<uses-permission android:name="android.permission.INTERNET"
tools:node="remove" //删除该权限
tools:selector="com.example.mysdk" //目标模组
/>
Configure dependencies
配置依赖
gradle 支持6种配置方式:
-
compile：对所有buildType以及flavors进行编译并打包到 apk -
provided：和compile相似，但只在编译时使用，几只参与编译，不打包到最终 apk -
test compile：仅仅针对单元测试的代码编译打包 -
debug compile：仅针对debug模式编译打包 -
release compile：仅针对release模式编译打包 -
provided: 一些依赖库会用到 对于远程依赖provided和compile效果是一样的 都不会打包到jar或者aar中 但是本地依赖两者是有区别的：provided只会在编译时起效果 不会打包到apk中 但是compile会
Configure Sigining
配置签名
gradle配置 release 签名需要三步：
- 生成一个
keyStore这个保存私钥的一个二进制文件 - 生成一个私钥 建立开发者和公司的关系
- 将生成的信息配置到 主项目app的 build.gradle 中
栗子:
android {
...
defaultConfig {...}
signingConfigs {
release {
storeFile file("myreleasekey.keystore") //此文件一般放在release文件夹下
storePassword "password" //读取此文件的密码
keyAlias "MyReleaseKey" //别名
keyPassword "password" //别名密码
}
}
buildTypes {
release {
...
signingConfig signingConfigs.release
}
}
}
上述设置密码的方式并非很安全
安全的做法，通过环境变量的方式获取：
storePassword System.getenv("KSTOREWD");
keyPassword System.getenv("KEYPWD");
或者：
用命令行的方式编译 让开发者手动输入密码：
storePassword System.console().readLine("\nKeystore password: ")
keyPassword System.console().readLine("\nKey password: ")
