Android平台play-services-maps真机显示异常问题求助

• 核对SHA-1指纹：别只加debug版的SHA-1，物理设备如果用release签名打包，必须把release的SHA-1也加到API密钥的限制里。Android Studio可通过Build > Generate Signed Bundle/APK查看release签名的SHA-1，或用命令行keytool -list -v -keystore 你的签名文件路径获取。另外，不同电脑的debug签名SHA-1不同，换电脑调试物理设备时，要把当前电脑的debug SHA-1也补充进去。

• 确认结算账户绑定：当前Google Maps SDK必须绑定有效结算账户，哪怕在免费额度内也需绑定。去Google Cloud控制台的结算页面检查状态，未绑定的话完成绑定后等待10-15分钟再测试。

• 检查Manifest配置细节：

  • 确保<meta-data android:name="com.google.android.geo.API_KEY" android:value="你的密钥"/>在<application>标签内，别写错name属性（旧版com.google.android.maps.v2.API_KEY已废弃）。
  • 确认添加必要权限：

    <uses-permission android:name="android.permission.INTERNET"/>
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
    

• 排查网络环境：先打开物理设备上的官方Google Maps APP，若官方APP也加载不出地图，说明是设备网络问题（如地区限制、DNS污染），需调整网络环境后再测试。

• 检查混淆规则：如果是release打包，确保proguard-rules.pro里未混淆Maps相关代码，添加以下规则：

  -keep class com.google.android.gms.maps.** { *; }
  -keep interface com.google.android.gms.maps.** { *; }
  -keep class com.google.android.gms.location.** { *; }
  

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