需要打包 aar 的 lib 模块如果需要依赖其他 aar、依赖库,可以使用 fat-aar-android 插件,但是项目不再维护,不支持 gradle 8 以上
8.0 以上可以使用其 fork 项目 fat-aar-android,不过测试 8.2 的时候,发布的版本没成功,最终在 issuse 找到对应版本
AGP 8.2 导入插件依赖
- settings.gradle
pluginManagement {
repositories {
...
maven {
setUrl("https://jitpack.io")
content { includeGroup("com.github.aasitnikov") }
}
}
}
- build.gradle
buildscript {
dependencies {
classpath "com.github.aasitnikov:fat-aar-android:ce932b38ef"
}
}
plugins {
id 'com.android.application' version '8.2.0' apply false
id 'com.android.library' version '8.2.0' apply false
}
其余的内嵌 aar、依赖、模块打包 aar 的方式请参考 fat-aar-android 示例
dependencies {
implementation fileTree(dir: 'libs', include: '*.jar')
// java dependency
embed project(path: ':lib-java', configuration: 'default')
// aar dependency
embed project(path: ':lib-aar', configuration: 'default')
// aar dependency
embed project(path: ':lib-aar2', configuration: 'default')
// local full aar dependency, just build in flavor1
flavor1Embed project(path: ':lib-aar-local', configuration: 'default')
// local full aar dependency, just build in debug
debugEmbed (name:'lib-aar-local2', ext:'aar')
// remote dependency
implementation 'com.google.guava:guava:20.0'
// remote aar dependency
embed ('com.facebook.fresco:fresco:1.12.0') {
// exclude any group or module
// exclude(group:'com.facebook.soloader', module:'soloader')
}
// remote aar dependency
embed ('com.github.bumptech.glide:glide:4.11.0') {
// If transitive = false, it will not embed dependencies declared in pom.xml
// If fataar.transitive = false, There is no need to declare.
transitive = false
}
// don't want to embed in
implementation('androidx.appcompat:appcompat:1.6.1')
}
-------- 下面是早期 gradle 打包 aar 方式,较新的 gradle 版本不再支持 --------
演示Demo中创建了两个 Library Module,其中A不包含第三方依赖库,B包含;笔者将在下面介绍两种类型的打包,并在app module中引用

一、不包含第三方依赖的打包
如果需要打包的中没有引入任何的第三方依赖库,或者打包出来的aar在其他项目中并不需要用到依赖的三方库,可以使用该方式打包;否则请看下面 包含第三方依赖的打包
1. Android Studio 打开右侧的 Gradle 面板,选择需要打包的module —> Tasks —> build, 双击 assemble

2. Build Successed 之后,将会在module的build/outputs/aar目录下生成 debug 和 release 两个版本的 aar包

3. 在 app module 中引用 libraryA,先将刚才生成的aar拷贝到 app module 的 libs目录下

4. 在打开app module 的 build.gradle, 添加如下红色框中内容

repositories {
flatDir{ dirs 'libs' }
}
compile(name: 'librarya-debug', ext: 'aar')
二、包含第三方依赖的打包
如果library中引用了第三方的依赖包,再采用上面的方式,编译时将会提示说一些第三方的类文件找不到了。所以此时需要将library打成本地或远程的aar仓库,然后在项目中引用;
1. 打开 library 的 build.gradle 文件,在最外层加入如下内容
apply plugin: 'maven'
// 省略其他配置
uploadArchives{
repositories.mavenDeployer{
// Ubuntu本地仓库路径, Windows 为(url:"file://D://***/***/***/")
repository(url:"file:/home/jinyx/develop/other/")
// 唯一标识
pom.groupId = "com.jinyx"
// 项目名称
pom.artifactId = "libraryB"
// 版本号
pom.version = "1.0"
}
}
2. 同样的,打开Android Studio右侧的Gradle面板,双击 module下面的 Tasks/upload/uploadArchives

3. BUILD SUCCESSFUL之后,本地刚才配置的仓库路径中将会生成aar相关的文件

4. 在app module中引用aar,首先在根目录的 build.gradle 的仓库配置中加入本地仓库地址,然后在app module 的bulid.gradle 中添加 项目依赖
// 添加到 root 的 build.gradle
maven{
url 'file:/home/jinyx/develop/other/'
}
// 添加到 app 的 build.gradle,注意名字规则和上面配置本地仓库之间的关联
implementation 'com.jinyx:libraryB:1.0'
远程仓库的就不说了,只是将上面配置的仓库地址 换成线上的
三、补充说明
打包的module需要是 library,如果是 application的module,需要将 build 配置中的 apply plugin: 'com.android.application' 替换成 apply plugin: 'com.android.library',并且去掉applicationId
打包的module下的清单文件,application标签下的android:name、android:roundIcon、android:icon三个属性需要移除,避免和引用的项目中的清单文件产生冲突。同样的,由于aar将资源文件也打包在里面,所以需要避免和引用的项目重名,造成资源冲突
如果是打包的app模块,一般会有自定义的Application,用于一些SDK的初始化等操作,但是上面说到android:name属性需要移除,所以引用aar的项目的application,需要继承aar中原先的application,或者是实现里面的初始化等内容
上面提到,application模块打包成aar时,需要移除applicationId,所以问题来了;Android7.0对文件访问的限制,需要添加 File Provider,其中使用差值表达式引用了applicationId
<provider
android:name="android.support.v4.content.FileProvider"
android:authorities="${applicationId}.file.provider"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/boxing_file_provider" />
</provider>
如果 build.gradle 中没有定义 applicationId,那么编译时会把 AndroidManfest 中的packageName 作为 applicationId