部分API级别模拟器上Google Maps无法启用Latest Renderer

问题场景 #

• API Level 30模拟器环境下，调用MapsInitializer.initialize(applicationContext, MapsInitializer.Renderer.LATEST, this)可正常启用最新渲染器，相关版本信息：
  • Google Play services client version: 18020000
  • Google Play services package version: 231715037
  • Google Play services maps renderer version(maps_core): 231112103
• API Level 34模拟器环境下，相同代码却被强制使用Legacy渲染器，版本信息：
  • Google Play services client version: 18020000
  • Google Play services package version: 231818044
  • Google Play services maps renderer version(legacy): 203115000

两台设备除API级别外配置完全一致，新版本Android反而触发旧渲染器，不符合预期。项目通过Google Maps Views Activity向导创建，核心代码如下：

class MapsActivity : AppCompatActivity(), OnMapReadyCallback, OnMapsSdkInitializedCallback {

    private lateinit var mMap: GoogleMap
    private lateinit var binding: ActivityMapsBinding

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        MapsInitializer.initialize(applicationContext, MapsInitializer.Renderer.LATEST, this)

        binding = ActivityMapsBinding.inflate(layoutInflater)
        setContentView(binding.root)

        val mapFragment = supportFragmentManager
            .findFragmentById(R.id.map) as SupportMapFragment
        mapFragment.getMapAsync(this)
    }

    override fun onMapReady(googleMap: GoogleMap) {
        mMap = googleMap
        
        val coordinates = LatLng(39.999495, -83.012685)
        mMap.addMarker(MarkerOptions().position(coordinates).title("Marker"))
        mMap.moveCamera(CameraUpdateFactory.newLatLng(coordinates))
    }

    override fun onMapsSdkInitialized(renderer: MapsInitializer.Renderer) {
        when (renderer) {
            MapsInitializer.Renderer.LATEST -> Log.d("MapsDemo", "The latest version of the renderer is used.")
            MapsInitializer.Renderer.LEGACY -> Log.d("MapsDemo", "The legacy version of the renderer is used.")
        }
    }
}

排查与解决思路 #

1. 检查Google Play服务渲染器适配 #

API34模拟器中的Google Play服务版本（231818044）可能未针对该API级别完整适配Latest Renderer，导致自动降级到Legacy。可以尝试：

• 将模拟器内的Google Play服务更新至最新版本
• 切换到其他版本的Google Play服务镜像进行测试

2. 调整初始化时机与回调处理 #

当前代码在onCreate中先初始化Maps，再加载SupportMapFragment，Fragment的初始化可能覆盖之前的渲染器设置。可以尝试：

• 将MapsInitializer.initialize调用延迟到mapFragment.getMapAsync()之后
• 在onMapsSdkInitialized回调中检测到Legacy渲染器时，重新触发初始化：

override fun onMapsSdkInitialized(renderer: MapsInitializer.Renderer) {
    when (renderer) {
        MapsInitializer.Renderer.LATEST -> Log.d("MapsDemo", "使用最新渲染器")
        MapsInitializer.Renderer.LEGACY -> {
            Log.d("MapsDemo", "检测到旧渲染器，尝试重新初始化")
            MapsInitializer.initialize(applicationContext, MapsInitializer.Renderer.LATEST, this)
        }
    }
}

3. 验证硬件加速配置 #

Latest Renderer依赖硬件加速支持，API34模拟器的硬件加速设置异常可能导致降级：

• 打开模拟器设置，确认“Enable hardware acceleration”已勾选
• 更新电脑GPU驱动至最新版本，排除硬件兼容性问题

4. 升级Maps SDK依赖版本 #

旧版本的Maps SDK可能与API34存在兼容性问题，建议升级到最新稳定版：

implementation 'com.google.android.gms:play-services-maps:18.2.0'

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