Android新手求助：升级Firebase与GSM依赖时Manifest合并失败

嘿，作为Android新手遇到Manifest合并报错确实挺头疼的，我来帮你一步步排查解决这个问题～

1. 先揪出具体的错误根源 #

这个“Manifest merger failed”的提示只是个笼统的警告，得看详细日志才能知道到底冲突在哪：

• 在Android Studio底部打开「Build」面板，切换到「Merge Errors」标签页，里面会明确列出冲突点——比如重复的权限声明、组件（Activity/Service）冲突，或者依赖库之间的Manifest配置矛盾。
• 如果面板里信息不全，直接在终端运行命令 ./gradlew assembleDebug --info，日志里会输出完整的合并冲突细节。

2. 对齐编译版本与依赖的兼容性 #

你的compileSdkVersion和targetSdkVersion还停留在25，但buildToolsVersion用了27.0.3，而且新版本Firebase通常要求更高的编译版本，这很容易导致不兼容。建议：

• 把编译版本升级到适配最新Firebase的版本（推荐33或34），同时保持buildToolsVersion和compileSdkVersion匹配：

android {
    compileSdkVersion 34
    buildToolsVersion '34.0.0'
    defaultConfig {
        minSdkVersion 21
        targetSdkVersion 34
        // 其他版本号、applicationId等配置不变
    }
}

• 升级后如果提示旧的support库要替换为AndroidX，直接用Android Studio的一键迁移功能就行，跟着提示操作就好。

3. 统一Firebase依赖的版本号 #

Firebase的各个组件版本必须保持一致，不然很容易引发Manifest冲突。比如你用了firebase-analytics、firebase-auth等，要确保它们的版本号相同：

dependencies {
    // 示例：手动统一版本
    implementation 'com.google.firebase:firebase-analytics:21.5.0'
    implementation 'com.google.firebase:firebase-auth:22.3.1'
    // 所有Firebase组件的主版本号要对齐
}

更省心的方式是用Firebase BOM自动管理版本，不用手动逐个写版本号：

dependencies {
    // 导入Firebase BOM
    implementation platform('com.google.firebase:firebase-bom:32.7.0')
    // 直接添加组件，不用写版本号
    implementation 'com.google.firebase:firebase-analytics'
    implementation 'com.google.firebase:firebase-auth'
}

4. 排查GMS（Google Mobile Services）依赖的冲突 #

你提到的GSM应该是GMS吧？如果用到了play-services相关依赖（比如play-services-auth），也要确保版本和Firebase兼容，同样可以用BOM管理：

// 导入Google Play services BOM
implementation platform('com.google.android.gms:play-services-bom:20.1.0')
implementation 'com.google.android.gms:play-services-auth'

5. 手动解决具体的Manifest冲突 #

如果日志里明确指出了冲突点（比如两个依赖库声明了同一个权限、同一个Activity），可以在自己的AndroidManifest.xml里用tools命名空间来处理：
比如解决重复权限：

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" tools:node="replace" />

或者合并重复的组件：

<activity
    android:name="com.example.SomeActivity"
    tools:node="merge" />

注意要在Manifest根标签里先添加tools命名空间：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools">

按照这些步骤一步步来，应该能搞定这个合并报错。如果看完详细日志还有具体的冲突点，再针对性调整就行～

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