构建React Native官方Examples

尊重版权,未经授权不得转载 本文出自:贾鹏辉的技术博客(http://www.devio.org)

告诉大家一个好消息，为大家精心准备的React Native视频教程发布了，大家现可以看视频学React Native了。

构建与运行React Native官方Examples需要React Native开发环境，还没搭建React Native环境的小伙伴可以参考《Mac(OSX)平台搭建React Native开发环境》、《Windows平台搭建React Native开发环境》。

在Windows平台上构建运行

方式一：编译react-native并运行Examples

这种方式是React Native的Examples说明文档中所提到的构建方式，如果方式一无法运行也不要担心，我为大家准备了方式二，大家也可以尝试方式二的方法来构建构建React Native官方Examples。

第一步：下载react-native与安装依赖

这一步需要用到git，没有安装git的小伙伴可以从git官网进行下载安装。 然后打开GitBash运行如下命令：

git clone https://github.com/facebook/react-native.git

也可以将react-native打包下载下来然后进行解压即可。

接下来呢，需要安装react-native所依赖的一些包，GitBash进入到项目的根目录：

cd react-native
npm install

第二步：构建项目并运行在Android设备上

要将Examples运行在Android设备上之前呢，我们需要先对它进行编译和打包，在这里呢我们需要用到Android SDK和NDK。

关于NDK

因为React Native的Examples是在 Android ndk r10e版本上编译的(@#7526)，所以我们要编译它则需要使用与之对应的NDK版本，单击下载ndk r10e。

设置NDK路径

将下载的NDK进行解压，然后在Windows环境变量中设置ANDROID_NDK：

编译与运行

在运行之前我们首先需要一个Android模拟器或一个连接到电脑上的Android设备，然后GitBash进入到react-native目录下运行：

./gradlew :Examples:UIExplorer:android:app:installDebug
./packager/packager.sh

上面第一行为编译Examples中的UIExplorer并将它安装到Android设备上；第二行代码为启动React Native的启动器，启动器负责提供js bundle与相应的资源。

方式二：将Examples的js部分添加到已经初始化好的React Native项目中运行

如果通过方式一还是无法编译运行Examples的话，在这里我在为大家分享另外一种运行Examples的方法。

首先，我们需要通过react-native init命令初始化一个项目如：

react-native init FirstApp

然后，我们需要将Examples中对应的js代码添加到我们已经初始化好的项目中，接下来就以UIExplorer为例来进行讲解具体的步骤：

首先，我们将UIExplorer的js部分的代码复制到FirstApp项目的根目录下：

其次，我们将...ExamplesUIExplorerandroidappsrcmain 目录下的文件替换掉FirstApp1androidappsrcmain目录下的文件。

再次，我们需要对FirstApp1androidappbuild.gradle进行如下修改：

android {
    compileSdkVersion 23
    buildToolsVersion "23.0.1"
    defaultConfig {        
        targetSdkVersion 23
        ...
       }   
 }
 dependencies {
    ...
//    compile "com.android.support:appcompat-v7:25.0.1"
    compile 'com.android.support:appcompat-v7:23.0.1'
    ...
}

在这里呢，我们将Android的编译与构建工具以及com.android.support:appcompat-v7都修改为23，为了是还原官方Examples的环境，因为Examples使用的是23。

最后，我们需要修改UIExplorerApplication.java文件：

@Override
public String getJSMainModuleName() {
	//return "Examples/UIExplorer/js/UIExplorerApp.android";
  return "js/UIExplorerApp.android";
}

上述的修改是让React Native直接加载我们项目根目录下的js/UIExplorerApp.android文件。

到这里呢，我们就可以像运行一个普通的React Native 项目方式来运行它了。

和方式一比起来呢，方式二的要求比较低，只要我们能成功初始化一个React Native项目就可以运行Examples。

在Mac平台上构建运行

在Mac 平台上我们不仅可以在Android设备上运行Examples也可以在iOS设备上运行Examples，首先我们来看一下如何在iOS设备上运行Examples。

iOS

在Mac平台上构建运行Examples中的iOS项目比较简单，只需用XCode打开Examples/UIExplorer/UIExplorer.xcodeproj，然后单击运行按钮就可以将Examples中的UIExplorer运行在iOS设备上。

Android

在Mac平台上构建运行Examples中的Android项目同样需要Android SDK和NDK。

关于NDK

因为React Native的Examples是在 Android ndk r10e版本上编译的(@#7526)，所以我们要编译它则需要使用与之对应的NDK版本，单击下载ndk r10e。

设置NDK路径

将下载的NDK进行解压，然后在Mac环境变量中设置ANDROID_NDK：

打开/Users/penn/.bash_profile，设置ANDROID_NDK:

export ANDROID_NDK=NDK的路径

如图：

然后退出终端，重新打开终端进入到react-native目录。

编译与运行

在运行之前我们首先需要一个Android模拟器或一个连接到电脑上的Android设备，然后打开终端进入到react-native目录下运行：

./gradlew :Examples:UIExplorer:android:app:installDebug
./packager/packager.sh

上面第一行为编译Examples中的UIExplorer并将它安装到Android设备上；第二行代码为启动React Native的启动器，启动器负责提供js bundle与相应的资源。

方式二：将Examples的js部分添加到已经初始化好的React Native项目中运行

上文中的方式二不仅适用于Windows平台也适用于Mac平台，在这里就不重复了。

构建React Native官方Examples所遇到的问题及解决方案

在这里呢附上我在构建React Native官方Examples所遇到的问题及解决方案。

ndk-build.cmd’’ finished with non-zero exit value 2

如果出现类似的问题，很有肯能是你所安装的NDK的版本不是ndk r10e。

解决办法：删除以前的ndk然后重新下载ndk r10e并配置好NDK的路径即可解决。

EBUSY: resource busy or locked, lstat ‘C:pagefile.sys’

出现这个问题的时候，我是将react-native直接放到了系统盘的（C盘）根目录下运行，当我尝试过各种方法无果后，我将react-native移动到了其它目录中，这个问题就没有在出现过，如果你了遇到了类似的问题，不妨将react-native移动到其它目录试一下。

UIExplorer.build/Script-68CD48B71D2BCB2C007E06A9.sh: line 3: react: No such file or directory

出现这个问题的原因是react-native所位于的路径中有空格，解决办法删除目录名中的空格即可。

如果大家在构建React Native Examples的时候还有不明白的地方,可以在文章下方给我留言，我看到了后会及时回复的哦。 另外也可以关注我的新浪微博@CrazyCodeBoy，或者关注我的Github来获取更多有关React Native开发的技术干货。

告诉大家一个好消息，为大家精心准备的React Native视频教程发布了，大家现可以看视频学React Native了。

如果，大家在开发原生模块中遇到问题可以在本文的下方进行留言，我看到了后会及时回复的哦。 另外也可以关注我的新浪微博，或者关注我的Github来获取更多有关React Native开发的技术干货。

推荐学习：视频教程《React Native开发跨平台GitHub App》