如何避免build.gradle中applicationId覆盖AndroidManifest.xml的包名？

核心原理 #

Android Gradle 插件中，applicationId（build.gradle中配置）和 Manifest 里的package属性是两个独立的概念：

• applicationId：应用在系统、Google Play 中的唯一标识，用于发布和区分不同应用。
• Manifest 的package：作为资源命名空间，决定 R 类的包名、Manifest 中组件的相对路径（如.MainActivity对应此包下的类），默认与applicationId一致，但可独立配置。

构建过程中，插件会自动生成调整后的 Manifest（位于build/intermediates目录下），但原始的src/main/AndroidManifest.xml不会被修改——你看到的"覆盖"只是构建产物中的临时文件，原始文件的包名始终保持原样。

具体配置步骤 #

如果需要修改applicationId但保留原始 Manifest 的包名，只需按以下操作：

1. 保留原始 Manifest 的包名：不要手动修改src/main/AndroidManifest.xml中的package属性，保持你想要的固定值，比如：

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.you.original.package">
    <!-- 其他内容 -->
</manifest>

2. 在 build.gradle 中设置新的 applicationId：打开模块级别的build.gradle（通常是app/build.gradle），在android.defaultConfig块中指定新的applicationId，比如：

android {
    defaultConfig {
        applicationId "com.you.new.appid" // 你的新应用ID
        minSdkVersion ...
        targetSdkVersion ...
        versionCode ...
        versionName ...
    }
}

3. 验证效果：构建应用后，原始的src/main/AndroidManifest.xml包名不会改变，而应用的实际ID（用于安装、发布）是你设置的applicationId。你可以通过以下方式确认：
   • 查看build/outputs/apk/目录下的APK，用APK分析器查看其AndroidManifest.xml，其中package（资源命名空间）还是原始值，而应用ID对应applicationId字段。
   • 安装应用后，在系统设置的应用信息中查看应用包名，显示的是applicationId的值。

特殊场景处理 #

如果你的 Manifest 中使用了硬编码的包名（如在<provider>的authorities属性中），可以用 Gradle 占位符替换，避免与applicationId混淆：

1. 在 build.gradle 中添加占位符：

android {
    defaultConfig {
        manifestPlaceholders = [AUTHORITY: "${applicationId}.provider"]
    }
}

2. 在 Manifest 中引用占位符：

<provider
    android:name=".MyProvider"
    android:authorities="${AUTHORITY}"
    ... />

这样既保证了组件属性与applicationId同步，又不会影响原始 Manifest 的包名。

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