React Native Maps 中 Android 地图渲染器升级指南

背景概述

Google Maps Platform 近期宣布了一项重要更新：从2024年3月开始，所有使用 Maps SDK for Android 的应用将自动升级到新版渲染器。旧版渲染器将在2025年3月正式停用。这一变更直接影响到了使用 react-native-maps 库的开发者。

技术细节解析

渲染器版本变更

Google Maps SDK for Android 18.2.0 版本已经默认启用了新版渲染器。在 react-native-maps 库中，从1.9.0版本开始，通过相关代码修改，已经将 Maps SDK 升级到了18.2.0版本。这意味着：

1. 使用1.9.0及以上版本的开发者无需采取额外措施
2. 系统会自动处理渲染器的升级过程
3. 应用将获得新版渲染器带来的性能改进和功能增强

自定义配置注意事项

值得注意的是，如果开发者在项目的android/build.gradle文件中定义了playServicesVersion，这个值会覆盖react-native-maps使用的版本。这种情况下，开发者需要手动确保使用的是18.2.0或更高版本。

兼容性问题与解决方案

已知问题

部分开发者报告，在调用enableLatestRenderer()方法后，自定义标记(Marker)会出现闪烁问题。特别是在以下场景：

1. 使用动态变化的标记
2. 标记在被选中时需要缩放效果
3. 无法简单使用tracksViewChanges={false}来解决，因为这会阻止图像更新

临时解决方案

对于暂时无法升级到最新版本的开发者，可以考虑以下临时方案：

1. 显式指定使用旧版渲染器：在MapView组件中添加googleRenderer={'LEGACY'}属性
2. 这个方案可以提供约一年的缓冲期，直到2025年3月旧版渲染器完全停用

版本升级建议

当前版本状态

1. react-native-maps 1.9.0及以上版本：完全兼容新版渲染器
2. 1.7.1等较旧版本：需要手动调用enableLatestRenderer()方法
3. 2.0.0-beta.15版本：目前仍使用18.1.0版本的SDK

升级路径

建议开发者按照以下步骤进行升级：

1. 首先升级react-native-maps到最新稳定版(目前为1.x系列)
2. 检查项目中是否有覆盖playServicesVersion的设置
3. 测试地图功能，特别是自定义标记的显示效果
4. 如果遇到标记闪烁问题，评估是否可以使用临时解决方案

未来展望

随着Google Maps Platform的持续更新，react-native-maps库也会相应跟进。开发者应该：

1. 关注官方发布的新版本
2. 定期检查项目的依赖关系
3. 为2025年3月旧版渲染器的完全停用做好准备
4. 考虑逐步移除对临时解决方案的依赖

通过及时升级和适当配置，开发者可以确保应用的地图功能持续稳定运行，同时享受新版渲染器带来的性能优势。