React-Native之链接原生库

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

(ps: 在用Xcode打开AwesomeProject.xcodeproj运行 报错'React/RCTBundleURLProvider.h' file not found 请将头文件 和更换成"RCTBundleURLProvider.h" 和''RCTRootView.h'')

比如：

从github上面clone一个ReactNative项目，在运行的项目的时候发现RCTBundleURLProvider.h file not found。下面是解决方法：

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

一、自动链接

第一步、

首先安装rnpm:

npm install rnpm -g

注意:rnpm需要node 4.1或更高版本。

第二步、

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

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

注意:这一步中–save或–save-dev参数是非常重要的。rnpm需要根据package.json文件中的dependencies和devDependencies记录来链接库。

第三步、

链接原生依赖：

rnpm link

完成了！现在所有的原生依赖都成功地链接到你的iOS/Android项目了。

二、手动链接

第一步、

如果该库包含原生代码，那么在它的文件夹下一定有一个.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，然后添加库所在的目录（如果它还有像React这样的子目录需要包含，注意要选中recursive选项）