Android应用编译配置详解
Android应用配置编译详解
编译打包过程
640.jpg
Paste_Image.png
Paste_Image.png
- 1.编译器将源码编译为DEX文件（Dalvik虚拟机可执行文件）
- 2.APK打包工具将DEX文件和编译过的资源文件打包到一个APK文件中
- 3.APK打包工具使用debug或release密钥给APK文件签名（AS默认使用debug密钥配置新项目）
- 打包工具在生成最终的APK文件之前，使用
zipalign工具优化应用文件占用的内存
自定义编译配置
Build Types
Build types define certain properties that Gradle uses when building and packaging your app, and are typically configured for different stages of your development lifecycle.
编译类型(Build Types)定义了Gradle在编译和打包app时使用的确切属性。AS默认设置了debug和release两种build type。
| build type | 特点 |
|---|---|
| debug | 开启debug选项，使用debug keystore签名 |
| release | 压缩，混淆，使用release keystore签名 |
Q:如何添加自定义类型的编译类型?
A:在模块级别的build.gradle文件，android代码块中有一个buildTypes代码块。在其中添加自定义类型的即可。具体属性设置可参考BuildType文档
//模块级别的build.gradle文件
android {
...
defaultConfig {...}
buildTypes {
release {
minifyEnabled true
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
debug {
applicationIdSuffix ".debug"
}
//自定义的编译类型:jnidebug
jnidebug {
initWith debug
applicationIdSuffix ".jnidebug"
jniDebuggable true
}
}
}
Product Flavors
Product flavors represent different versions of your app that you may release to users
Product flavors表示发布给用户的不同版本的app。例如免费版和收费版。Product flavors是可选项，必须我们手动去创建。
Q:如何添加Product Flavors?
A:和添加build types类似，在productFlavors代码块中添加即可。
defaultConfig实际上属于ProductFlavor类，因此可在defaultConfig代码块中配置所有flavor共同的属性。每个flavor都能覆盖之前的默认值。如applicationId。
android {
...
defaultConfig {...}
buildTypes {...}
productFlavors {
demo {
applicationId "com.example.myapp.demo"
versionName "1.0-demo"
}
full {
applicationId "com.example.myapp.full"
versionName "1.0-full"
}
}
}
Build Variants
A build variant is a cross product of a build type and product flavor, and is the configuration Gradle uses to build your app.
build variant是build type和product flavor共同作用的产物，是Gradle编译app的配置。
//模块级别的build.gradle
android{
...
buildTypes{
//默认有debug和release两种build types
...
}
productFlavors{
//不同开发环境设置不同的productFlavor
//开发
dev{
...
}
//生产
prd{
...
}
//测试
tst{
...
}
//定制
cus{
...
}
}
}
如上所示，我们配置了四种不同的product flavors和两种build types,在Android Studio中能看到如下所示的选择界面。供我们切换不同的Build Variants。
Paste_Image.png
Manifest Entries
我们可在build variant的配置中指定Manifest文件属性的值（将覆盖Manifest文件已存在的值）。这有助于我们的项目生成多个APK文件，且每个APK文件有不同的应用名，最小SDK版本，编译SDK版本。
合并多个Manifest文件，可能会有冲突。如何解决冲突请参考Merge Multiple Manifest Files。
Dependencies
编译系统管理项目依赖，包括来自本地文件系统的和来自远端仓库的依赖。
android {...}
...
dependencies {
//依赖本项目的"mylibrary"模块
compile project(":mylibrary")
//依赖远端库文件
compile 'com.android.support:appcompat-v7:23.4.0'
//依赖本地库文件
compile fileTree(dir: 'libs', include: ['*.jar'])
}
声明几种依赖的方式：
- 依赖本项目的某模块
compile project(":模块名")
- 依赖远端库文件
compile '库名:版本'
- 依赖本地库文件
compile fileTree(dir: 'libs', include: ['*.jar'])
Signing
我们能在编译配置中设置签名的属性值，编译系统会在编译的过程中自动给我们的应用签名。具体细节请参考Sign Your App
生成jks密钥文件:
在Android Studio中依次打开
Build->Generate Signed APK->Next
->Create new->New Key Store(分别填写每一项，如下图所示)
Paste_Image.png
Q:为什么我之前看到的是.keystore文件，而现在却是.jks文件?
A:Eclipse用到的签名文件是以.keystore结尾，而Android Studio中则是.jks文件。
维护密钥的安全性:
- 1.如果我们直接在build.gradle文件中设置签名相关的配置，容易导致密钥的密码等信息通过版本控制工具(如SVN,Git等)被泄漏。
//模块级别的build.gradle
android {
signingConfigs {
config {
keyAlias 'YourKeyAlias'
keyPassword 'YourKeyPassword'
storeFile file('Your StoreFile location')
storePassword 'Your store Password'
}
}
...
}
- 2.我们可以将签名相关的配置的值写在gradle.properties属性文件中。如下所示，能有效避免将签名相关信息提交到版本控制工具中。
//gradle.properties属性文件
RELEASE_KEY_ALIAS=test
RELEASE_KEY_PASSWORD=123456
RELEASE_STORE_PASSWORD=123456
RELEASE_STORE_FILE=../XX.jks
//模块级别的build.gradle
android {
signingConfigs {
config {
keyAlias RELEASE_KEY_ALIAS
keyPassword RELEASE_KEY_PASSWORD
storeFile file(RELEASE_STORE_FILE)
storePassword RELEASE_STORE_PASSWORD
}
}
...
}
ProGuard
编译过程中运行ProGuard文件来压缩和混淆类。
- 1.混淆代码
android {
buildTypes {
release {
//开启混淆
minifyEnabled true
//指定混淆规则文件
//getDefaultProguardFile(‘proguard-android.txt') 方法获取AndroidSDK中默认的混淆规则文件 （有proguard-android.txt，proguard-android-optimize.txt 两种默认规则文件）
//proguard-rules.pro则是自定义混淆规则的文件
proguardFiles getDefaultProguardFile(‘proguard-android.txt'),'proguard-rules.pro'
}
}
...
}
混淆代码会增加编译的时间，因此在debug模式下无需开启混淆。
每次开启混淆的编译，ProGuard都会生成以下文件:
Paste_Image.png
- dump.txt 描述APK中所有类文件的内部结构
- mapping.txt 原始代码和混淆过后的类，方法和域名之间的翻译
- seeds.txt 列出未被混淆的类和成员
- usage.txt 列出APK文件中被移除的代码
这些文件都被保存在<module-name>/build/outputs/mapping/release/.目录下。
- 2.保留代码不被混淆
//在proguard.pro文件中添加
-keep public class MyClass
//或是直接在需要保留的类之前添加@Keep注解
@Keep
public class MyClass{
...
}
由于代码被混淆，错误日志会变得难以阅读。因此，我们需要保存每次发布新版本应用时ProGuard生成的mapping.txt文件。以便将混淆过后的错误信息恢复成可读的状态。
retrace.bat/retrace.sh -verbose mapping.txt obfuscated_trace.txt
- 3.压缩资源
压缩资源只有和代码混淆一起才能起作用。
android {
...
buildTypes {
release {
//开启资源压缩
shrinkResources true
minifyEnabled true
proguardFiles getDefaultProguardFile('proguard-android.txt'),
'proguard-rules.pro'
}
}
}
编译配置文件
下图是Android应用模块的默认项目结构
Paste_Image.png
Gradle设置文件
settings.gradle文件指出编译时被包括在内的模块。
//settings.gradle文件
include ':app'
顶层Build文件
指定所有模块共同的构建配置。
//顶层build.gradle文件
buildscript {
//配置Gradle查找或下载依赖的代码库。例如远端的JCenter,Maven Center和Ivy，以及本地仓库。
repositories {
jcenter()
}
//配置Gradle需要用来构建项目的依赖
dependencies {
classpath 'com.android.tools.build:gradle:2.0.0'
}
}
//配置所有模块都能使用的代码库或依赖
allprojects {
repositories {
jcenter()
}
}
模块级Build文件
//模块级别的Build文件
//指定Android插件
apply plugin: 'com.android.application'
android {
compileSdkVersion 23
buildToolsVersion "23.0.3"
defaultConfig {
applicationId 'com.example.myapp'
minSdkVersion 14
targetSdkVersion 23
versionCode 1
versionName "1.0"
}
buildTypes {
release {
minifyEnabled true
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
productFlavors {
free {
applicationId 'com.example.myapp.free'
}
paid {
applicationId 'com.example.myapp.paid'
}
}
splits {
density {
enable false
exclude "ldpi", "tvdpi", "xxxhdpi", "400dpi", "560dpi"
}
}
}
dependencies {
compile project(":lib")
compile 'com.android.support:appcompat-v7:22.0.1'
compile fileTree(dir: 'libs', include: ['*.jar'])
}
Gradle属性文件
指定Gradle构建工具自身的一些属性
- gradle.properties 文件：配置Gradle，例如Gradle守护进程的堆的大小。
- local.properties 文件：配置构建系统的本地环境属性，例如SDK的安装路径。
