React Native iOS原生模块无法正常工作，NativeModules返回空对象求助

我之前在搭建React Native iOS原生模块时也碰到过完全一样的问题，咱们一步步来排查你可能遗漏的配置：

• 检查Xcode项目的文件归属
  打开你的Xcode项目，选中CAL.h和CAL.m文件，查看右侧的File Inspector面板，确认它们已经被添加到你的主App Target的Target Membership中。如果没勾选，编译器根本不会编译这两个文件，RN自然找不到这个模块。

• 清理构建缓存并重新构建
  有时候Xcode的缓存会搞事情，先按Cmd+Shift+K清理当前项目的构建缓存，然后关闭Xcode，重启Metro Bundler（执行npx react-native start --reset-cache），再重新打开Xcode构建运行项目。

• 验证Podfile配置与Pod安装
  确保你的Podfile中正确引入了React相关依赖，并且已经执行过pod install。如果你的项目是基于新架构的，还要确认原生模块是否适配了新架构（不过官方示例应该是兼容的）。另外，手动添加的原生文件不需要在Podfile中额外声明，但要确保Pod安装过程没有报错。

• 检查JS端的调用方式
  确认你在JS代码中是这样导入和使用的：

  import { NativeModules } from 'react-native';
  console.log(NativeModules.CAL); // 注意模块名是大写的CAL，和你RCT_EXPORT_MODULE(CAL)的名称一致
  

  别不小心写成了小写的cal，大小写不匹配会导致找不到模块。

• 确认Compile Sources中包含CAL.m
  进入Xcode项目的Build Phases -> Compile Sources，检查列表里是否有CAL.m。如果没有，点击+按钮添加它，这个步骤和Target Membership是关联的，但有时候手动添加文件可能会漏掉这一步。

• 检查React Native版本兼容性
  如果你使用的是较旧的RN版本（比如0.60以下），可能需要手动在AppDelegate.m中注册模块：

  #import "CAL.h"
  
  - (NSArray<id<RCTBridgeModule>> *)extraModulesForBridge:(RCTBridge *)bridge {
    return @[[CAL new]];
  }
  

  不过新版本的RN已经支持自动模块注册，这一步可能不需要，但可以作为排查点。

如果以上步骤都检查过还是不行，你可以查看Xcode的编译日志，看看有没有关于CAL模块的报错信息，比如未定义的符号或者导入错误，这些细节往往能定位问题。

内容的提问来源于stack exchange，提问作者Zephyr