如何为PhoneGap/Cordova安卓应用限制Google Maps API密钥

我之前帮不少Cordova/PhoneGap开发者解决过这个问题，你遇到的情况其实是这类跨平台应用在Google Maps API密钥限制上的几个常见坑导致的，咱们一步步来排查解决：

1. 先确认SHA-1指纹的正确性（重中之重！） #

Cordova应用的签名指纹很容易搞混，一定要区分调试环境和发布环境的指纹：

• 调试时用的是Android Studio默认的debug.keystore，你可以用这条命令获取准确的调试SHA-1：

  # Mac/Linux
  keytool -list -v -keystore ~/.android/debug.keystore -alias androiddebugkey -storepass android -keypass android
  
  # Windows
  keytool -list -v -keystore C:\Users\<你的用户名>\.android\debug.keystore -alias androiddebugkey -storepass android -keypass android
  

• 如果是打包发布的应用，必须用你用来签名的正式keystore的指纹，绝对不能把调试指纹用到发布版本的限制里。
• 还要确认Cordova构建时是否正确使用了你的签名配置，在config.xml里检查：

  <platform name="android">
      <preference name="android-keystore" value="path/to/your-release.keystore" />
      <preference name="android-keyalias" value="your-key-alias" />
      <preference name="android-keystore-password" value="your-store-pass" />
      <preference name="android-key-password" value="your-key-pass" />
  </platform>
  

2. 核对包名是否完全匹配 #

别只填com.appname就完事了，要确认Cordova实际生成的包名和你在Google控制台填的完全一致：

• 打开platforms/android/app/src/main/AndroidManifest.xml，查看package属性的值，这个就是最终的应用包名。
• 同时检查config.xml里的<widget id="com.appname" ...>，这里的id就是Cordova生成的包名，必须和控制台里的限制配置完全一致，多一个字母、大小写错误都不行。

3. 确认API的启用和限制类型 #

• 确保你在Google控制台给这个API密钥启用了Maps SDK for Android，别选错成JavaScript API（那是给Web应用用的，Cordova插件调用的是原生Android的Maps SDK）。
• 限制类型一定要选Android应用，然后把正确的包名和SHA-1配对添加，别选成HTTP引用限制或者其他类型。

4. 处理缓存和即时生效问题 #

• Google控制台的限制配置不会立即生效，通常需要等5-10分钟，别刚改完就立刻测试。
• 调试时要把手机上的应用完全卸载后重新安装，避免旧的缓存数据干扰验证。
• 打开Android Studio的Logcat，过滤关键词Google Maps，你会看到具体的错误日志，比如API key not authorized或者Invalid signature，这能帮你精准定位问题。

5. 检查Cordova地图插件的配置 #

如果你用的是cordova-plugin-googlemaps这类主流插件，要确保API密钥配置正确：

• 要么在安装插件时传递参数：

  cordova plugin add cordova-plugin-googlemaps --variable API_KEY_FOR_ANDROID="你的API密钥"
  

• 要么在config.xml里配置：

  <plugin name="cordova-plugin-googlemaps" spec="^2.7.1">
      <variable name="API_KEY_FOR_ANDROID" value="你的API密钥" />
  </plugin>
  

• 部分插件版本需要启用AndroidX，你可以检查插件文档确认是否有遗漏的配置步骤。

按照这个顺序排查，90%以上的情况都是SHA-1指纹或者包名不匹配导致的，先把这两个点确认对，问题基本就能解决了。

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