前言
续上一篇《用Gradle 构建你的android程序》,这次把上次没写的关于,如何用gralde 构建带有依赖的项目补全吧。
Gradle android 插件现况
个人感觉还是说说,目前android gradle 插件的现况,如无意外应该是最新的。
目前最新的官方gradle android 是0.4,除了android 官方的gralde的插件,也有一些开发者很早以前开发的gradle 插件,不过现在基本不维护了,所以这里不对这些第三方的gradle插件进行介绍。
android Gradle 0.4 插件maven中央库,目前新的android gradle 构建系统基本完善,现在已知的问题有
- 不支持android library 与 android library 的互相引用。
- 不支持 NDK
- 不支持android library 打包文件(*.aar) 的本地引用
如果,以上问题的你都碰到不到的话,从现在开始,用gradle来构建android程序是一个不错的选择。
引用依赖
这里阅读的前提是你已经把上一篇已经看过。
本地依赖
gradle 作为构建工具,能够很方便的使用本地jar包,以下为使用的代码块。
1 2 3 4 5 6 7 8 9 10 | dependencies { //单文件依赖 compile files('libs/android-support-v4.jar') //某个文件夹下面全部依赖 compile fileTree(dir: 'libs', include: '*.jar') } android { } |
远程依赖
gradle 同时支持maven,ivy,由于ivy我没用过,所以用maven 作为例子,以下为代码块:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | repositories { //从中央库里面获取依赖 mavenCentral() //或者使用指定的本地maven 库 maven{ url "file://F:/githubrepo/releases" } //或者使用指定的远程maven库 maven{ url "https://github.com/youxiachai/youxiachai-mvn-repo/raw/master/releases" } } dependencies { //应用格式: packageName:artifactId:version compile 'com.google.android:support-v4:r13' } android { } |
android library 依赖
对于项目依赖 android library的话,就不是依赖一个jar,那么简单了,在这里需要使用gradle mulit project 机制。例子的话,我就不重复写了,具体参考上一篇提到的德国人写的例子。记得把插件版本改为 0.4 https://github.com/Goddchen/Android-Gradle-Examples/tree/master/Gradle%20Library%20Projects
注意对于android library build.gradle
记得要把
apply plugin: 'android' 改为 apply plugin: 'android-library'
Mulit project 设置
Mulit project 设置是gradle 约定的一种格式,如果你需要编译某个项目之前,要先编译另外一个项目的时候,就需要用到,结构如下图(来自于官方文档):
MyProject/| settings.gradle+ app/| build.gradle+ libraries/+ lib1/| build.gradle+ lib2/| build.gradle
你需要在你的workplace 目录下面创建settings.gradle 的文件,然后在里面写上:
include ':app', ':libraries:lib1', ':libraries:lib2'
那样,gradle mutil project 就设置完毕。
对于app project 如果需要应用libraries 目录下的 lib1 ,你只需要在app project build.gradle
里面的依赖中这么写:
1 | compile project(':libraries:lib1') |
即可完成,写完以后可以用gradle AndroidDependencies
来检查依赖状况。
需要注意的地方
1 2 3 4 5 6 7 8 9 | buildscript { repositories { mavenCentral() } dependencies { classpath 'com.android.tools.build:gradle:0.4' } } |
对于buildscript{}
在android gradle是用来预置插件环境,一般不建议把依赖写着里面,推荐的依赖写法是:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 | buildscript { repositories { mavenCentral() } dependencies { classpath 'com.android.tools.build:gradle:0.4' } } repositories { //从中央库里面获取依赖 mavenCentral() //或者使用指定的本地maven 库 maven{ url "file://F:/githubrepo/releases" } } dependencies { //应用格式: packageName:artifactId:version compile 'com.google.android:support-v4:r13' } |
使用Maven 管理库
gradle 对于包的管理,支持filesystem,maven,ivy,这里我重点说说如何利用maven 进行android 依赖包的管理
利用Gradle 发布本地maven 库
对于如何打包一个jar 包并且发布到maven,这是java 的基本知识,这里就不说了。
我们现在要学习的是,例如发布一个android library 包。
在过去,android library并没有一个很好的包管理方式,简单来说,在gradle出现以前,官方并没有一种用于管理android library 依赖包的方式,一般我们都是直接下载别人的android library project 源码进行集成,而对于第三方的android-maven-plugin 用的是apklib 格式。
而现在,官方终于推出一种android library的打包格式,扩展名为*.aar
。前面提到,目前android gradle插件并不支持本地直接使用*.aar
文件,不过,支持包管理库的引用方式,下面,我为大家说一下,怎么对android library 发布使用。
-
打包android library
对android library 进行打包直接在library项目下面使用
gradle build
即可,然后,你就会在 build/libs 目录下看到两个*.aar
文件,一个debug包用的,一个是release 下用的,看个人需求使用,这里我们用的是release 版本的 .aar 文件。 -
发布脚本
android library project 目录的 build/libs 下创建一个build.gradle 文件
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
apply plugin: 'maven' group = 'com.youxiachai' artifacts { //当前aar 文件名 archives file('Gradlelib.aar') } uploadArchives { repositories { mavenDeployer { repository(url: "file://F:/githubrepo/releases") pom.version = 'r1' pom.artifactId = 'gradletest' } } }
gradle uploadArchives
即可完成包的发布。
完成以上两步就可以直接用maven 引用jar的依赖那样,引用android library 的依赖。
扩展阅读
Google I/O 2013 上面介绍的android Gralde build System (已经转载到优酷)
Xavier Ducrohet Android SDK Tech Lead,上面那个视频就是这个人演讲的。
adt-dev社区 因为用gradle 构建android 是新系统,一般而言有问题是搜索不到的,有问题还是上社区直接问吧,一般Xavier Ducrohet 都会帮你解决。
作者:游戏阿柴
出处:http://www.cnblogs.com/youxilua
本文采用知识共享署名-非商业性使用-相同方式共享 2.5 中国大陆许可协议进行许可,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文连接。
微博联系:新浪微博
用支付宝赞助博主:http://me.alipay.com/youxilua
#1楼 futurexiong 2013-05-23 13:01
#2楼 星之愿 2013-05-24 21:45
嗯!
#3楼[楼主] youxiachai 2013-05-25 18:49
android library 依赖android library 只是暂时不支持而已。。。而且我也提到了,当初adt 也是过了很久才支持。。。。·“各个ProductFlavor里面的Manifest都得在自身Product目录底下拷贝一份完整的Manifest?”这个是神马意思? ProductFlavor 任务里面,插件会自动修改。而不是完整拷贝
#4楼 futurexiong 2013-05-27 09:44
ProductFlavor里面的Manifest已测试,的确是很简单的把需要merge的信息加进去就行了,整个文件只需要短短几行。
另外“不支持android library 与 android library 的互相引用。不支持android library 打包文件(*.aar) 的本地引用。”这两点经测试可以。compile project和compile files就可以了。
#5楼[楼主] youxiachai 2013-05-27 14:34
能分享一下代码?
用的是最新的0.4.1 ?
compile files('**.aar');
这样可以?
另外:
`不支持android library 与 android library 的互相引用`,我不知道你的引用是怎么组织的,compile project模式是没问题的,但是,在adt-dev google groups 上面有人(ActionBarSherlock 的作者)提了这个问题,sdk 的leader 说要0.5 才能修复,链接在这里 https://groups.google.com/forum/#!topic/adt-dev/wFnAOAmYCSs
#6楼 futurexiong 2013-05-27 14:58
在libA depends on libB的情况下,修改libA的Manifest,加上<application>
</application>
就好了。
.aar的直接引用好像是能编的,记得是成功的,我回去之后再看看。
另外你的这两篇博客已经被山寨并且出处都改了 http://www.chengxuyuans.com/j2ee/61477.html
#7楼[楼主] youxiachai 2013-05-27 17:56
。。。还有这么无耻的网站。。。。除了博客园我还发布了三个地方。。oschina,51cto,还有我的小博客 http://blog.gfdsa.net。。。不过采集网站应该是这样了,连样式都不兼容。。。。
对了aar的本地引用(依赖库引用是没问题的)能遍但是不一定能用。。你的aar 确定里面的资源文件在主项目有相关引用?之前,我也以为能编过,只是因为,项目没有引用library的资源文件而已。
#8楼 老牛啊 2013-05-30 16:43
请问:如何使用Gradle的时候,依赖的Jar把关联源码呢?
#9楼[楼主] youxiachai 2013-05-30 17:58
你这个是IDE 的问题。。不是构建工具干的事情。。。目前而言adt还不支持gradle,你需要哪个android studio
#10楼 MYM]Brooks 2013-08-13 10:18
#11楼[楼主] youxiachai 2013-08-13 10:59
gradle 本来就有这个功能, as 貌似实现完全的gradle,不过,这个我没测试过.我用gralde 只是用来打包而已,