构建React Native官方Examples

手把手教你构建运行React Native官方Examples

Posted by CrazyCodeBoy on June 1, 2017

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

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

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

UIExplorer-android

在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 SDKNDK

关于NDK

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

设置NDK路径

将下载的NDK进行解压,然后在Windows环境变量中设置ANDROID_NDKANDROID_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项目的根目录下:

uiexplorer-js.png

其次,我们将...\Examples\UIExplorer\android\app\src\main 目录下的文件替换掉FirstApp1\android\app\src\main目录下的文件。

再次,我们需要对FirstApp1\android\app\build.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设备上。

UIExplorer-ios

Android

在Mac平台上构建运行Examples中的Android项目同样需要Android SDKNDK

关于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的路径

如图: ANDROID_NDK-mac 然后退出终端,重新打开终端进入到react-native目录。

编译与运行

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

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

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

方式二:将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》