React Native 是 Facebook 开发的开源移动应用框架,可以用 JavaScript 和 React 开发 iOS 和 Android 应用。
下面介绍如何搭建 React Native 开发环境。
本文在 Windows 上操作。
可以使用 Expo CLI 或 React Native CLI 两种方式安装。
本文介绍使用 React Native CLI 的安装方法。
安装前需要先安装
Node.js
、
JDK
和
Android Studio
。
Node.js 是 JavaScript 运行时,也是 React Native 开发所需的环境。
从 Node.js 官网下载并安装 LTS 版本。
Node.js 官网↗
安装完成后,用以下命令检查版本。
将 JDK 安装路径添加到环境变量。
- 打开控制面板 → 系统和安全 → 系统 → 高级系统设置 → 环境变量。
- 在系统变量中点击“新建”,变量名填 JAVA_HOME,变量值填 JDK 安装路径。
- 默认:
C:\Program Files\Java\jdk-버전
- 在系统变量中选择 Path,点击“编辑”。
- 点击“新建”,输入 %JAVA_HOME%\bin。
- 点击“确定”保存设置。
安装完成后,用以下命令检查版本。
Android Studio 是用于开发 Android 应用的集成开发环境,也是 React Native 开发所需的工具。
从 Android Studio 官网下载并安装。
Android Studio 官网↗
- 启动后,点击 More Action → SDK Manager,查看 SDK 路径。
- 打开控制面板 → 系统和安全 → 系统 → 高级系统设置 → 环境变量。
- 在系统变量中点击“新建”,变量名填 ANDROID_HOME,变量值填 SDK 路径。
- 默认:
C:\Users\사용자명\AppData\Local\Android\Sdk
- 在系统变量中选择 Path,点击“编辑”。
- 点击“新建”,输入 %ANDROID_HOME%\platform-tools。
- 点击“确定”保存设置。
安装完成后,用以下命令检查版本。
使用以下命令创建 React Native 项目。
npx react-native init {프로젝트명}
启动 Android Studio,创建 AVD(Android Virtual Device,Android 虚拟设备)。
- 点击 More Actions → VD Manager。
- 点击 Create Virtual Device,选择所需设备。
- 点击 Next,选择系统镜像。
- 点击 Finish,创建虚拟设备。
- 创建后,点击 Start 启动虚拟设备。
进入项目目录,用下面的命令运行项目。
出现选择提示时,按 a 运行 Android 应用。

启动 AVD 后,应用会自动安装并运行。
构建错误 java.io.UncheckedIOException 🔗
java.io.UncheckedIOException: Could not move temporary workspace
参照下面的示例修改文件,将 Gradle 版本改为 8.5。
[YourApp]/android/gradle/wrapper/gradle-wrapper.propertiesdistributionBase=GRADLE_USER_HOME
distributionPath=wrapper/dists
distributionUrl=https\://services.gradle.org/distributions/gradle-8.5-all.zip # 8.6 -> 8.5로 변경
networkTimeout=10000
validateDistributionUrl=true
zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists