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

在开发 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 25
    buildToolsVersion "25.0.0"

    compileOptions {
        kotlinOptions.freeCompilerArgs += ['-module-name', "$GROUP_ID.$ARTIFACT_ID"]
    }

    defaultConfig {
        ...
    }
    buildTypes {
        ...
    }
}

官方已知问题

融合库是一个新插件，我们正在解决一些已知问题，以实现所有用例。

• 合并的 AAR 中未包含 lint.jar 文件
• 向其他 .aar 文件添加文件依赖项
• 不支持合并 RenderScript 和 Prefab 工件

期待官方进一步完善。