React Native应用转npm包：工具选型与原生模块管理咨询

1. react-native-builder-bob是否适合用于React Native应用的npm包打包？ #

完全适合。react-native-builder-bob就是专门为包含原生模块的React Native库/npm包设计的打包工具，能解决普通打包工具（如rollup、webpack）处理React Native原生模块时的适配问题：

• 支持同时打包JS/TS代码和原生模块文件（iOS的.h/.m/.swift，Android的.java/.kt/.gradle等）
• 自动生成符合React Native社区规范的包结构，适配自动链接（Auto Linking）机制
• 支持输出CommonJS、ES Modules等多种格式，适配不同导入场景
• 内置TypeScript支持，可自动生成类型声明文件（.d.ts）
• 打包时会自动排除React、React Native这类宿主项目已有的核心依赖，避免重复打包

需要注意：如果你的应用是完整的React Native App（包含入口文件、项目级原生配置），打包成npm包时要剥离宿主项目特有的配置（比如android/app、ios/[AppName]目录），只保留可复用的组件、模块部分，bob工具能很好地处理这部分筛选打包工作。

2. 如何在npm包中管理应用所包含的原生模块？ #

核心原则是遵循React Native自动链接规范，让宿主项目能自动识别并集成原生模块，具体操作如下：

• 目录结构规范：
  将原生模块代码放在包根目录的android/和ios/文件夹下（不要嵌套在src或其他子目录），示例结构：

  your-npm-package/
  ├── android/
  │   ├── src/main/java/com/yourpackage/YourModule.java
  │   └── build.gradle
  ├── ios/
  │   ├── YourModule.h
  │   ├── YourModule.m
  │   └── YourModule.xcodeproj
  ├── src/
  │   └── index.tsx
  └── package.json
  

• package.json配置：
  • 添加react-native字段，声明原生模块配置，让Auto Linking能识别：

    {
      "name": "your-npm-package",
      "react-native": {
        "android": "android/build.gradle",
        "ios": "ios/YourModule.xcodeproj"
      }
    }
    

  • 在peerDependencies中声明React、React Native的版本范围，避免和宿主项目版本冲突：

    {
      "peerDependencies": {
        "react": ">=18.0.0",
        "react-native": ">=0.70.0"
      }
    }
    

• 原生代码适配：
  • Android：确保android/build.gradle中的groupId、artifactId和包名一致，尽量使用宿主项目提供的依赖版本（比如rootProject.ext.reactNativeVersion），不要硬编码版本号
  • iOS：确保YourModule.xcodeproj的编译选项和宿主项目兼容，避免引入冲突的第三方依赖
• 打包配置：
  在bob.config.js中配置要保留的原生文件，确保打包时不会被过滤：

  module.exports = {
    source: "src",
    output: "dist",
    targets: ["commonjs", "module", "types"],
    assets: [
      {
        from: "android/**/*",
        to: "android/"
      },
      {
        from: "ios/**/*",
        to: "ios/"
      }
    ]
  };
  

• 文档说明：
  如果有特殊的原生配置步骤（比如需要添加权限、修改AndroidManifest.xml或Info.plist），一定要在README中明确说明，方便用户集成

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