如何将混淆Android库的映射文件上传至Crashlytics以反混淆日志？

1. 能否利用库的映射文件对日志进行反混淆？ #

可以。Firebase Crashlytics支持合并多个混淆映射文件完成反混淆，具体操作如下：

• 找到混淆编译Android库时生成的mapping.txt文件（通常在库模块的build/outputs/mapping/release/目录下）；
• 登录Firebase控制台，进入对应应用的Crashlytics页面，找到「映射文件」管理入口，将库的mapping.txt上传到对应版本的应用项目中；
• 注意：每个版本的库对应唯一的mapping.txt，必须上传与崩溃日志匹配的库版本映射文件，否则反混淆结果会出现错误。

上传完成后，Crashlytics会自动结合应用（因应用未混淆，无应用侧映射文件）和库的映射信息，将崩溃日志中来自库的混淆代码还原为原始类名、方法名和行号。

2. 无法直接给库接入Crashlytics的可行方案 #

以下是几种实用的落地方案：

方案一：让应用传递Crashlytics实例给库 #

在库中定义初始化方法，接收应用侧的FirebaseCrashlytics实例，库内部使用该实例完成上报：

// 库中的代码
object MyLibrary {
    private var crashlytics: FirebaseCrashlytics? = null

    fun init(crashlytics: FirebaseCrashlytics) {
        this.crashlytics = crashlytics
    }

    private fun handleException(e: Throwable) {
        crashlytics?.recordException(e)
    }
}

// 应用侧初始化时调用
MyLibrary.init(FirebaseCrashlytics.getInstance())

这种方式无需库依赖Crashlytics SDK，仅需依赖其核心类（可通过provided依赖避免打包进库）。

方案二：库定义通用上报接口，应用适配Crashlytics #

库内部抽象出异常上报的接口，不依赖任何第三方SDK，由应用侧实现接口并对接Crashlytics：

// 库中的代码
interface CrashReporter {
    fun reportException(e: Throwable)
    fun log(message: String)
}

object MyLibrary {
    private var reporter: CrashReporter? = null

    fun setCrashReporter(reporter: CrashReporter) {
        this.reporter = reporter
    }

    fun someRiskyOperation() {
        try {
            // 业务逻辑
        } catch (e: Exception) {
            reporter?.reportException(e)
        }
    }
}

// 应用侧实现
class CrashlyticsReporter : CrashReporter {
    override fun reportException(e: Throwable) {
        FirebaseCrashlytics.getInstance().recordException(e)
    }

    override fun log(message: String) {
        FirebaseCrashlytics.getInstance().log(message)
    }
}

// 应用初始化时设置
MyLibrary.setCrashReporter(CrashlyticsReporter())

这种方式解耦性最强，库可以适配任何上报工具，不止Crashlytics。

方案三：库捕获异常后通过回调传递给应用 #

库中捕获自身异常，通过回调接口传递给应用，由应用统一上报到Crashlytics：

// 库中的代码
object MyLibrary {
    private var exceptionCallback: ((Throwable) -> Unit)? = null

    fun setExceptionCallback(callback: (Throwable) -> Unit) {
        this.exceptionCallback = callback
    }

    private fun onException(e: Throwable) {
        exceptionCallback?.invoke(e)
    }
}

// 应用侧注册回调
MyLibrary.setExceptionCallback { e ->
    FirebaseCrashlytics.getInstance().recordException(e)
}

适合库中异常场景较少的情况，实现简单。

方案四：Gradle插件自动处理映射文件上传 #

如果库以AAR形式发布，可以在库的Gradle配置中，将mapping.txt打包到AAR的指定目录，然后在应用侧编写Gradle任务，自动提取AAR中的映射文件并上传到Firebase。例如：
在库的build.gradle中添加：

android {
    buildTypes {
        release {
            minifyEnabled true
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
            // 将mapping.txt复制到AAR的assets目录
            applicationVariants.all { variant ->
                if (variant.buildType.name == 'release') {
                    def mappingFile = variant.mappingFile
                    if (mappingFile.exists()) {
                        def assetsDir = new File(variant.outputs.first().outputFile.parent, 'assets')
                        assetsDir.mkdirs()
                        copy {
                            from mappingFile
                            into assetsDir
                            rename { 'library-mapping.txt' }
                        }
                    }
                }
            }
        }
    }
}

然后应用侧Gradle任务提取该文件并调用Firebase的上传命令完成自动上传。

内容的提问来源于stack exchange，提问作者Rudolf