Flutter中使用flutter_dotenv存储Google Maps API密钥时，如何在AndroidManifest.xml中安全使用该密钥？

我之前在开发Flutter地图应用时，完全碰到过和你一样的头疼问题！想用dotenv藏密钥，但AndroidManifest又没法直接读Flutter的dotenv变量，试了几个方案要么密钥暴露要么太麻烦，最后终于找到个既安全又省心的办法——用Gradle来做中间层，构建时动态注入密钥，不会把明文留在任何提交到仓库的文件里。

具体操作步骤： #

1. 确保.env文件配置正确
   首先确认项目根目录下的.env文件已经配置好你的Google Maps密钥，格式如下：

   GOOGLE_MAPS_API_KEY=your_secure_api_key_here
   

   重点！一定要把.env添加到项目的.gitignore文件里，绝对不能把这个文件提交到代码仓库！

2. 修改Android模块的build.gradle文件
   打开android/app/build.gradle（注意是app子模块下的这个文件，不是项目根目录的build.gradle），在android代码块中加入读取.env文件的逻辑：

   android {
       // ... 保留你已有的其他配置
   
       // 读取项目根目录下的.env文件
       def dotenvProperties = new Properties()
       file("../../.env").withInputStream { inputStream ->
           dotenvProperties.load(inputStream)
       }
   
       defaultConfig {
           // ... 保留你已有的其他配置
   
           // 配置manifest占位符，让AndroidManifest可以引用
           manifestPlaceholders = [
               googleMapsApiKey: dotenvProperties.getProperty("GOOGLE_MAPS_API_KEY")
           ]
   
           // 可选：同时将密钥加入BuildConfig，方便在Android原生代码中直接调用
           buildConfigField "String", "GOOGLE_MAPS_API_KEY", "\"${dotenvProperties.getProperty("GOOGLE_MAPS_API_KEY")}\""
       }
   }
   

   这里的路径../../.env是因为app模块的build.gradle位于android/app/目录下，需要向上两级才能到项目根目录的.env文件，如果你的.env位置不同，对应调整路径即可。

3. 在AndroidManifest.xml中使用占位符
   打开android/app/src/main/AndroidManifest.xml，找到配置Google Maps API密钥的meta-data标签，将value替换为Gradle配置的占位符：

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

为什么这个方案安全可靠？ #

• 密钥只存放在本地的.env文件中，只要你正确配置了.gitignore，这个文件就不会被提交到代码仓库，从根源上避免了密钥泄露。
• Gradle仅在构建过程中临时将密钥注入到构建产物，不会修改你仓库中原始的AndroidManifest.xml文件——你提交到仓库的AndroidManifest里始终只有${googleMapsApiKey}这个占位符，不会出现明文密钥。
• 这个方案和flutter_dotenv完全兼容，你在Flutter Dart代码里依然可以正常使用dotenv.env['GOOGLE_MAPS_API_KEY']来读取密钥，两边共用同一个.env数据源，不用重复配置。

额外小提醒 #

• 一定要仔细检查你的.gitignore文件，确保.env已经被加入忽略列表，别因为粗心把密钥提交到公开仓库！
• 如果是团队开发，可以在仓库里提交一个.env.example文件，只保留变量名（比如GOOGLE_MAPS_API_KEY=），让其他开发者可以参考格式创建自己的.env文件。

内容来源于stack exchange