React Native Maps 在 Expo 项目中 iOS 预构建失败问题解析

问题背景

在使用 React Native Maps 库与 Expo 管理项目集成时，开发者可能会遇到 iOS 预构建失败的问题。具体表现为执行 npx expo prebuild --clean 命令时，系统抛出错误提示："Cannot setup Google Maps because the project AppDelegate is not a supported language: objcpp"。

核心问题分析

这个问题的根源在于 React Native Maps 的配置插件与 Expo SDK 版本之间的兼容性问题。最新版本的 React Native Maps 配置插件仅支持使用 Swift 编写的 AppDelegate，而 Expo SDK 52 及以下版本使用的是 Objective-C++ 实现的 AppDelegate。

技术细节

1. AppDelegate 语言差异：

   • Expo SDK 52 及以下版本使用 Objective-C++ 实现 iOS 应用入口
   • Expo SDK 53 及以上版本改用 Swift 实现
   • React Native Maps 1.22.1 版本后的配置插件仅支持 Swift 实现

2. 构建过程失败表现：

   • 预构建阶段直接失败，无法生成 iOS 目录
   • 若强制构建，会引发多个接口声明找不到的编译错误

解决方案

对于遇到此问题的开发者，有以下几种解决方案：

1. 升级 Expo SDK：

   • 将项目升级至 Expo SDK 53 或更高版本
   • 这是官方推荐的解决方案，能获得最佳兼容性

2. 降级 React Native Maps：

   • 使用与 Expo SDK 52 兼容的 React Native Maps 旧版本
   • 需注意旧版本可能存在其他已知问题

3. 手动配置：

   • 不使用配置插件，手动配置 Google Maps
   • 需要开发者熟悉 iOS 原生开发配置

最佳实践建议

1. 在开始新项目时，直接使用最新版 Expo SDK 和 React Native Maps
2. 升级现有项目时，先检查所有依赖库的兼容性说明
3. 对于关键业务项目，建议在升级前创建完整备份

总结

React Native Maps 与 Expo 的集成问题主要源于底层技术栈的演进。随着 Expo 向 Swift 转型，许多原生模块也需要相应调整。开发者应当关注官方文档的版本要求说明，确保项目使用的各组件版本相互兼容，避免类似构建问题的发生。