https://yangbo.tech/2015/10/17/all-about-aar/
背景
在软件工程中，分治是最基本的设计原理，就如同现实中的砖、瓦、钢筋、水泥一样，模块化、组件化的分工，让我们整个软件世界变得井井有序，丰富多彩。
Java jar
在Java开发中，添加组件简单的以添加jar文件依赖为途径，jar有两个含义：
- jar文件格式：Java Archive，就是zip文件格式，文件名后缀是jar，包含了java class，metadata，资源（文本、图片等）。
- Java archive tool: JDK中的工具，用来生成jar包的工具。
jar在Android开发中的不足
在Android应用资源中，Java Source，Resouce以及所需的so文件和jar包，用jar格式可以很好的处理Java Source,但对于目录比较复杂的Android Res目录，二进制依赖so文件和jar包则显得的乏力。当你收到一个第三方SDK zip包，要添加到自己的项目中，解压后是一个jar包和一堆文件夹，不停的复制粘贴甚至解决冲突的时候，心里肯定开始不满意这血吸虫组件分发方式了。
aar
什么是aar
为了解决Android开发中组件引用的问题，引入aar格式。也是简单的zip格式。
定义：The ‘aar’ bundle is the binary distribution of an Android Library Project.
Zip包中的内容有：
- /AndroidManifest.xml (mandatory)
- /classes.jar (mandatory)
- /res/ (mandatory)
- /R.txt (mandatory)
- /assets/ (optional)
- /libs/*.jar (optional)
- /jni//*.so (optional)
- /proguard.txt (optional)
- /lint.jar (optional)
其中，R.txt是aapt –output-text-symbols命令的输出。
生成aar
在Android Studio1.4中，New project，先默认新建一个Applicaton module，接后File > New > New
Module，选择Androd
Library > Next，指定Library
Name和Module Name。
新建的Library与正常的Application最大区别是module build.gradle中是apply plugin: ‘com.android.library’ 而不是 apply plugin: ‘com.android.application’.
Build > Make
project(⌘F9),自动生成aar文件。
|
1 2 3 4 5
|
| build | outputs | aar | mylibrary-debug.aar | mylibrary-release.aar
|
使用aar
aar可通过以下三种方式引入到项目中：
- 公共Maven仓库
- 私有Maven仓库
- 复制粘贴aar文件
前两种引入方式涉及到Gradle发布Library到Maven，另文介绍。
重点介绍第三种方式： - 把aar粘贴到要引入库的Application Module/libs目录下，如没有libs目录，创建就好。注意要在Application Module根目录下，不是Project根目录下。
- 在Application Module/build.gradle中添加
12345repositories {flatDir {dirs 'libs'}}
flatDir repositories用来声明文件目录做为依赖库，’libs’路径是build.gradle的相对路径，目录名称可以任意，也可以同时声明多个dirs。
- 在Application Module/build.gradle中添加依赖
123dependencies {compile(name:'mylibrary-debug', ext:'aar')}
关于AndroidManifest.xml合并
在上文中看到aar文件中还包含了库中的AndroidManifest.xml文件，但是最终应用APK中只能有一个AndroidManifest.xml，就涉及到应用AndroidManifest.xml和所有库AndroidManifest.xml的合并。
合并顺序：
- 1.与Produt flavors和build types指定的清单文件
- 2.application module的主清单文件
- 3.library module的清单文件
大多数情况下合并不会造成什么问题，如果发现合并后出现了问题：
- 检查最终的AndroidManifest.xml
- 检查合并报告（appuildoutputslogs），日志文件的格式和内容
后记
本文中所用的项目代码托管在github。
引用
AAR File Format
http://tools.android.com/tech-docs/new-build-system/aar-format
Manifest merging user guide
http://tools.android.com/tech-docs/new-build-system/user-guide/manifest-merger