react-native搭建开发环境

android版

绯雨闲丸 发布于

环境需求

  1. 一台mac电脑(笔记本, 台式机不限), 操作系统OS X及以上

  2. 安装HomeBrew

    • 点击桌面左下角”Finder” -> 点击顶部菜单栏”前往” -> 选择”实用工具” -> 双击”终端”
    • 执行如下命令

      /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

      注: 在Max OS X 10.11(El Capitan)版本中,homebrew在安装软件时可能会碰到/usr/local目录不可写的权限问题。可以使用下面的命令修复:

      sudo chown -R whoami /usr/local

  3. 使用Homebrew来安装Node.js.

    brew install node

  4. 安装React Native的命令行工具(react-native-cli)

    React Native的命令行工具用于执行创建、初始化、更新项目、运行打包服务(packager)等任务。

    npm install -g react-native-cli

    注:由于众所周知的网络原因,react-native命令行从npm官方源拖代码时会遇上麻烦。请将npm仓库源替换为国内镜像:

     npm config set registry https://registry.npm.taobao.org --global
     npm config set disturl https://npm.taobao.org/dist --global
    
  5. 安装Android Studio

    React Native目前需要Android Studio2.0或更高版本。

     Android Studio需要Java Development Kit [JDK] 1.8或更高版本。
     你可以在命令行中输入`javac -version`来查看你当前安装的JDK版本。
     如果版本不合要求,则可以到 官网上下载。
    

    Android Studio包含了运行和测试React Native应用所需的Android SDK和模拟器。

     除非特别注明,请不要改动安装过程中的选项。
     比如Android Studio默认安装了`Android Support Repository`,而这也是React Native必须的
     (否则在react-native run-android时会报appcompat-v7包找不到的错误)。
    

    安装过程中有一些需要改动的选项:

    • 选择Custom选项: 选择Custom选项

    • 勾选PerformanceAndroid Virtual Device 勾选`Performance`和`Android Virtual Device`

    • 安装完成后,在Android Studio的启动欢迎界面中选择Configure | SDK Manager勾选`Performance`和`Android Virtual Device`

    • SDK Platforms窗口中,选择Show Package Details,然后在Android 6.0 (Marshmallow)中勾选Google APIsIntel x86 Atom System ImageIntel x86 Atom_64 System Image以及Google APIs Intel x86 Atom_64 System Image在`SDK Platforms`窗口中

    • SDK Tools窗口中,选择Show Package Details,然后在Android SDK Build Tools中勾选Android SDK Build-Tools 23.0.1。(必须是这个版本) 在`SDK Tools`窗口中

    • 配置ANDROID_HOME环境变量 确保ANDROID_HOME环境变量正确地指向了你安装的Android SDK的路径。 具体的做法是把下面的命令加入到~/.bash_profile文件中: (注:~表示用户目录,即/Users/你的用户名/,而小数点开头的文件在Finder中是隐藏的,并且这个文件有可能并不存在。 请在终端下使用sudo vi ~/.bash_profile命令创建或编辑。如不熟悉vi操作,请点击这里学习)

      # 如果你不是通过Android Studio安装的sdk,则其路径可能不同,请自行确定清楚。 export ANDROID_HOME=~/Library/Android/sdk

    然后使用下列命令使其立即生效(否则重启后才生效):

    source ~/.bash_profile

    可以使用echo $ANDROID_HOME检查此变量是否已正确设置

    • Android SDK的Tools目录添加到PATH变量中 你可以把Android SDK的tools和platform-tools目录添加到PATH变量中,以便在终端中运行一些Android工具, 例如android avd或是adb logcat等。具体做法仍然是在~/.bash_profile中添加:

    注意:你的SDK的具体路径可能不同

     PATH="~/Library/Android/sdk/tools:~/Library/Android/sdk/platform-tools:${PATH}"
     export PATH
    

推荐安装

  1. Watchman是由Facebook提供的监视文件系统变更的工具。安装此工具可以提高开发时的性能(packager可以快速捕捉文件的变化从而实现实时刷新)。

    brew install watchman

  2. Flow是一个静态的JS类型检查工具。译注:你在很多示例中看到的奇奇怪怪的冒号问号,以及方法参数中像类型一样的写法,都是属于这个flow工具的语法。这一语法并不属于ES标准,只是Facebook自家的代码规范。所以新手可以直接跳过(即不需要安装这一工具,也不建议去费力学习flow相关语法)。

  3. WebStorm强大的前端开发IDE, 可集成很多实用插件, 包括react-native语法智能提醒插件, 可用于编写React Native应用

    安装破解版请参阅这里

  4. Gradle Daemon

    开启Gradle Daemon可以极大地提升java代码的增量编译速度。

常见问题

安装Android Studio时无法创建虚拟设备

某些版本的Android Studio可能存在一个已知的bug,导致在安装时无法创建虚拟设备。安装过程中可能看到如下报错:

Creating Android virtual device
Unable to create a virtual device: Unable to create Android virtual device

如果你碰到了这个问题,可以运行android avd来手工创建虚拟设备。 手工创建虚拟设备 然后在AVD管理器(AVD Manager)窗口中选择新设备并点击Start...来启动。

Shell命令无响应的异常

如果你碰到了下面这样的异常:

Execution failed for task ':app:installDebug'.
  com.android.builder.testing.api.DeviceException: com.android.ddmlib.ShellCommandUnresponsiveException

试着将项目目录/android/build.gradle中的Gradle版本改为1.2.3。

touch ~/.gradle/gradle.properties && echo "org.gradle.daemon=true" >> ~/.gradle/gradle.properties

调试

react-native init AwesomeProject
cd AwesomeProject
react-native run-android

修改项目

现在你已经成功运行了项目,我们可以开始尝试动手改一改了:

使用你喜欢的编辑器打开index.android.js并随便改上几行。
在Android Emulator中按下⌘-R就可以刷新APP并看到你的最新修改!