Android应用集成Google Maps时API密钥重复冲突问题解决方案咨询

嘿，我之前也碰到过一模一样的问题！当主应用和引入的AAR依赖库都在Manifest里配置了Google Maps的API密钥时，Android的Manifest合并机制就会抛出重复条目错误。这里有几个实用的解决办法，你可以根据自己的情况挑选：

方法一：用tools:replace强制覆盖依赖库的密钥配置 #

这是最直接的处理方式，利用Android的Manifest合并工具，让主应用的API密钥配置直接覆盖掉依赖库中的重复条目。

你只需要在主应用Manifest的<meta-data>标签里添加tools:replace="android:value"属性就行——看你的Manifest片段已经声明了tools命名空间，直接用就好：

<meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="你的主应用API密钥"
    tools:replace="android:value" />

这个属性会告诉构建工具：用主应用的android:value值替换掉依赖库中同名<meta-data>的对应属性，从根源上避免重复冲突。

方法二：移除依赖库Manifest中的API密钥配置（如果有权限修改依赖库） #

如果这个AAR库是你自己维护的，那最彻底的解决方式就是直接删掉库Manifest里的API密钥<meta-data>条目。这样主应用只需要配置一次密钥，既不会有冲突，也能保证整个应用只用同一个密钥调用Maps服务。

方法三：用Gradle Manifest占位符动态注入密钥（更灵活的方案） #

这个方法适合需要多环境切换密钥，或者不想在Manifest里硬编码密钥的场景。

1. 首先在Module级别的build.gradle（不是Project级）的defaultConfig中添加Manifest占位符：

android {
    defaultConfig {
        // 其他原有配置...
        manifestPlaceholders = [GOOGLE_MAPS_API_KEY: "你的API密钥"]
    }
}

2. 然后在主应用和依赖库的Manifest里，都用占位符代替硬编码的密钥值：

<meta-data
    android:name="com.google.android.geo.API_KEY"
    android:value="${GOOGLE_MAPS_API_KEY}" />

构建时Gradle会自动把占位符替换成你配置的密钥，而且因为两个Manifest里的条目内容完全一致，合并时就不会出现冲突了。

小提醒 #

• 别忘了确认你的API密钥已经在Google Cloud控制台开启了Maps相关的API权限，不然就算配置对了也没法正常使用。
• 如果用了方法一，记得不要在主应用里重复添加多个同名的<meta-data>条目哦！

内容的提问来源于stack exchange，提问作者Fabian Mizieliński