React NativeはFacebookが開発したオープンソースのモバイルアプリ開発フレームワークです。JavaScriptとReactでiOSとAndroidのアプリを開発できます。
この記事では、React Nativeの開発環境を用意する手順を見ていきます。筆者はWindows環境で作業しました。
セットアップには、Expo CLIとReact Native CLIの2つの方法があります。ここでは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 を入力します。
- 「OK」を押して設定を保存します。
インストールが終わったら、次のコマンドでバージョンを確認します。
Android StudioはAndroidアプリ向けの統合開発環境で、React Nativeの開発に必要です。
公式サイトからダウンロードし、インストールします。
Android Studio公式サイト↗
- 起動後、More Action → SDK ManagerをクリックしてSDKのパスを確認します。
- コントロールパネル → システムとセキュリティ → システム → システムの詳細設定 → 環境変数へ進みます。
- システム環境変数の「新規」をクリックし、変数名にANDROID_HOME、変数値にSDKのパスを入力します。
- 標準の場所は
C:\Users\사용자명\AppData\Local\Android\Sdk です。「사용자명」の箇所にはユーザー名が入ります。
- システム環境変数のPathを選び、「編集」をクリックします。
- 「新規」をクリックし、%ANDROID_HOME%\platform-tools を入力します。
- 「OK」を押して設定を保存します。
インストールが終わったら、次のコマンドでバージョンを確認します。
次のコマンドでReact Nativeプロジェクトを作ります。
npx react-native init {프로젝트명}
Android Studioを起動し、AVD(Android Virtual Device)を作ります。
- 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