React Native 新架构下 JNI 函数创建问题解析

在 React Native 0.78.1 版本中，开发者在使用新架构(New Architecture)时遇到了一个关于 JNI 函数创建的典型问题。这个问题在旧架构(Old Architecture)下工作正常，但在新架构下会导致应用启动时抛出"Invariant violation"错误。

问题背景

开发者尝试在 Android 原生端创建 JNI 函数，目的是从 C++ 代码调用 Java/Kotlin 方法，而不涉及 JavaScript 层。这种场景在需要直接访问原生功能但不需要暴露给 JS 的情况下很常见。

问题根源

深入分析后发现，问题的核心在于 React Native 新架构中的 CMake 构建系统处理方式。具体来说，React Native 的构建系统会检查项目中是否存在任何 .cpp 文件：

1. 如果存在任何 .cpp 文件，系统会使用这些文件而忽略默认的 OnLoad.cpp 文件
2. 如果没有 .cpp 文件，系统会回退使用默认的 default-app-setup/OnLoad.cpp 文件

在开发者案例中，由于项目中已经存在一个 native-lib.cpp 文件(用于 JNI)，但没有提供自定义的 OnLoad.cpp 文件，导致默认的 OnLoad.cpp 没有被加载，从而引发运行时错误。

解决方案

解决此问题的方法是在 CMakeLists.txt 中添加以下配置：

include(`${REACT_ANDROID_DIR}/cmake-utils/ReactNative-application.cmake`)

同时确保项目中包含正确的 OnLoad.cpp 文件。需要注意的是，当使用 TurboModules 时，这个文件必须命名为 OnLoad.cpp。

技术原理

React Native 新架构的这种设计有其合理性：

1. 它允许开发者完全自定义 OnLoad 逻辑
2. 当开发者需要特殊初始化时，可以通过提供自己的 .cpp 文件来覆盖默认行为
3. 这种机制保持了灵活性，同时提供了合理的默认值

最佳实践建议

对于需要在 React Native 项目中使用 JNI 的开发人员，建议：

1. 明确区分纯原生 JNI 调用和需要与 JS 交互的场景
2. 如果确实不需要 JS 交互，考虑将原生代码完全独立于 React Native 架构
3. 当必须集成时，确保正确处理 CMake 配置和 OnLoad 机制
4. 保持命名规范，特别是关键文件如 OnLoad.cpp

总结

React Native 新架构在提供更高性能的同时，也引入了一些新的构建机制和约束。理解这些机制对于解决类似问题至关重要。通过正确配置 CMake 和处理好文件命名，可以确保 JNI 功能在新旧架构下都能正常工作。