Android build.gradle文件

1. 常见的参数意义

compiledSdkVersion

应用将要编译的目标Android版本，此处默认为你的SDK已安装的最新Android版本，我们仍然可以使用较老的版本编译项目，但把该值设为最新版本，可以使用Android的最新特性，同时可以在最新的设备上优化应用来提高用户体验。

buildToolsVersion

使用什么版本的编译工具。使用SDK Manager安装多个版本的编译工具。

applicationId

创建新项目时指定的包名。

minSdkVersion

创建项目时指定的最低SDK版本，是新建应用支持的最低SDK版本。

targetSdkVersion

表示你测试过你的应用支持的最高Android版本(同样用API level表示)，当Android发布最新版本后，我们应该在最新版本的Android测试自己的应用同时更新target sdk到Android最新版本，以便充分利用Android新版本的特性。举例来说，设置这个值为11或更高，当你的应用运行在Android3.0或更高的系统上时，系统会为你的应用使用新的默认主题（Holo主题），并且当运行在大屏幕的设备上时会禁用屏幕兼容模式（screen compatibility mode），因为支持了 API level 11就暗示了支持大屏幕

2. 基本配置

Gradle是一种基于Groovy的动态DSL，而Groovy语言是一种基于jvm的动态语言

2.1 项目 gradle结构

2.2 app/build.gradle 解析

apply plugin: 'com.android.application'
android {
compileSdkVersion 23
buildToolsVersion "23.0.2"
defaultConfig {
applicationId "com.wuxiaolong.gradle4android"
minSdkVersion 15
targetSdkVersion 23
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:23.2.1'
compile 'com.android.support:design:23.2.1'
}

apply plugin: ‘com.android.application’，表示该module是一个app module，应用了com.android.application插件，如果是一个android library，那么这里写apply plugin: ‘com.android.library’
compileSdkVersion：基于哪个SDK编译，这里是API LEVEL
buildToolsVersion：基于哪个构建工具版本进行构建的。
defaultConfig：默认配置，如果没有其他的配置覆盖，就会使用这里的。
applicationId：配置包名的
versionCode：版本号
versionName：版本名称
buildTypes是构建类型，常用的有release和debug两种，可以在这里面启用混淆，启用zipAlign以及配置签名信息等。
dependencies：不属于Android专有的配置了，它定义了该module需要依赖的jar，aar，jcenter库信息。

2.3 gradle-wrapper.properties

声明了gradle的目录与下载路径以及当前项目使用的gradle版本，这些默认的路径我们一般不会更改的

#Mon Dec 28 10:00:20 PST 2015
distributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-2.14.1-all.zip

2.4 根目录的build.gradle

定义在这个工程下的所有模块的公共属性

buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:2.2.3'

// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files
}
}

allprojects {
repositories {
jcenter()
//下面是conggithub 上有的 compile 需要的
maven { url "https://jitpack.io" }
}
}

task clean(type: Delete) {
delete rootProject.buildDir
}

2.5 setting.gradle

include ':app', ':app_demo', ':p2pinvest', ':bilibili', ':MPChartLib', ':P2PInvest_Demo', ':ViewPagerIndicator', ':GestureLock', ':easeui', ':GG_IM', ':alipay_demo', ':MPChartExample', ':OkGo-master', ':okserver', ':okrx', ':okgo'

3. 依赖管理

3.1 jar

默认情况下，新建的Android项目会有一个lib文件夹（没有就自己写）

dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])//即添加所有在libs文件夹中的jar
//compile files('libs/WuXiaolong.jar')//不需要这样一个个去写了
}

3.2 aar文件

library库输出文件是.aar文件，包含了Android 资源文件，在library工程build/output/aar/下

-



直接依赖library库



依赖.aar文件

创建一个aars文件夹，然后把.aar文件拷贝到该文件夹里面，然后添加该文件夹作为依赖库：

app/bulid.gradle

3.3 远程仓库（最简单的 dependencies）

- `compile 'com.squareup.okhttp3:okhttp:3.4.1'`

3.4 so包

app
├── AndroidManifest.xml
└── jniLibs
├── armeabi
│   └── WuXiaolong.so
├── armeabi-v7a
│   └── WuXiaolong.so
├── mips
│   └── WuXiaolong.so
└── x86
└── WuXiaolong.so

4. 全局设置

如果有很多项目，可以设置全局来统一管理版本号或依赖库，根目录下build.gradle下：

ext {
compileSdkVersion = 23
buildToolsVersion = "23.0.2"
minSdkVersion = 14
targetSdkVersion = 23
}

app/build.gradle

android {
compileSdkVersion rootProject.ext.compileSdkVersion
buildToolsVersion rootProject.ext.buildToolsVersion
defaultConfig {
applicationId "com.wuxiaolong.gradle4android"
minSdkVersion rootProject.ext.minSdkVersion
targetSdkVersion rootProject.ext.targetSdkVersion
versionCode 1
versionName "1.0"
}

可以在根目录下建个config.gradle，然后只需在根目录下build.gradle最顶部加上下面一行代码，然后同步下，意思就是所有的子项目或者所有的modules都可以从这个配置文件里读取内容

apply from: "config.gradle"

config.gradle

ext {
android = [
compileSdkVersion: 23,
buildToolsVersion: "23.0.2",
minSdkVersion    : 14,
targetSdkVersion : 22,
]
dependencies = [
appcompatV7': 'com.android.support:appcompat-v7:23.2.1',
design      : 'com.android.support:design:23.2.1'
]
}

app/build.gradle

android {
compileSdkVersion rootProject.ext.android.compileSdkVersion
buildToolsVersion rootProject.ext.buildToolsVersion
defaultConfig {
applicationId "com.wuxiaolong.gradle4android"
minSdkVersion rootProject.ext.android.minSdkVersion
targetSdkVersion rootProject.ext.android.targetSdkVersion
versionCode 1
versionName "1.0"
}

...
dependencies {
compile fileTree(dir: 'libs', include: ['*.jar'])
testCompile 'junit:junit:4.12'
compile rootProject.ext.dependencies.appcompatV7
compile rootProject.ext.dependencies.design
}

5. 自定义BuildConfig

实际开发中服务器可能有正式环境和测试环境，gradle可以通过buildConfigField来配置

defaultConfig {
buildConfigField 'String','API_SERVER_URL','"http://wuxiaolong.me/"'
}

buildConfigField 一共有3个参数，第一个是数据类型，和Java的类型是对等的；第二个参数是常量名，这里是API_SERVER_URL；第三个参数就是你要配置的值



如图路径下就有个常量

API_SERVER_URL

，如何在代码取得这个常量值：

Log.d("wxl", "API_SERVER_URL=" + BuildConfig.API_SERVER_URL);

6. 启用proguard混淆

一般release发布版本是需要启用混淆的，这样别人反编译之后就很难分析你的代码，而我们自己开发调试的时候是不需要混淆的，所以debug不启用混淆。对release启用混淆的配置如下：

android {
buildTypes {
release {
minifyEnabled true//是否启动混淆
shrinkResources true //是否移除无用资源文件，shrinkResources依赖于minifyEnabled，必须和minifyEnabled一起用
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
}

minifyEnabled为true表示启用混淆，proguardFile是混淆使用的配置文件，这里是module根目录下的proguard-rules.pro文件

7. gradle 多渠道打包

我更喜欢 Python 多渠道打包，蛮快的，这个以后有机会再补充

8. 配置签名信息

8.1 Android Studio设置默认的签名文件

新浪微博SSO登录，微信分享这些都需要签名打包，才能看到效果，设置默认签名文件为自己的签名jks，这样就不需要打包了，直接运行起来就是正式的签名。

在

android.signingConfigs{}

下定义一个或者多个签名信息，然后在

buildTypes{}

配置使用即可。

在app目录下添加你的.jks，然后app的build.gradle文件中的增加以下内容：

第一种：

android {
signingConfigs {
debug {
storeFile file("appkey.jks")
storePassword 'android'
keyAlias 'android'
keyPassword 'android'
}
}
}

buildTypes没有配置，也是直接取得debug，是不是不配置默认取得是debug呢？

第二种：

android {
signingConfigs {
release {
storeFile file("WuXiaolong.jks")
storePassword 'android'
keyAlias 'android'
keyPassword 'android'
}
}
buildTypes {
debug {
signingConfig signingConfigs.release
}
}
}

gradle签名和打包的链接