过时了!现在东西变化太快了,在4.1.2版本的Android Studio上,这种方式已经不支持了。新版上本地引入aar或jar文件的方式,请参考Create an Android library

1. 背景

前一段时间我在开发中需要用到第三方的控件Android-PickerView,我在build.gradle中的依赖是这么写的:

compile 'com.contrarywind:Android-PickerView:4.1.3'

可以看出这是一个网络库依赖。由于本地配置了网络代理和国内镜像库,除了第一次需要下载慢一些,编译运行没有任何问题。不过在我将代码提交到svn上的时候,jenkins标红了…
在有网情况下,使用网络库依赖没问题,但我们的Jenkins服务器编译要求离线,所使用的gradle版本也相对较低,因此只能就不能使用网络库依赖了。
由于上述依赖并不是纯Java代码,还包括了资源文件,使用aar包依赖比较方便。

2. 使用aar包依赖

较高版本gradle的支持更简单的aar引用方式,不过低版本的gradle却并不能兼容。网上的文章多数都是较高版本gradle使用aar依赖的方式,不过我们的svn上使用的gradle版本较低,这里将描述高低两种版本gradle使用aar依赖的方式。

2.1较高版本gradle中引用aar依赖

这里较高版本gradle使用是gradle 4.1,对应Android Studio gradle 3.0.1插件。高版本gradle上使用aar本地依赖很简单,基本上与jar的依赖方式一致。
1)将所需要的aar包copy到应用所在module的libs目录下
2)在应用所在module里的build.gradle里添加:

compile fileTree(dir: 'libs', include: ['*.aar'])

或者如果同时有jar依赖的话,可以写成:

compile fileTree(dir: 'libs', include: ['*.jar','*.aar'])

2.2较低版本gradle中引用aar依赖

这里较低版本使用的gradle版本是2.2.1,相应的gradle插件版本为1.2.3。使用方式其实也不麻烦。
1)将所需要的aar包copy到应用所在module的libs目录下
2)在应用所在module里的build.gradle添加依赖(以添加的文件pickerview.aar,wheelview.aar为例):

 compile(name: 'pickerview', ext: 'aar')
 compile(name: 'wheelview', ext: 'aar')

然后在在build.gradle最外层添加

repositories {
    flatDir {
        dirs 'libs' //this way we can find the .aar file in libs folder
    }
}

注意低版本gradle 支持

compile fileTree(dir: 'libs', include: ['*.aar'])

这种依赖方式。
高版本gradle可以兼容低版本的这种使用方式。

3. 从网络库依赖中获取aar包

aar包可以很方便的进行离线库依赖。而对于module依赖(Eclipse的项目依赖),也可以将其打包成aar以简化项目的结构。但是很多很多开源库的文档基本都是告诉你添加一句compile 语句进行依赖,例如

compile 'com.contrarywind:Android-PickerView:4.1.4'

搜索下载aar包,有些网络环境下却并不容易找到合适的aar包下载。如何比较容易的获取到需要的aar包呢?以下以PickerView为例描述。

3.1 添加网络库依赖

根据开源库文档,在module的build.gradle中添加网络库依赖

compile 'com.contrarywind:Android-PickerView:4.1.3'
  • 点击编译,编译时候打开网络,必要时添加国内镜像库。编译好后aar文件就已经在本地缓存里有了。

    3.2 从缓存中复制aar文件

    上述编译好后将Android Studio切换到Project视图模式。
  • 展开External Libraries,可以在里面找到com.contrarywind:Android-PickerView-4.1.3和com.contrarywind:wheelview-4.0.5
  • 右键选择Library Properties可以找到依赖包的缓存目录
  • 复制路径后并从文件管理进入到该文件所在目录的父级目录。这里要注意的一点是我们要使用的不是里面罗列的jar文件。
  • 在该目录地下找到某个目录中所包含的aar文件,我这里是
Android-PickerView-4.1.3.aar

将该文件copy出来备用
以同样的方式获取并copy出

wheelview-4.0.5.aar

这两个aar文件就可以以作为aar依赖离线引用了。
注意:以上使用的是Android Studio3.0.1进行的操作。如果用的Android Studio版本较低,右键可能没有Library Properties这一选项。这种情况下,可以在setting中找到缓存根目录,如

C:\Users\user\.gradle\

进入到缓存根目录后,进入到

C:\Users\user\.gradle\caches\modules-2\files-2.1\

通过添加时间等方式,找到刚刚从网上下载的aar文件根目录。
比如我们这个案例就在com.contrarywind目录下,很容易可以找到所需的两个aar文件。

对于获取到的aar文件,修改文件名也可以使用。

4. 总结

  • 搜索工具使用的优先级会影响效率。刚开始使用搜狗搜索到许多排名靠前的文章对我有较大误导,最后还是在stackoverflow上找到了答案。
Logo

权威|前沿|技术|干货|国内首个API全生命周期开发者社区

更多推荐