Android多设备多module打包fat-aar的方法是什么

在Android开发中，随着项目规模的扩大，我们通常会采用多module的方式来组织代码。这种方式有助于代码的模块化和复用，但在打包发布时，可能会遇到一些问题，尤其是当我们需要将多个module打包成一个fat-aar（即包含所有依赖的aar文件）时。本文将详细介绍如何在Android项目中实现多设备多module打包fat-aar的方法。

1. 什么是fat-aar

fat-aar是指一个包含了所有依赖的aar文件。通常情况下，一个aar文件只包含当前module的代码和资源，而不包含其依赖的其他module或第三方库。fat-aar则将这些依赖一并打包进去，使得使用这个aar的项目不需要再额外引入这些依赖。

2. 为什么需要fat-aar

在某些场景下，我们可能需要将多个module打包成一个fat-aar，例如：

• 简化依赖管理：将多个module打包成一个aar，可以减少使用方的依赖配置。
• 保护代码：将多个module打包成一个aar，可以隐藏内部实现细节，只暴露必要的接口。
• 发布SDK：当我们需要发布一个SDK时，通常希望将所有依赖打包成一个aar，方便第三方集成。

3. 实现fat-aar的方法

在Android项目中，实现fat-aar的方法主要有以下几种：

3.1 使用fat-aar插件

目前，社区中有一些开源的fat-aar插件可以帮助我们实现多module打包fat-aar的需求。其中最常用的是fat-aar插件。

3.1.1 引入fat-aar插件

首先，在项目的根目录下的build.gradle文件中引入fat-aar插件：

buildscript {
    repositories {
        google()
        mavenCentral()
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:7.0.2'
        classpath 'com.github.kezong:fat-aar:1.3.6'
    }
}

3.1.2 配置module

接下来，在需要打包的module的build.gradle文件中应用fat-aar插件，并配置需要打包的依赖：

apply plugin: 'com.android.library'
apply plugin: 'com.kezong.fat-aar'

android {
    compileSdkVersion 30
    defaultConfig {
        minSdkVersion 21
        targetSdkVersion 30
        versionCode 1
        versionName "1.0"
    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    implementation 'androidx.appcompat:appcompat:1.3.1'
    embed project(':module1')
    embed project(':module2')
    embed 'com.squareup.retrofit2:retrofit:2.9.0'
}

在上面的配置中，embed关键字用于指定需要打包到fat-aar中的依赖。

3.1.3 打包fat-aar

配置完成后，执行以下命令即可打包fat-aar：

./gradlew :module:assembleRelease

打包完成后，生成的aar文件将包含所有指定的依赖。

3.2 手动合并aar

如果不想使用第三方插件，也可以手动合并aar文件。这种方法相对复杂，但可以更灵活地控制打包过程。

3.2.1 解压aar文件

首先，将需要合并的aar文件解压：

unzip module1.aar -d module1
unzip module2.aar -d module2

3.2.2 合并代码和资源

将解压后的代码和资源文件合并到一个目录中。例如，将module1和module2中的classes.jar合并：

mkdir -p merged/jars
cp module1/classes.jar merged/jars/classes1.jar
cp module2/classes.jar merged/jars/classes2.jar
cd merged/jars
jar -xf classes1.jar
jar -xf classes2.jar
jar -cf classes.jar .

3.2.3 合并AndroidManifest.xml

将module1和module2中的AndroidManifest.xml文件合并。可以使用工具如manifest-merger来自动合并：

java -jar manifest-merger.jar --main module1/AndroidManifest.xml --libs module2/AndroidManifest.xml --out merged/AndroidManifest.xml

3.2.4 重新打包aar

最后，将合并后的文件重新打包成aar：

cd merged
zip -r ../merged.aar .

3.3 使用Maven发布fat-aar

如果项目使用Maven进行依赖管理，可以通过Maven将多个module打包成一个fat-aar并发布到Maven仓库。

3.3.1 配置pom文件

在需要打包的module的build.gradle文件中，配置Maven发布信息：

apply plugin: 'maven-publish'

publishing {
    publications {
        maven(MavenPublication) {
            groupId 'com.example'
            artifactId 'fat-aar'
            version '1.0.0'
            artifact("$buildDir/outputs/aar/module-release.aar") {
                builtBy tasks.assemble
            }
            pom.withXml {
                def dependenciesNode = asNode().appendNode('dependencies')
                configurations.embed.allDependencies.each { dep ->
                    def dependencyNode = dependenciesNode.appendNode('dependency')
                    dependencyNode.appendNode('groupId', dep.group)
                    dependencyNode.appendNode('artifactId', dep.name)
                    dependencyNode.appendNode('version', dep.version)
                }
            }
        }
    }
    repositories {
        maven {
            url "https://maven.example.com/repository/internal/"
            credentials {
                username = 'user'
                password = 'password'
            }
        }
    }
}

3.3.2 发布fat-aar

执行以下命令将fat-aar发布到Maven仓库：

./gradlew publish

4. 注意事项

在实现fat-aar的过程中，需要注意以下几点：

• 依赖冲突：当多个module依赖同一个库时，可能会出现依赖冲突。需要手动解决这些冲突，确保最终打包的aar中只包含一个版本的库。
• 资源冲突：多个module中可能存在同名的资源文件，这会导致资源冲突。可以通过重命名资源文件或使用资源前缀来解决。
• ProGuard配置：如果使用了ProGuard进行代码混淆，需要确保所有module的ProGuard配置都正确合并。

5. 总结

在Android项目中，实现多设备多module打包fat-aar的方法有多种，包括使用fat-aar插件、手动合并aar文件以及使用Maven发布fat-aar。每种方法都有其优缺点，开发者可以根据项目需求选择合适的方法。无论选择哪种方法，都需要注意依赖冲突、资源冲突和ProGuard配置等问题，以确保最终打包的aar文件能够正常使用。

通过本文的介绍，相信读者已经对Android多设备多module打包fat-aar的方法有了更深入的了解。希望这些方法能够帮助你在实际项目中更好地管理和发布aar文件。