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

项目简介

React Native Maps 是 React Native 生态中最受欢迎的地图组件库之一，它为开发者提供了跨平台的地图功能集成方案。该库支持 iOS 和 Android 平台，并且可以对接 Apple Maps 和 Google Maps 两种地图服务。

架构升级：全面拥抱Fabric

本次 v1.21.0 版本最重要的变化是全面支持 React Native 的新架构 Fabric。Fabric 是 React Native 团队推出的新一代渲染架构，它通过减少 JavaScript 线程和原生线程之间的通信开销，显著提升了应用性能。

关键变化点

• 旧架构不再支持：这是一个重大变更，意味着使用旧版本 React Native 或旧架构的项目需要升级才能使用此版本
• 性能优化：采用直接事件(DirectEvents)和冒泡事件(Bubbling Events)的正确组合，减少通信开销
• 类型安全：源代码现在直接使用 TypeScript，不再通过 Babel 转译，提高了类型安全性

平台一致性改进

React Native Maps 团队在此版本中投入了大量精力来统一不同平台间的行为差异：

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

平台特定更新

iOS 平台

• 最低版本要求：提升至 iOS 13
• 废弃属性移除：移除了 showsTraffic 和 showsPointsOfInterest 这两个已废弃的属性
• 新功能：增加了 Marker.displayPriority 支持，可以控制标记点的显示优先级

Android 平台

• 新增功能：
  • 支持 showsTraffic 显示交通流量
  • 支持 userInterfaceStyle 设置界面主题（暗色、亮色或跟随系统）

Google Maps (iOS)

• 最低版本要求：提升至 iOS 15
• SDK 升级：
  • GoogleMaps 升级至 9.3.0 版本
  • Google-Maps-iOS-Utils 升级至 6.1.0 版本
• 新功能：
  • 支持 MapType: none 无地图类型（与 Android 行为一致）
  • 支持 mapId 使用自定义地图样式

开发环境要求

• React Native 版本：必须使用 0.76 或更高版本
• TypeScript 支持：项目现在使用 React Native 默认的 tsconfig 配置
• 示例应用：示例应用已更新至 React Native 0.76.8

问题修复

• WMSTiles：修复了 WMSTiles 功能无法使用的问题
• 室内地图：修复了 iOS 和 Android 平台上的室内地图支持

升级建议

对于正在使用 React Native Maps 的开发者，升级到 v1.21.0 版本需要注意以下几点：

1. 项目架构：确保项目已经迁移到 Fabric 新架构
2. React Native 版本：必须升级到 0.76 或更高版本
3. iOS 最低版本：检查项目的 iOS 最低版本要求是否符合新版本要求
4. 废弃属性：检查代码中是否使用了已移除的废弃属性

这次更新标志着 React Native Maps 正式进入新架构时代，虽然升级过程可能需要一些工作，但带来的性能提升和功能改进将为地图密集型应用带来更好的用户体验。