翻译自:官网原文
在运行React Native安卓应用时,需要一个安卓模拟器。这个指南用于描述基本的安卓开发环境安装。
1.安装Git
- Mac系统,如果你已经安装XCode,那么Git环境已经安装好了。否则执行以下命令进行安装;
brew install git
- Linux系统,通过你的包管理器来安装Git
- Window系统,下载并安装Window版本Git,在安装过程中,选择"Run Git from Windows Command Prompt",它会自动将Git添加到你的PATH环境变量中。
2.安装安卓SDK(除非你已经安装了)
- 安装最新版SDK
- 安装安卓SDK:
- Mac系统:
brew install android-sdk
- Linux和Windows系统:从安装网站下载
- Mac系统:
3.定义ANDROID_HOME环境变量
重要:请确保ANDROID_HOME环境变量指向你已有的安卓SDK
-
Mac系统,将下面的语句添加到/.bashrc,/.bash_profile文件中,或者任意你使用的脚本中:
如果你是通过Homebrew安装SDK的话如下所示设置变量,否则文件目录替换为~/Library/Android/sdk:
export ANDROID_HOME=/usr/local/opt/android-sdk
-
Linux系统,将下面的语句添加到/.bashrc,/.bash_profile文件中,或者任意你使用的脚本中:
export ANDORID_HOME=<你未打包的安卓SDK文件目录>
Windows系统,点击控制面板 -> 系统与安全 —> 系统 —> 改变设置 —> 扩展 —> 环境变量 —> 新增
提醒:你需要重启命令行(Windows系统)/终端模拟器(Mac系统或Linux系统)来应用你最新环境变量
4.使用gradle守护进程
React Native安卓使用gradle作为基础系统。我们推荐启用gradle守护进程功能,它能够在修改java代码后,重新构建时间带来50%的提升。从这里学习如何在你的平台中启用它。
5.配置SDK
5.1 打开安卓SDK管理器(在Mac系统上,打开一个新的终端并执行android
);在windows系统,请确认以下检查:
- 安卓SDK打包工具版本23.0.1
- 安卓6.0(API 23)
- 本地的Maven依赖库(这个在旧版本中称之为安卓支持库)
5.2 点击“安装包”,如下图所示:
6.安装Genymotion
相比原生安卓,Genymotion更易于设置谷歌基础模拟器。然而,它仅仅对个人使用开放免费。如果你想要使用谷歌基础模拟器,操作如下:
- 下载并安装Genymotion
- 打开Genymotion,如果你没有安装VirtualBox的话,它可能会提醒你安装。
- 创建一个新的模拟器并启动它。
- 按住command+M键,打开开发者菜单
7.替换6的操作:创建一个谷歌基础模拟器
7.1 打开一个终端并执行android
,在windows系统,首先你需要确认以下检查项:
- Intel x86 Atom系统图片(针对安卓5.1.1 - API 22)
- Intel x86 模拟器加速器(安装HAXM)
7.2 点击“安装包”
7.3 配置硬件加速器(HAXM),否则模拟器将会运行的非常慢(或者完全无法运行)
- 在mac上需要打开文件:
/usr/local/opt/android-sdk/extras/intel/Hardware_Accelerated_Execution_Manager/IntelHAXM_<version>.dmg
7.4 创建一个安装虚拟服务(AVD)
- 运行
android avd
并点击创建,如下图所示:
- 选择新创建的AVD,点击启动
7.5 点击F2键启动开发者菜单(或者安装Frappé)
8.windows替换方案:Hyper-V
针对安卓的Visual Studio模拟器是一个通过Hyper-V来加速硬件的免费安卓模拟器。它并不需要你安装Visual Studio。
使用它来运行react-native项目,你仅仅需要添加一个key和value到你的注册表中:
- 打开终端(windows系统快捷键是windows+R)
- 输入
regedit.exe
- 在注册机中找到
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Android SDK Tools
- 右键点击
Android SDK Tools
并选择 New > String Value - 设置名称为
Path
- 双击新建的Path并设置它的值为
C:\Program Files\Android\sdk
另外,你需要使用这个模拟器来运行命令adb reverse tcp:8081 tcp:8081
。然后和其他的相同,当你运行react-native run-android
时将重启该模拟器。
9.在安卓Studio中修改你的应用中Java代码
你可以使用任何编辑器来修改JS。如果你想使用安卓Studio来写native代码,请从Android Studio的欢迎界面中选择“导入项目”,并选择你的应用的android
文件夹。
10.你可以会遇到的问题
当你遇到如下错误时:
Execution failed for task ':app:installDebug'.
com.android.builder.testing.api.DeviceException:
com.android.ddmlib.ShellCommandUnresponsiveException
请尝试下载或者更新你的gradle版本到1.2.3在 项目名称/android/build.gradle
查看问题:(https://github.com/facebook/react-native/issues/2720)