Google Maps SDK v18.0.0符合配置设备仍使用旧版渲染器问题排查

问题成因排查 #

• 渲染器申请时机过晚：新渲染器的申请请求必须在任何地图组件（包括SupportMapFragment、MapView等）实例化之前发起，若你在setContentView或MapFragment初始化后才调用MapsInitializer.initialize指定使用最新渲染器，请求会失效，SDK会直接默认使用旧版渲染器。
• Google Cloud控制台配置不匹配：新渲染器需要提前在对应Google Cloud项目中申请试用资格，同时你测试用的应用包名、签名（debug模式的SHA-1和release签名都需要）必须正确绑定到项目的API密钥凭证中，签名不匹配会导致新渲染器权限校验失败，自动回退旧版。
• Google Play Services动态模块未更新：虽然整体Play Services版本号符合要求，但地图相关的动态分发模块可能未同步更新到支持新渲染器的版本，缓存数据也可能导致渲染器切换异常。
• 设备硬件加速限制：若你开启了开发者选项中的「强制CPU渲染」「关闭硬件加速」等开关，或者应用本身关闭了硬件加速权限，新渲染器会因为依赖的渲染能力不足回退到旧版。
• SDK版本bug：18.0.0版本的Maps SDK存在部分已知的渲染器切换异常问题，官方在后续补丁版本中做了修复。

对应解决方法 #

1. 调整渲染器申请时机，将初始化逻辑提前到Application的onCreate方法，或者Activity的super.onCreate()调用之前执行，示例代码如下：

override fun onCreate(savedInstanceState: Bundle?) {
    // 先请求新渲染器，再调用super.onCreate和加载布局
    MapsInitializer.initialize(
        applicationContext,
        MapsInitializer.Renderer.LATEST,
        object : OnMapsSdkInitializedCallback {
            override fun onMapsSdkInitialized(renderer: MapsInitializer.Renderer) {
                Log.d("MAP_RENDERER", "当前使用渲染器类型：$renderer")
            }
        }
    )
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)
    // 后续初始化MapFragment的逻辑放在后面
}

2. 核对Google Cloud控制台配置，确认你使用的API密钥所属的项目已经申请了新渲染器试用权限，同时当前测试应用的包名、对应签名的SHA-1值已经正确添加到API密钥的允许调用列表中。
3. 清除Google Play Services缓存：进入系统设置-应用-所有应用-找到Google Play服务-存储-清除缓存，重启设备后再测试。
4. 检查应用配置和开发者选项，确认应用AndroidManifest.xml中没有强制关闭硬件加速的配置，开发者选项中没有开启强制CPU渲染相关开关。
5. 升级Maps SDK依赖版本，将com.google.android.gms:play-services-maps的依赖版本升级到18.1.0或更高版本，规避已知的版本bug。

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