当前位置：首页 > news >正文

安卓官方版fat-aar:使用Fused Library将多个Android库发布为一个库

news 2025/7/5 5:02:57

安卓官方版fat-aar:使用Fused Library将多个Android库发布为一个库 - Wesley’s Blog

在开发 sdk 时，内部一般会划分好几个模块。但当需要打包成一个模块发布时，往往需要依赖第三方插件。比如著名的 fat-aar：https://github.com/kezong/fat-aar-android，但该库不支持 AGP8.0 了，有其他开发者单独fork了一个仓库来进行维护，支持 AGP8.0+：aasitnikov/fat-aar-android: Gradle plugin for merging android libraries (AAR)。

现在安卓官方终于支持将多个库打包成一个aar 了：Publish multiple Android libraries as one with Fused Library | Android Studio | Android Developers。宣布从 AGP8.12 开始可以使用com.android.fused-library来进行合并多模块。不过从Maven Repository: com.android.fused-library » com.android.fused-library.gradle.plugin上面可以看到，一些早期版本也可以支持的，不过可能有 bug，我试了 AGP8.10 也是可以的。

相比 fat-aar 的优点是：

官方支持
合并模块时支持依赖传递，也就是子模块的依赖树会出现在 pom 文件里面。fat-aar 需要通过pom.withXml 来处理。

缺点是：

支持插件版本有限，官方表示是AGP8.12 开始才支持。
传递依赖项不会打包。需要逐个指定打包进 aar 的依赖。

后面还会继续说该库目前的问题，先看看怎么用。

官方的工程示范：

readme 的插件名称目前是写错了的：应该是com.android.fused-library

gradle-recipes/applyFusedLibraryPlugin at agp-8.10 · android/gradle-recipes

可以参考这个进行插件引入：

Publish multiple Android libraries as one with Fused Library | Android Studio | Android Developers

问题

嵌套依赖不支持打包

官方的例子是支持嵌套的：

* indicates an include dependency of the :fusedLibrary module

┌─────────────────────────────────────────┐
│             :app                        │
│               ▲                         │
│               │                         │
│         :fusedLibrary                   │
│         ▲           ▲                   │
│         │           │                   │
│    :androidLib2*  :androidLib1*         │
│         ▲            ▲                  │
│         │            │                  │
│ :androidLib3 com.google.code.gson:gson* │
└─────────────────────────────────────────┘

dependencies {include(project(":androidLib1"))include(project(":androidLib2"))include("com.google.code.gson:gson:2.10.1")include(files("libs/simple-jar-with-A_DoIExist-class.jar"))
}

实际上androidLib3 没有被打包，变成了一个依赖fused-library-samples:androidLib3:unspecified：

{"included": ["project :androidLib1","project :androidLib2","com.google.code.gson:gson:2.10.1"],"dependencies": ["org.jetbrains.kotlin:kotlin-stdlib:1.9.22","org.jetbrains:annotations:13.0","fused-library-samples:androidLib3:unspecified"]
}

有一些远程包暂时打包不了

A failure occurred while executing com.android.build.gradle.tasks.FusedLibraryMergeArtifactTask$FusedLibraryMergeArtifactWorkAction

> java.lang.NullPointerException (no error message)

暂不支持携带源码发布

暂不能混淆

不支持Databinding

无法在单个融合库中融合多个 build 类型和产品变种。需要为不同的变体创建单独的融合库。

kotlin_module冲突

如果有两个base模块会产生冲突， base/base ，feature/base

2 files found with path ‘META-INF/base_release.kotlin_module’ from inputs:

需要修改一下kotlin_module 的名字

android - Duplicate files copied in APK META-INF/library_release.kotlin_module - Stack Overflow

ext {GROUP_ID = 'custom.group.id'ARTIFACT_ID = 'artifactid'
}android {compileSdkVersion 25buildToolsVersion "25.0.0"compileOptions {kotlinOptions.freeCompilerArgs += ['-module-name', "$GROUP_ID.$ARTIFACT_ID"]}defaultConfig {...}buildTypes {...}
}