|
|
用Gradle 构建你的android 程序 android gradle 的插件终于把混淆代码的task集成进去了，加上最近，android studio 用的是gradle 来构建项目， 下定决心把android gralde 构建项目的用户指南全部看完， 让不会用gradle 的人也用gradle构建android项目，让打包（注意，打包和构建是两码事）多版本android不再痛苦 。最后，题外话：珍惜生命，远离ant.... Gradle build android 历史 Android Tools 主页 ，大概是今年2月份发布 adt21 .1 的时候，忽然在主页发现了New Build System 原来是可以用gradle 来构建android项目，至于gradle 是什么（既然点击进来看了应该都知道了吧 。） 。然后，又看了一下RoadMap 那时候，还并不支持Proguard 打包，于是就没看了 。 。 。
最近，android studio 发布，终于gradle 0 .4 也跟着出来了，于是，先把gradle 学了一遍，然后把Gradle Plugin User Guide 也认真阅读了一下，根据我的个人体验，如果你对gradle 毫无了解就去看Gradle Plugin User Guide 可能很多地方都一头雾水，但是并不妨碍你用gradle 打包android 应用，只是，出现问题，你就可能很头疼 。不过，本篇博文就是让不会gradle 也能用上 gradle 打包android 程序，因为，我也不懂gradle，所以，我把我碰到的问题的解决方案都一一列出 。
顺便贴上官方为什么使用gradle 的理由- Domain Specific Language (DSL) to describe and manipulate the build logic
- Build files are Groovy based and allow mixing of declarative elements through the DSL and using code to manipulate the DSL elements to provide custom logic .
- Built-in dependency management through Maven and/or Ivy .
- Very flexible . Allows using best practices but doesn’t force its own way of doing things .
- Plugins can expose their own DSL and their own API for build files to use .
- Good Tooling API allowing IDE integration
Gradle 基本概念 首先我们学习几个gradle 的脚本语法，掌握了这几个语法，你就能非常简单的用gradle构建打包android项目了 。 首先，我们来看下一个最简单android build.gradle
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17 | buildscript {
repositories {
mavenCentral()
}
dependencies {
classpath 'com.android.tools.build:gradle:0 .4'
}
}
apply plugin: 'android'
android {
compileSdkVersion 17
} |
英语的介绍都来自与 gradle官方文档， 主要后边的中文不是翻译，是补充介绍 。 。
Configures the build script classpath for this project . 说白了就是设置脚本的运行环境
Returns a handler to create repositories which are used for retrieving dependencies and uploading artifacts produced by the project . 大意就是支持java 依赖库管理（maven/ivy）,用于项目的依赖。这也是gradle 强力的地方 。 。。
The dependency handler of this project . The returned dependency handler instance can be used for adding new dependencies . For accessing already declared dependencies, the configurations can be used . 依赖包的定义。支持maven/ivy，远程，本地库，也支持单文件，如果前面定义了 repositories{} maven 库，使用maven的依赖（我没接触过ivy 。 。）的时候只需要按照用类似于 com.android.tools.build:gradle:0 .4，gradle 就会自动的往远程库下载相应的依赖 。
声明构建的项目类型，这里当然是android了 。 。 。
设置编译android项目的参数，接下来，我们的构建android项目的所有配置都在这里完成 。 构建一个Gradle android 项目 首先，你要安装Gradle 1 .6 并且，写进系统的环境变量里面，所有的命令都是默认你已经配好了gradle 的环境。而且，已经已经升级了android sdk 22
要用gradle构建你的有两种方式：（ build.gradle 放到项目目录下）- 利用adt 22导出 build.gradle .
- 复制别人写好的build.gradle 文件.
- 根据gradle 规则，手写android 的build.gradle 文件 。
个人推荐1,2 方法。。 。。
一个android build.gradle 最基本基本文件
build.gradle 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39 | buildscript {
repositories {
mavenCentral()
}
dependencies {
classpath 'com.android.tools.build:gradle:0 .4'
}
}
apply plugin: 'android'
dependencies {
}
android {
compileSdkVersion 17
buildToolsVersion "17"
defaultConfig {
minSdkVersion 8
targetSdkVersion 17
}
sourceSets {
main {
manifest.srcFile 'AndroidManifest.xml'
java.srcDirs = ['src']
resources.srcDirs = ['src']
aidl.srcDirs = ['src']
renderscript.srcDirs = ['src']
res.srcDirs = ['res']
assets.srcDirs = ['assets']
}
instrumentTest.setRoot('tests')
}
} |
接着在命令行cd 到项目目录下 例如: cd e:\workplace\andoridGradle 如果你是第一次使用gradle 构建android项目建议你先使用 gradle clean把android gradle 插件，还有相关依赖包下载下来并且对环境进行初始化，如果出错了，一般可能是下载超时，试多几次即可，最后你会看到如下提示：
The TaskContainer.add() method has been deprecated and is scheduled to be remove d in Gradle 2 .0. Please use the create() method instead.
:clean UP-TO-DATE
BUILD SUCCESSFUL
Total time: 7 .847 secs
完成以上的步骤，就可以正式使用gralde 构建你的android项目了 。
然后使用 gradle build就完成了android 项目的构建了 。如果，你是照着以上步骤走的话，你将会想项目目录里面看到一个build 的目录，里面就是用gradle 构建android项目的全部例如了，结构目录看附录 。
最终打包的apk 就在build/apk 目录下了 。然后，你会发现，两个apk 一个是 <em style="margin:0px;padding:0px;border:0px;font-family:inherit;font-size:inherit;font-variant:inherit;line-height:inherit;vertical-align:baseline;">[项目名]-debug-unaligned [项目名]-release-unsigned
如果以上内容你都掌握的话，接下来就将详细说说如何利用gralde 打包android apk 。 Gralde 打包参数详解 上面说了一大堆东西，其实并不吸引人去使用gradle，如果只是构建项目的话，adt不是更合适吗？如果，你看完以下内容还是这么觉得的话，你就没必要折腾gradle了 。 。。。 。。
看附录 默认输出 <em style="margin:0px;padding:0px;border:0px;font-family:inherit;font-size:inherit;font-variant:inherit;line-height:inherit;vertical-align:baseline;">release apk 是没有签名的，那么我们需要签名的很简单，只需要在android{}里面补充加上加上即可 。完整build.gradle 请点击我的gist
build.gradle 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15 | signingConfigs {
myConfig{
storeFile file("gradle.keystore")
storePassword "gradle"
keyAlias "gradle"
keyPassword "gradle"
}
}
buildTypes{
release {
signingConfig signingConfigs.myConfig
}
} | 然后，运行
,这次在build/apk 你看到了多了一个[项目名]-release-unaligned， 从字面上面我就可以知道，这个只是没有进行zipAlign 优化的版本而已 。 而[项目名]-release 就是我们签名，并且zipAlign 的apk包了. ###打混淆包### 只需要在原来的基础上加上，完整的proguad.gradle 代码 build.gradle 1
2
3
4
5
6
7
8 | buildTypes{
release {
signingConfig signingConfigs.myConfig
runProguard true
proguardFile 'proguard-android.txt'
}
} |
打多渠道包(Product Flavor ) 现在来解释一下上一节的问题， apk目录下的两个apk 的含义
为什么产生了两个apk？
默认的android gralde 插件定义了两种apk 的类型 debug, release，这两种类型的详细对比看附录 。
这个是android gralde 插件 buildTypes{}方法产生的，默认配置好了两个默认模板，当然你也可以修改，前面我们就是在修改默认的release 的配置，让输出release类型的的apk，具有签名和混淆 。
对于多渠道包，android 插件提供了一个名为Product Flavor{}的配置，用于进行多渠道打包 。
例如，我的android应用有海外版，和国内版本，而且这两个版本的包名是不一样的！！（我就举两个市场的例子安装这个思路，你要打包100个不同的市场只是几行代码的事情 。）。
你只需要在 android{}补充上
build.gradle 1
2
3
4
5
6
7
8 | productFlavors {
playstore {
packageName='com.youxiachai.androidgradle.playstore'
}
hiapk {
packageName='com.youxiachai.androidgradle.amazonappstore'
}
} |
然后
,
,在build/apk 下面你会看到一堆的包，命名格式[项目名]-[渠道名]-release
仅此而已 ?
Product Flavor{}不只是能改包名那么简单，还能够对编译的源码目录进行切换 。
什么意思 ? 不知道各位有没有用过友盟做用户统计，如果，你用的是分发渠道分析，你需要修改AndroidManifest.xml 添加上
| <meta-data android:value="hiapk" android:name="UMENG_CHANNEL"/> |
如果，你很多渠道，，然后你就会很痛苦，现在用gradle 就非常舒服，你只需要在 android.sourceSets指定我们的渠道名就行，android gradle 插件，会自动打包！！！例如
build.gradle 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21 | sourceSets {
main {
manifest.srcFile 'AndroidManifest.xml'
java.srcDirs = ['src']
resources.srcDirs = ['src']
aidl.srcDirs = ['src']
renderscript.srcDirs = ['src']
res.srcDirs = ['res']
assets.srcDirs = ['assets']
}
hiapk {
manifest.srcFile 'hiapk/AndroidManifest.xml'
}
playstore {
manifest.srcFile 'hiapk/AndroidManifest.xml'
}
instrumentTest.setRoot('tests')
} | 然后运行
,
,省下的时间去喝杯咖啡，睡个觉什么的都好 。 。 。 ###外部依赖### android gradle 对于外部jar 包的应用支持maven/ivy 管理的包，也支持指定具体文件，前面已经在上文说过 。 上面演示的完整 build.gradle gist 里面也有写 。 你需要加上如下代码即可： build.gradle 1
2
3 | dependencies {
compile files('libs/android-support-v4.jar')
} |
至此，对于用android gradle 构建android应用程序，打包android 程序，所需要的所有知识，在以上已经说明，只要你是认真看上面文章的，对于，如何打依赖于android library project 的包，可以看附录提供的那个德国人写的例子，而对于build.gradle 里面的代码你需要把 0 .2, 改为 0 .4即可。至于用gradle 运行android test case部分的教程，个人感觉写了也白写（我写过关于andorid 测试相关的文章，也录制过视频，所以有这个感觉 。），估计不会有人关注，所以，如果你对用gradle 进行android test的话，可以看附录里面提供的官方gradle手册 。
对于这部分内容，你读与不读，并不影响你使用gradle 打包android 项目 。至于读了的好处就是你能够更好的使用gradle。 。- 完整的Gradle Plugin User Guide 其中里面有个错误是
| compile files('libs/android-support-v4.jar') |
不是
| compile file('libs/android-support-v4.jar') |
教程是基于android gradle0 .3 ，在0 .4中只是多了 混淆打包，这块已经在文中补充了。 - 一个德国人写的Android-Gradle-Examples
- dependencies{}更多的介绍 。
- debug, release,这两种类型的默认配置如下：
| Property name | Default values for debug | Default values for release / other | | debuggable | true | false | | jniDebugBuild | false | false | | renderscriptDebugBuild | false | false | | renderscriptOptimLevel | 3 | 3 | | packageNameSuffix | null | null | | versionNameSuffix | null | null | | signingConfig | android.signingConfigs.debug | null | | zipAlign | false | true | - defaultConfig {} 配置参数列表
| Property Name | Default value in DSL object | Default value | | versionCode | -1 | value from manifest if present | | versionName | null | value from manifest if present | | minSdkVersion | -1 | value from manifest if present | | targetSdkVersion | -1 | value from manifest if present | | packageName | null | value from manifest if present | | testPackageName | null | app package name + “.test” | | testInstrumentationRunner | null | android.test.InstrumentationTestRunner | | signingConfig | null | null | | runProguard | false | false | | proguardFile | 'proguard-android.txt' or 'proguard-android-optimize.txt' | 'proguard-android.txt' or 'proguard-android-optimize.txt' | - build 结构目录
tree 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90 | build/
├── apk
├── assets
│ ├── debug
│ └── release
├── classes
│ ├── debug
│ │ └── com
│ │ └── example
│ │ └── gradle
│ └── release
│ └── com
│ └── example
│ └── gradle
├── dependency-cache
│ ├── debug
│ └── release
├── incremental
│ ├── aidl
│ │ ├── debug
│ │ └── release
│ ├── dex
│ │ ├── debug
│ │ └── release
│ ├── mergeAssets
│ │ ├── debug
│ │ └── release
│ └── mergeResources
│ ├── debug
│ └── release
├── libs
├── manifests
│ ├── debug
│ └── release
├── res
│ ├── all
│ │ ├── debug
│ │ │ ├── drawable-hdpi
│ │ │ ├── drawable-mdpi
│ │ │ ├── drawable-xhdpi
│ │ │ ├── drawable-xxhdpi
│ │ │ ├── layout
│ │ │ ├── menu
│ │ │ ├── values
│ │ │ ├── values-sw720dp-land
│ │ │ ├── values-v11
│ │ │ └── values-v14
│ │ └── release
│ │ ├── drawable-hdpi
│ │ ├── drawable-mdpi
│ │ ├── drawable-xhdpi
│ │ ├── drawable-xxhdpi
│ │ ├── layout
│ │ ├── menu
│ │ ├── values
│ │ ├── values-sw720dp-land
│ │ ├── values-v11
│ │ └── values-v14
│ └── rs
│ ├── debug
│ └── release
├── source
│ ├── aidl
│ │ ├── debug
│ │ └── release
│ ├── buildConfig
│ │ ├── debug
│ │ │ └── com
│ │ │ └── example
│ │ │ └── gradle
│ │ └── release
│ │ └── com
│ │ └── example
│ │ └── gradle
│ ├── r
│ │ ├── debug
│ │ │ └── com
│ │ │ └── example
│ │ │ └── gradle
│ │ └── release
│ │ └── com
│ │ └── example
│ │ └── gradle
│ └── rs
│ ├── debug
│ └── release
└── symbols
├── debug
└── release
88 directories |
最后的吐槽 吐槽一下 。 。。用ant脚本的（也许你没有接触过。 。）。在以前你用ant 脚本打包apk的时候需要打包不同包名，你需要用ant 读取 AndroidManifest.xml 然后又正则匹配替换里面packagename 参数 。 。虽然描述得过程很简单，你真去写的时候你就蛋疼了（对于一个ant外行人来说，个人感觉ant的学习曲线太陡峭了，如果是两年前的我，可能还写得出这样的ant脚本（当年费了很大的功夫学习了一个多星期），不过，因为很少用到（后来知道maven了 。 。果断放弃了ant，为什么不在android使用maven？ 因为，android 的maven 插件式非官方的，而且现在看来maven 的xml实在很复杂，看起来就头疼））*
----------------------------
原文链接:https://blog.51cto.com/youxilua/1204595
程序猿的技术大观园：www.javathinker.net
[这个贴子最后由 flybird 在 2020-05-15 17:35:04 重新编辑]
|
|
Java技术网站 → 『 Java开发技术 』 → 『 Android技术专题 』 → 用Gradle 构建你的android程序
消息
查看
搜索
好友
邮件
复制
引用
IP: 已设置保密
