链接库

非官方测试版翻译

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

并非每个应用都会使用所有原生功能，而包含支持这些功能的代码会增加二进制文件体积...但我们仍希望在你需要时能轻松添加这些功能。

为此，我们将许多功能封装为独立的静态库。

大多数库只需拖放两个文件即可完成链接，有时需要第三步，但不会超过这个步骤。

备注

我们随 React Native 发布的库都位于仓库根目录的 Libraries 文件夹中。其中部分是纯 JavaScript 库，你只需通过 require 引入即可。 其他库依赖原生代码，此时你必须将这些文件添加到应用中，否则尝试使用库时会立即报错。

链接包含原生代码库的步骤

自动链接

安装包含原生依赖的库：

shell

npm install <library-with-native-dependencies> --save

信息

--save 或 --save-dev 标志在此步骤至关重要。React Native 会根据 package.json 文件中的 dependencies 和 devDependencies 来链接库。

完成！下次构建应用时，原生代码将通过自动链接机制完成链接。

手动链接

步骤 1

若库包含原生代码，其文件夹中必有 .xcodeproj 文件。将此文件拖入 Xcode 项目（通常置于 Xcode 的 Libraries 组下）；

步骤 2

点击主项目文件（代表 .xcodeproj 的文件），选择 Build Phases，然后将要导入库的 Products 文件夹中的静态库拖到 Link Binary With Libraries

步骤 3

并非所有库都需要此步骤，你需要考虑：

我是否需要在编译时知晓库的内容？

这意味着：你是在原生端使用此库，还是仅在 JavaScript 中使用？若仅在 JavaScript 中使用，则无需此步！

若需从原生端调用，则需配置库的头文件路径。操作步骤：进入项目文件，选择 Build Settings 并搜索 Header Search Paths，在此添加库的路径。（本文档曾推荐使用 recursive，但现不再建议，因其可能导致细微构建失败，尤其在使用 CocoaPods 时。）