帮助改进此文档

链接原生库

本文档贡献者：sunnylqm(100.00%)

并不是所有的 APP 都需要使用全部的原生功能，包含支持全部特性的代码会增大应用的体积。但我们仍然希望能让你简单地根据自己的需求添加需要的特性。

在这种思想下，我们把许多特性都发布成为互不相关的静态库。

大部分的库只需要拖进两个文件就可以使用了，偶尔你还需要几步额外的工作，但不会再有更多的事情要做了。

我们随着 React Native 发布的所有库都在仓库中的Libraries文件夹下。其中有一些是纯 Javascript 代码，你只需要去import它们就可以使用了。另外有一些库基于一些原生代码实现，你必须把这些文件添加到你的应用，否则应用会在你使用这些库的时候产生报错。

添加包含原生代码的库需要几个步骤：

自动链接

第一步

安装一个带原生依赖的库：

$ npm install 某个带有原生依赖的库

第二步

运行以下命令，它会根据package.json文件中的dependencies和devDependencies记录来链接所有需要链接的库（注意一些老的教程和文档可能会提到rnpm link命令，此命令已过时不再使用，由下面这个命令代替）：

$ npx react-native link

如果只需要链接某一个库：

$ react-native link 某已安装的具体库名

好了！现在原生依赖就成功地链接到你的 iOS/Android 项目了。

Note: If your iOS project is using CocoaPods (contains Podfile) and linked library has podspec file, then react-native link will link library using Podfile. To support non-trivial Podfiles add # Add new pods below this line comment to places where you expect pods to be added.

手动链接

第一步

如果该库包含原生代码，那么在它的文件夹下一定有一个.xcodeproj文件。把这个文件拖到你的 XCode 工程下（通常拖到 XCode 的Libraries分组里）

第二步

点击你的主工程文件，选择Build Phases，然后把刚才所添加进去的.xcodeproj下的Products文件夹中的静态库文件（.a 文件），拖到Link Binary With Libraries组内。

第三步

不是所有的库都需要进行这个步骤，你需要考虑的问题在于：

我需要在编译的期间了解库的内容吗？

这个问题的意思是，你是需要在原生代码中使用这个库，还是只需要通过 JavaScript 访问？如果你只需要通过 JavaScript 访问这个库，你就可以跳过这步了。

这一步骤对于我们随 React Native 发布的大部分库来说都不是必要的，但有两个例外是PushNotificationIOS和LinkingIOS。

以PushNotificationIOS为例，你需要在AppDelegate每收到一条推送通知之后，调用库中的一个方法。

这种情况下我们需要能够访问到库的头文件。为了能够顺利打包，你需要打开你的工程文件，选择Build Settings，然后搜索Header Search Paths，然后添加库所在的目录。