React Native Maps v1.21.0 发布：全面支持 Fabric 架构的重大更新

React Native Maps 是 React Native 生态中最受欢迎的地图组件库之一，它为开发者提供了跨平台的、高性能的地图功能集成方案。最新发布的 v1.21.0 版本是一个重要的里程碑式更新，标志着该库正式支持 React Native 的新架构（Fabric），并带来了多项功能增强和平台统一化改进。

架构升级与核心变更

本次更新的核心变化是全面转向 Fabric 架构，这是 React Native 的新渲染系统，旨在提升性能和跨平台一致性。值得注意的是，v1.21.0 不再支持旧架构（Paper），开发者需要确保项目已经迁移到新架构才能使用此版本。

在技术实现上，项目现在：

• 要求 React Native 0.76 或更高版本
• 采用 TypeScript 优先策略，直接使用 TypeScript 源码而不再通过 Babel 转译
• 使用 React Native 默认的 tsconfig 配置
• 统一了事件处理机制，主要依赖 DirectEvents 并正确使用 Bubbling Events

跨平台行为统一

开发团队在此版本中着重解决了多个平台间的行为差异问题：

1. 区域变化事件：统一了 iOS 和 Android 平台上 onRegionChanged 的行为表现
2. 覆盖物坐标：Overlay 组件现在统一使用 [northEast, southWest] 的边界格式
3. 室内地图：为 Google Maps 提供了跨平台一致的室内地图 API

平台特定更新

iOS 平台

• 最低支持版本提升至 iOS 13
• 移除了已废弃的属性：showsTraffic 和 showsPointsOfInterest
• 新增了 Marker.displayPriority 支持

Android 平台

• 新增了 showsTraffic 交通信息显示支持
• 支持 userInterfaceStyle 属性（dark/light/system），实现深色/浅色主题切换

Google Maps (iOS)

• 最低支持版本提升至 iOS 15
• GoogleMaps SDK 升级至 9.3.0 版本
• Google-Maps-iOS-Utils 升级至 6.1.0
• 新增 MapType: none 支持（与 Android 行为一致）
• 新增 mapId 支持

示例应用与开发者体验

配套的示例应用也同步更新至 React Native 0.76.8，并修复了多个功能：

• 重新启用了 WMSTiles 功能
• 完善了 iOS 和 Android 平台的室内地图支持

迁移建议

对于计划升级到 v1.21.0 的开发者，需要注意以下几点：

1. 确保项目已经迁移到 React Native 新架构（Fabric）
2. 检查项目中是否使用了已移除的废弃属性
3. 注意 iOS 最低版本要求的提升
4. 测试区域变化事件和覆盖物相关的功能，确保兼容新行为

这次更新标志着 React Native Maps 进入了新架构时代，为未来的性能优化和功能扩展奠定了坚实基础。虽然迁移过程可能需要一些调整，但长远来看将带来更好的用户体验和开发效率。