AndroidStudio 如何使用aar详解
一. 简介
aar 是一个类似于 jar 的文件格式。但是他们之间是有区别的。
jar :仅仅包含class和清单文件,没有资源文件。
aar :包含了class文件和资源文件。说白了就是android的专属“jar”
将代码打包成aar文件,可以在一定程度上加快 androidstudio 的速度。
尤其是将 module 打包成 aar 文件,提升的效果很显著。
二. 如何得到aar
1. module的aar文件
将一个androidstudio项目中的 module 打包成 aar 其实很简单。
在每一个 module 的目录下面都会有这样一个文件夹: build\outputs\aar 。
这个文件夹下面就放着这个 module 对应的 aar 文件。
一般情况下会有两个 aar 文件,一个 debug 版本,一个 release 版本。
我们选择 release 的就ok。
aar文件图示
注意:
新建的module是没有这个文件夹的。这时,你可以使用 两种方法 生成这个文件夹
将整个项目运行一遍,这个文件夹会自动生成
执行命令 ./gradlew assemblerelease 也可以生成这个文件夹
2. 远程仓库的aar
在项目里面经常会引用一下远程仓库的依赖库。
这时,我们也可以将它以 aar 的形式引入到项目中。
这个依赖库的aar其实也很好找。
当你配置好一个依赖库以后,点击 sync now 。
androidstudio会自动下载这个库到c盘(windows)。你找到这个文件就可以了。
这里我使用的是 everything 进行搜索,很方便就找到这个库的下载文件夹。其他操作系统就自行搜索吧,总之找见这个项目的下载文件夹就ok。
这个下载文件夹中包含了这个项目所需要的所有东西:包括 aar 、 jar 等文件。
后面会以一个例子详细讲解这个过程
注:
everything是一个搜索软件,可以瞬间搜索全盘。
是一个非常实用的软件。但是很可惜只有windows版本。
官网地址:
三. 如何使用aar
想要使用aar文件,需要经过以下几步:
1. 在app的build.gradle中加入以下配置
repositories { flatdir { dirs 'libs' // aar目录 } }
2. 将aar文件拷贝到app/libs目录下
3. 在dependencies中加入aar引用
compile(name: 'zbar-release', ext: 'aar')
四. leakcanary项目示例
因为module的例子比较简单,所以选择远程代码库作为示例。
这里使用一个经常使用的内存检测项目 leakcanary 来做一个示例。
我们通常使用依赖来使用这个库:
debugcompile 'com.squareup.leakcanary:leakcanary-android:1.3'
releasecompile 'com.squareup.leakcanary:leakcanary-android-no-op:1.3'
当 sync now 完成后,我们可以在c盘(windows)找见这个项目文件夹。
该项目文件夹截图如下:
leakcanary项目示例图
这个文件夹下面就有我们需要的两个依赖库: leakcanary-android 和 leakcanary-android-no-op
点开 leakcanary-android文件夹 ,目录结构如下( 1.3是对应的版本号 ):
leakcanary-android文件夹
打开最里层的文件夹,你会发现文件的类型主要有三种:
- jar文件 :有的项目是以jar文件形式提供
- aar文件 :有的项目是以aar文件形式提供
- pom文件 : (project object model),实际上就是个xml,是对一些必要信息的说明。这里我们只关心一个节点信息: <dependencies>:声明依赖列表
我们用文本编辑器打开 leakcanary-android文件夹 下面的pom文件:
... <dependencies> <dependency> <!--包组 id,通常是发布者拥有的域名的反向,以免跟别人的重复--> <groupid>com.squareup.leakcanary</groupid> <!--包 artifactid,其实就是组以下应该有一个更小的归类--> <artifactid>leakcanary-analyzer</artifactid> <!--版本号--> <version>1.3</version> <scope>compile</scope> </dependency> </dependencies> ...
想更多了解pom文件,
当我们打开 leakcanary-android 的pom文件,
我们发现 leakcanary-android 依赖于 leakcanary-analyzer 的1.3版本。
同样的的我们打开 leakcanary-analyzer 的pom文件,
发现 leakcanary-analyzer 依赖 leakcanary-watcher 和 haha 。
leakcanary-watcher 和 haha 则没有依赖任何东西。
这样整个leakcanary-android导入本地的东西就是四个:
- leakcanary-android
- leakcanary-analyzer
- leakcanary-watcher
- haha
同样的方式去一层一层解析 leakcanary-android-no-op ,将所有需要的文件都导入到androidstudio中。这样整个 leakcanary 就被我们真正实现本地化了。
两种结果对比如下:
debugcompile 'com.squareup.leakcanary:leakcanary-android:1.3'
releasecompile 'com.squareup.leakcanary:leakcanary-android-no-op:1.3'
debugcompile(name: 'leakcanary-android-1.3', ext: 'aar')
compile files('libs/leakcanary-analyzer-1.3.jar')
compile files('libs/leakcanary-watcher-1.3.jar')
compile files('libs/haha-1.1.jar')
releasecompile(name: 'leakcanary-android-no-op-1.3', ext: 'aar')
这样就将整个leakcanary项目完全转换成了本地的依赖。