React Native 0.66.3项目打包成aar实战：脱离node_modules依赖的完整指南

原创

于 2026-03-08 03:00:50 发布 · 444 阅读

标签

#ReactNative #Android #SDK #aar

React Native 0.66.3项目打包成aar实战：脱离node_modules依赖的完整指南

在混合开发领域，将React Native模块封装成独立的Android Archive（aar）包，是许多追求工程解耦和交付效率的团队面临的共同课题。想象一下，你的Android主工程需要集成一个由RN实现的、功能复杂的用户反馈模块，但团队既不想在主工程里引入庞大的node_modules，也不希望原生开发同事去折腾npm和React Native的构建环境。这听起来像是个理想状态，而实现它的关键，就在于将RN项目及其所有依赖，彻底“打包”进一个干净的原生SDK里。

这篇文章正是为你准备的。如果你是一位需要在Android项目中集成RN功能，但又希望保持原生项目纯净性的开发者或技术负责人，接下来的内容将是一份详尽的路线图。我们将以React Native 0.66.3这个仍广泛支持JDK 8的版本为例，一步步拆解如何将一个完整的RN项目，改造、打包成一个完全脱离node_modules环境依赖的aar包。这个过程不仅仅是执行几条命令，它涉及到项目结构的重构、Gradle配置的深度定制、依赖的静态化处理，以及最终SDK的优雅集成。让我们开始吧。

1. 项目结构重构：从RN范式到Android原生范式

React Native的默认项目结构，对于纯前端开发者来说非常友好，但对于需要将其作为原生库集成的场景，就显得有些“隔阂”。首要任务，就是打破这层隔阂，将项目结构调整为标准的Android项目形态。

1.1 理解默认结构的“鸿沟”

当你用react-native init创建一个新项目时，你会得到一个典型的RN结构：

MyRNProject/
├── android/          # Android原生代码目录
├── ios/              # iOS原生代码目录
├── node_modules/     # JS依赖库
├── index.js          # JS入口文件
└── package.json      # JS项目配置

问题在于，android/目录虽然存在，但它并非一个可以独立打开、构建和打包的Android项目。它的build.gradle文件严重依赖项目根目录下的node_modules来解析React Native自身的依赖。我们的目标，是创建一个可以完全独立存在的Android Library模块，这个模块内部已经包含了运行RN所需的一切。

核心思路：不是在原RN项目的android目录上修修补补，而是新建一个标准的Android项目，然后将RN项目中必要的原生代码、资源以及预先打包好的JS Bundle，移植到这个新项目的Library模块中。

1.2 创建独立Android项目与Library模块

我建议采用以下目录结构，这在实际操作中最为清晰：

保留原RN项目：RNProject/。这是你的开发环境，所有JS代码编写、RN依赖添加都在这里进行。

新建Android项目：AndroidAARProject/。这是我们的打包工厂。

AndroidAARProject/
├── app/                    # 可选的Demo App模块，用于测试
├── rnlibrary/             # 核心的Android Library模块，将被打包成aar
│   ├── src/main/
│   │   ├── java/com/yourcompany/rnlibrary/   # RN相关的原生Java/Kotlin代码
│   │   ├── assets/                           # 存放JS Bundle文件
│   │   └── res/                              # 存放RN的图片等资源
│   └── build.gradle
├── build.gradle
└── settings.gradle

这里的rnlibrary模块就是我们的主角。你需要将原RN项目android/app/src/main/java/下的所有Java代码（特别是MainApplication和MainActivity）复制到rnlibrary的对应位置。同样，原android/app/src/main/res/下的资源（如图片、字符串）也需要复制过来。

注意：在复制MainApplication时，需要特别注意其继承的Application类和ReactNativeHost的初始化逻辑。通常我们需要对其进行改造，使其更适合作为库被调用，而非独立的App入口。

1.3 预打包JS Bundle与资源

这是脱离node_modules运行的关键一步。RN应用的JS代码和资源必须在打包阶段就固化到aar中。

在原RNProject根目录下，执行以下命令：

cd /path/to/RNProject
react-native bundle --platform android --dev false --entry-file index.js --bundle-output ../AndroidAARProject/rnlibrary/src/main/assets/index.android.bundle --assets-dest ../AndroidAARProject/rnlibrary/src/main/res/

命令参数解析：