本地库设置

非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

本地库是指包含视图或模块的库，它仅存在于您的应用本地且未发布到任何注册中心。与传统视图和模块设置不同，本地库与应用原生代码是解耦的。

本地库创建在 android/ 和 ios/ 文件夹之外，并利用自动链接（autolinking）功能与应用集成。包含本地库的项目结构可能如下所示：

plaintext

MyApp
├── node_modules
├── modules <-- folder for your local libraries
│ └── awesome-module <-- your local library
├── android
├── ios
├── src
├── index.js
└── package.json

由于本地库代码位于 android/ 和 ios/ 文件夹之外，未来升级 React Native 版本、复制到其他项目等操作将更加便捷。

我们将使用 create-react-native-library 创建本地库。该工具提供了所有必要的模板。

开始使用

在 React Native 应用的根目录下运行以下命令：

shell

npx create-react-native-library@latest awesome-module

其中 awesome-module 是您为新模块指定的名称。完成提示操作后，项目根目录将生成名为 modules 的新文件夹，其中包含新建的模块。

链接配置

默认情况下，生成的库会自动通过以下方式链接到项目：使用 Yarn 时采用 link: 协议，使用 npm 时采用 file: 协议：

npm

json

"dependencies": {
  "awesome-module": "file:./modules/awesome-module"
}

Yarn

json

"dependencies": {
  "awesome-module": "link:./modules/awesome-module"
}

这将在 node_modules 下创建指向库的符号链接，从而实现自动链接功能。

安装依赖

链接模块前需要安装依赖：

npm

shell

npm install

Yarn

shell

yarn install

在应用中使用模块

要在应用中使用该模块，可通过模块名称直接导入：

js

import {multiply} from 'awesome-module';