从 SSP 配置到 Gradle 同步：Android SDK 开发中 Manifest 合并冲突的踩坑记录

理解 Manifest 合并冲突

Manifest 合并冲突通常发生在多个模块或依赖项中定义的 AndroidManifest.xml 文件存在重复或冲突的属性。例如，不同的模块可能定义了相同的 activity 或 service，但属性不一致。合并工具无法自动解决这些冲突，导致构建失败。

检查冲突来源

冲突通常来源于以下场景：

主模块和库模块定义了相同的组件（如 activity）但属性不同。
多个第三方依赖库定义了相同的权限或组件。
使用动态功能模块时，主模块和动态模块的 Manifest 冲突。

解决冲突的方法

使用 tools:replace 属性 在冲突的属性上添加 tools:replace 可以指定需要替换的属性。例如：

XML 复制代码

<activity
    android:name=".MainActivity"
    android:theme="@style/AppTheme"
    tools:replace="android:theme" />

使用 tools:remove 属性 如果某些属性需要完全移除，可以使用 tools:remove：

XML 复制代码

<activity
    android:name=".MainActivity"
    tools:remove="android:theme" />

合并规则标记 通过 tools:node 属性可以控制合并行为：

merge：默认行为，合并属性。
remove：移除当前节点。
replace：完全替换目标节点。

XML 复制代码

<activity
    android:name=".MainActivity"
    tools:node="replace" />

调试合并冲突

查看合并日志 在 Gradle 构建时添加 --debug 参数可以查看详细的合并日志：

bash 复制代码

./gradlew assembleDebug --debug

生成合并报告 在 app 模块的 build.gradle 中添加以下配置，生成合并报告：

groovy 复制代码

android {
    applicationVariants.all { variant ->
        variant.outputs.each { output ->
            output.processManifest.doLast {
                def manifestPath = "$manifestOutputDirectory/AndroidManifest.xml"
                def mergedManifest = file(manifestPath).text
                def reportPath = "$buildDir/outputs/logs/manifest-merger-${variant.name}-report.txt"
                file(reportPath).write(mergedManifest)
            }
        }
    }
}

避免冲突的最佳实践

尽量减少在库模块中定义组件，主模块应负责定义核心组件。
使用唯一包名或前缀避免组件名称冲突。
定期检查依赖库的 Manifest 文件，确保没有重复定义。
使用 Android Studio 的 Manifest Merging Tool 可视化工具分析冲突。

示例：解决常见冲突

冲突场景 主模块和库模块都定义了 android:icon 和 android:label，但值不同。

解决方案 在主模块的 AndroidManifest.xml 中添加 tools:replace：

XML 复制代码

<application
    android:icon="@mipmap/ic_launcher"
    android:label="@string/app_name"
    tools:replace="android:icon,android:label" />

通过以上方法，可以高效解决 Manifest 合并冲突问题。