如何在React Native库中引入Android子模块（解决OpenCV依赖问题）

核心原因 #

你发布自定义Native Module时，npm publish只会打包package.json中files字段指定的文件，或默认排除.gitignore/.npmignore里的内容。你的OpenCV代码作为本地子模块，大概率没被纳入打包范围，导致安装后RN应用找不到对应代码而崩溃。

具体解决步骤 #

1. 确保OpenCV被包含进npm包

• 打开自定义Native Module的package.json，添加files字段，明确列出需要打包的目录和文件，把OpenCV所在路径加进去。示例：

  {
    "files": [
      "android/",
      "ios/",
      "index.js",
      "README.md",
      "android/opencv/" // 替换成你的OpenCV实际路径
    ]
  }
  

• 若存在.npmignore文件，确认没有忽略OpenCV目录；若用.gitignore，npm会默认排除其中内容，建议用files字段强制包含OpenCV，避免冲突。

2. 调整Native Module的Android配置

• 在模块的android/settings.gradle中，确保正确引入OpenCV子模块：

  include ':opencv'
  project(':opencv').projectDir = new File(rootProject.projectDir, './opencv')
  

• 接着在模块的android/build.gradle中添加依赖：

  dependencies {
    implementation project(':opencv')
    // 其他原有依赖...
  }
  

  注意：路径要基于模块自身目录，不能用本地绝对路径，否则发布后路径失效。

3. 验证并重新发布

• 先执行npm pack生成测试tarball，解压后检查是否包含OpenCV代码，确认无误再发布。
• 清理缓存后发布：npm clean && npm publish
• 在RN应用中重新安装该模块，运行应用测试是否解决崩溃问题。

额外建议（针对Android新手） #

如果OpenCV是预编译的.aar或.jar文件，建议把它放到模块的android/libs目录下，然后在build.gradle中引用：

dependencies {
  implementation fileTree(dir: 'libs', include: ['*.aar', '*.jar'])
  // 其他依赖...
}

这种方式能避免子模块路径问题，预编译文件也更容易被npm正确打包。

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