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项目了。首先,我们来看下一个最简单androidbuild.gradle
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官方文档, 主要后边的中文不是翻译,是补充介绍。。
buildscript{}
Configures the build script classpath for this project.说白了就是设置脚本的运行环境
repositories{}
Returns a handler to create repositories which are used for retrieving dependencies and uploading artifacts produced by the project.大意就是支持java
依赖库管理(maven/ivy),用于项目的依赖。这也是gradle 强力的地方。。。
dependencies{}
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
就会自动的往远程库下载相应的依赖。
apply plugin:
声明构建的项目类型,这里当然是android了。。。
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 插件,还有相关依赖包下载下来并且对环境进行初始化,如果出错了,一般可能是下载超时,试多几次即可,最后你会看到如下提示:BUILD
SUCCESSFUL
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
一个是[项目名]-debug-unaligned[项目名]-release-unsigned
如果以上内容你都掌握的话,接下来就将详细说说如何利用gralde 打包android apk。
Gralde打包参数详解
上面说了一大堆东西,其实并不吸引人去使用gradle,如果只是构建项目的话,adt不是更合适吗?如果,你看完以下内容还是这么觉得的话,你就没必要折腾gradle了。。。。。。
看附录 默认输出releaseapk 是没有签名的,那么我们需要签名的很简单,只需要在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
}
}
|
然后,运行gradle
clean
gradle
build
,这次在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'
}
}
|
gradle clean
gradle build
打多渠道包(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'
}
}
|
然后gradle clean
,gradle
build
,在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')
}
|
然后运行gradle
clean
,gradle
build
,省下的时间去喝杯咖啡,睡个觉什么的都好。。。###外部依赖###
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实在很复杂,看起来就头疼))*
分享到:
相关推荐
理解Gradle构建过程,解读Android Gradle插件的配置 阅读本文一定是要使用过Gradle生成apk,文中不会讲如何安装运行Gradle,如有需要可先看文末的参考文章。 APK包是一个ZIP压缩包,从Java源代码、资源文件到生成这...
该插件会自动安装Android SDK并配置Gradle以使用它。 默认情况下,此插件在下载SDK软件包时也会自动接受所有Android SDK许可。 在使用插件或升级Android SDK版本之前,请确保您可以接受这些版本的许可证,如果没有...
适用于Android和Java最终项目的Gradle(Udacity的Android开发人员Nanodegree) 在此项目中,您将创建具有多种风格的应用程序,该应用程序使用多个库... 您将学习Gradle在构建Android应用中的作用,以及如何使用Gradle管
1.1 什么是Gradle? Gradle是一个开源构建自动化工具,专为大型项目设计。它基于DSL(领域特定语言)编写,该语言是用Groovy编写的,使得构建脚本更加...性能:Gradle使用它的守护程序和增量构建技术来提高构建速度。
插件专为使用和Android 应用程序而设计。为什么我需要这个? Android 应用程序的发布版本不应包含任何调试日志。 在生产中删除 Android 日志的方法之一如下 if (BuildConfig.DEBUG) { Log.d("TAG", "Some log");}这...
gradle-eclipse-aar-plugin, 在 Eclipse 上,使用 Android AAR库的Gradle插件 gradle-eclipse-aar-plugin Gradle插件在 Eclipse 上...使用这个插件,你可以管理Gradle的依赖项,并在 Eclipse 上构建应用程序。Android
使用Gradle构建具有免费和付费版本的讲笑话应用程序。 这包括将分解功能纳入库中,以及使用构建风格对应用程序每个变体的构建进行模块化。 我还配置了一个Google Cloud Endpoints开发服务器来提供笑话。 所需组件 ...
该项目使用 Android gradle 构建系统进行 Java 和 C (NDK) 编译。 默认情况下,该项目将使用 Stockfish 引擎为 armeabi-v7a 和 x86_64 ABI 构建和安装 DroidFish。 确保 ndk.dir 和 sdk.dir 在 local.properties ...
用于将Xamarin移动应用程序集成到gradle和maven中的插件。 当前有三个插件: xamarin-build-plugin:允许您通过针对.csproj / .sln文件调用构建来构建现有的Xamarin.Android(编译和apk),Xamarin.iOS和香草...
Android studio4.1.1默认的gradle-6.5,gradle-6.5此版本包括针对文件系统监视(file-system watching)功能的实验性加入, 可显著缩短构建时间,尤其是在增量方案中。还有其他一些改进,包括更好的版本排序、新的...
适用于Android和Java最终项目的Gradle 在此项目...为什么这个项目随着Android项目变得越来越复杂,有必要自定义Gradle构建工具的行为,从而实现重复性任务的自动化。 特别是,将功能分解到库中并创建产品风味允许使用最
Gradle “xxx” project refresh failed 环境(2014.03.13最新): 问题: Gradle “xxx” ...Gradle是构建Android项目的必备程序, Android Studio的基础, 有很多优势, 使构建变得更加简洁, 由于在测试阶段, 难免会出现
从2.0.0版开始,此插件仅可与Android Gradle插件3.0.0及更高版本一起使用。 为了支持较低版本,请使用1.2.0。 使用构建工具26+和Groovy jar时出现问题。 当前的解决方法是使用proguard或使用JarJar创建一个没有调用...
默认情况下,Android Studio中的Gradle构建命名为.apk文件app-release.apk。对应用程序build.gradle文件进行了一些小的更改,可以将.apk名称更改为<app>-release-<version>.apk。 需要在app的目录下面修改build....
适用于Android和Java Final Project的Gradle 在此项目中,您将创建具有多种风格的应用程序,该应用程序使用多个库... 您将学习Gradle在构建Android应用中的作用,以及如何使用Gradle管理日益复杂的应用。 您将学到: 向
Android studio 自动化构建工具;gradle是一个工程构建工具,java代码,和资源文件需要经过sdk里的一些程序如aapt等处理,才能形成apk包。gradle就是把那些步骤变得简单化。相当于eclipse中的ant吧!
适用于Android和Java Final Project的Gradle 在此项目中,您将创建一个具有多种风格的应用程序,该应用程序使用多个... 您将学习Gradle在构建Android应用中的作用,以及如何使用Gradle管理日益复杂的应用。 您将学到:
将 nRF UART android 应用程序移植到 Android Studio 1.0.1。 原始 nRF UART 源代码来自 这个应用程序实现了一个简单的基于文本的发送和接收服务。 要使用 nRF51822 mbed KIT 测试此代码,您需要运行 BLE_...
ViewPagerIndicator-gradle 带有 gradle 构建文件的的 Android Studio 友好分支唯一的源代码更改是示例应用程序现在具有包com.viewpagerindicator.sample 取自 2.4.1 版本的代码执照APL 2.0