RNMapbox Maps 在 React Native 0.74.2 新架构下的 Camera 组件异常分析

问题背景

在使用 RNMapbox Maps 库时，开发者在 Android 平台上遇到了一个与新架构相关的异常。当启用 React Native 的新架构（Fabric）时，调用 Camera 组件的 setCamera、flyTo 或 zoomTo 方法会抛出异常，而关闭新架构后问题消失。

异常表现

异常信息显示：

Exception in HostFunction: no non-static method "Lcom/rnmapbox/rnmbx/components/camera/RNMBXCameraModule;.updateCameraStop(Ljava/lang/Double;Lcom/facebook/react/bridge/ReadableMap;Lcom/facebook/react/bridge/Promise;)V"

技术分析

根本原因

这个问题实际上是 React Native 0.74.2 版本中的一个已知 bug。在新架构下，TurboModule 的接口定义与原生实现之间存在不匹配的情况。

代码层面分析

在 CameraModule.kt 文件中，updateCameraStop 方法的签名是：

override fun updateCameraStop(viewRef: ViewRefTag?, stop: ReadableMap, promise: Promise)

而在 NativeRNMBXCameraModule.ts 中的接口定义是：

updateCameraStop(viewRef: ViewRef, stop: ObjectOr<Stop>): Promise<void>;

这种类型不匹配导致了 JNI 调用失败。

解决方案

临时解决方案

目前可以通过 patch-package 工具修改 react-native 的源代码来解决这个问题。具体需要修改 TurboModule 相关的代码，确保接口定义与原生实现完全匹配。

长期解决方案

等待 React Native 官方修复这个 bug，或者升级到修复后的版本。同时，RNMapbox Maps 团队也可以考虑在库层面提供兼容性处理。

最佳实践建议

1. 如果必须使用 React Native 0.74.2 和新架构，建议采用 patch-package 解决方案
2. 考虑暂时关闭新架构，等待更稳定的版本
3. 关注 React Native 的更新日志，及时升级到修复版本

总结

这个问题展示了新架构过渡期间可能遇到的兼容性问题。开发者在采用新架构时需要特别注意原生模块的接口一致性，并准备好应对类似的边界情况。随着 React Native 新架构的逐步成熟，这类问题将会得到更好的解决。