PhpStorm 2026.2 Help

React Native

React Native を使用すると、JavaScript および React を使用して、iOS および Android 用のネイティブモバイルアプリケーションを開発できます。 これは Facebook によって作成され、Instagram、Airbnb などの有名なアプリで使用され、現在は JetBrains 独自の YouTrack mobile(英語) アプリケーションで使用されています。 React Native オフィシャル Web サイト(英語)の詳細を参照してください。

PhpStorm は、React Native アプリケーションの作成、編集、リント、実行、保守を支援します。 PhpStorm は、React や Flow シンボルに対してコード補完も提供します。

始める前に

  1. お使いのコンピューターに Node.js(英語) がインストールされていることを確認してください。

  2. 設定で JavaScript and TypeScript プラグインが有効になっていることを確認します。 Ctrl+Alt+S を押して設定を開き、 プラグイン を選択します。 インストール済み タブをクリックします。 検索フィールドに JavaScript and TypeScript と入力します。 プラグインの詳細については、 プラグイン管理を参照してください。

新しい React Native アプリケーションの作成

PhpStorm で React Native アプリケーションを作成する推奨方法は、専用のプロジェクトジェネレーター、例えば React Native CLI を使用することです。

  1. ようこそ 画面で 新規プロジェクト をクリックするか、メインメニューから ファイル | 新規 | プロジェクト を選択します。 新規 プロジェクト ダイアログが開きます。

  2. 左側のペインで、 React Native を選択します。

  3. 右側のペインで:

    1. プロジェクト関連ファイルが保存されるフォルダーへのパスを指定します。

    2. ノードランタイム フィールドで使用する Node.js ランタイムを指定します。 リストから設定済みのランタイムを選択するか、 追加 を選択して新しいランタイムを設定してください。

    3. React Native リストから npx --パッケージ react-native-cli react-native を選択してください。

      または、npm バージョン 5.1 以前の場合、 ターミナル Alt+F12npm install -g react-native-cli を実行して、 react-native-cli パッケージを自分でインストールします。 アプリケーションを作成するときに、 react-native-cli パッケージが保存されているフォルダーを選択します。

  4. 作成 をクリックすると、PhpStorm は必要なすべての構成ファイルを含む React Native 専用プロジェクトを生成し、依存関係をダウンロードして、デフォルト設定の React Native 実行構成を作成します。。

  5. React Native の使用を開始するには、他のツール(iOS シミュレーターなど)をインストールします。 これらのツールのリストは、オペレーティングシステムと、アプリケーションのターゲットとなるモバイルプラットフォームによって異なります。 詳細なインストール手順については、 React Native Getting Started ガイド(英語)を参照してください。

Expo を使用する React Native アプリケーションを作成する。

PhpStorm では、 Expo フレームワークと共にフルスタックの React Native アプリケーションの開発も可能です。

  1. コマンドライン シェルまたは埋め込み ターミナルAlt+F12 )を開いてください。

  2. アプリケーションを作成したい親フォルダーに移動してください。 それを行うには、次を入力してください:

    cd <parent_folder>
  3. アプリケーションを生成し始めるには、次を入力してください:

    npx create-expo-app@latest <application name>
  4. ウィザードの質問に答えます。 例えば、 create-expo -app パッケージのインストール提案を承認したり、使用する Expo SDK のバージョン を選択したりできます。

    Expo アプリの作成

既存の React Native アプリケーションから開始する

既存の React Native アプリケーションの開発を続けるには、PhpStorm で開き、必要な依存関係をダウンロードしてください。

すでにマシン上にあるアプリケーションソースを開く

  • ようこそ 画面で 開く をクリックするか、メインメニューから ファイル | ディレクトリを開く を選択します。 開いたダイアログで、ソースが保存されているフォルダーを選択します。

バージョン管理からアプリケーションのソースをチェックアウト

  1. ようこそ 画面で リポジトリのクローン をクリックします。

    あるいは、メインメニューから ファイル | 新規 | バージョン管理からプロジェクト…Git | クローン…VCS | バージョン管理から取得 を選択します。

    メインメニューの Git の代わりに、プロジェクトに関連付けられている他のバージョン管理システムが表示される場合があります。 例: Mercurial または Perforce​​

  2. 表示されるダイアログで、リストからバージョン管理システムを選択し、アプリケーションソースをチェックアウトするリポジトリを指定します。 詳細については、 プロジェクトをチェックアウトする (クローン)を参照してください。

依存関係をダウンロードする

  • ポップアップで 'npm install' の実行 または 実行 'yarn install' をクリックします。

    アプリケーションを開いて依存関係をダウンロードする

    npmYarn 1 、または Yarn 2 が利用可能です。詳細は npm と Yarn をご参照ください。

  • または、エディターの package.json のコンテキストメニュー、または プロジェクト ツールウィンドウ (Alt+1) で 'npm install' の実行 または 実行 'yarn install' を選択します。

プロジェクトから android フォルダーと iOS フォルダーを除外する

  1. プロジェクト ツールウィンドウ(Alt+1 )で、 android または iOS フォルダーを選択します。

  2. 選択のコンテキストメニューから ディレクトリをマーク を選択し、次に Excluded を選択します。

    IOS フォルダーを除外としてマークする

React Native の使用を開始するには、他のツール(iOS シミュレーターなど)をインストールします。 これらのツールのリストは、オペレーティングシステムと、アプリケーションのターゲットとなるモバイルプラットフォームによって異なります。 詳細なインストール手順については、 React Native Getting Started ガイド(英語)を参照してください。

プロジェクトのセキュリティ

PhpStorm の外で作成しインポートされたプロジェクトを開くと、PhpStorm は未知のソースコードを扱う方法を決定できるダイアログを表示します。

次のいずれかのオプションを選択してください:

  • セーフモードでプレビュー :この場合、PhpStorm はプロジェクトをプレビューモードで開きます。 これは、プロジェクトのソースを閲覧することはできますが、タスクやスクリプトを実行したり、プロジェクトを実行することはできません。

    PhpStorm はエディター領域上部に通知を表示し、 プロジェクトを信頼する… リンクをクリックすればいつでもプロジェクトをロードできます。

  • プロジェクトを信頼 :この場合、PhpStorm はプロジェクトを開いてロードします。 つまり、プロジェクトが初期化され、プラグインが解決され、依存関係が追加され、すべての PhpStorm 機能が利用可能になります。

  • 開かない :この場合、PhpStorm はプロジェクトを開きません。

詳細については プロジェクトのセキュリティ を参照してください。

コーディング支援

PhpStorm は、React API および JavaScript コード内の JSX に対してコード補完を提供します。 コード補完は、React メソッド、React 固有の属性、HTML タグとコンポーネント名、 React イベント(英語) 、コンポーネントプロパティなどに対して機能します。 詳細については、 React: コードの補完を参照してください。

React Native StyleSheet プロパティのコード補完も利用できます:

React Native スタイルシートプロパティの補完

プロジェクトで Flow を使用している場合、PhpStorm はこの型チェッカーによるエラーをエディターでハイライトできます。 詳細については、 PhpStorm での Flow の構成 および WebStorm で Flow を使用する を参照してください。

React Native アプリケーションの実行

物理デバイスまたはシミュレータでアプリケーションを実行できます。 アプリケーションを起動する前に、シミュレータがすでに実行されていることを確認するか、物理デバイスを使用している場合は、すでにコンピューターに接続されていることを確認してください。

PhpStorm は React Native アプリケーションの実行を柔軟に行えます。 例えば初めてアプリケーションを起動する場合、React Native バンドラの実行やアプリケーションのビルド、シミュレータでの起動などをひとつの実行セッション内で選択できます。 すでに実行中の場合はバンドルを起動しないでも、以前の実行以降にネイティブコードに変更を加えていない場合はアプリケーションのビルドを拒否することもできます。

React Native 実行構成を作成する

React Native 実行構成
  1. ツールバーの 実行 / デバッグ構成 ウィジェットから 実行構成の編集 を選択し、 新規構成の追加​ ボタン (「新しい構成を追加」ボタン) をクリックして、リストから React Native を選択して 構成設定を開きます。

    Start creating a run/debug configuration
  2. PhpStorm でアプリケーションをビルドして起動するかどうかを選択してください:

    • 最初にアプリケーションを起動している場合、または前回の実行後にネイティブコードを更新した場合は、 ビルドと起動 チェックボックスを選択します。

    • 最後のビルド以降にアプリケーションのネイティブコードを変更していない場合は、このチェックボックスをオフにしてください。

  3. ビルドと起動 チェックボックスを選択した場合は、ターゲットプラットフォーム、Android または iOS を選択します。

    選択に応じて、PhpStorm は react-native run-ios または react-native run-android を使ってバンドラーを実行します。

    • Android プラットフォームをエミュレートするには、 Android 仮想デバイスを使用します。

    • iOS プラットフォームをエミュレートするには、 ios-sim コマンドラインツールをグローバルにインストールする必要があります。 これは、オペレーティングシステムに応じて、 ノードパッケージマネージャー (npm) を使う、 npm、pnpm、Yarn を参照する、または sudo npm install ios-sim -g コマンドを実行することで実行できます。

    React Native オフィシャル Web サイトの詳細を参照してください。

    オプションで、 引数 フィールドに、 React Native に渡される引数を入力します。たとえば、 ‑‑simulator フラグを使用してシミュレーターの型を指定します: ‑‑simulator="iPhone 4s"

  4. 使用するブラウザーを指定します。

  5. Bundler ホスト フィールドに、React Native バンドラが実行されるホストを指定します。デフォルト値は localhost です。

  6. Bundler ポート フィールドで、React Native バンドルが実行されるポートを指定します。デフォルトでは 8081 が選択されています。詳しくは React Native の公式サイト を参照してください。

  7. 使用する Node.js ランタイムを指定します。

    プロジェクト エイリアスを選択すると、PhpStorm は JavaScript ランタイムページの ノードランタイム フィールドにあるプロジェクトのデフォルトインタープリターを自動的に使用します。 ほとんどの場合、PhpStorm はプロジェクトのデフォルトランタイムを検出してフィールドへ自動入力します。

    別の構成済みのローカルインタープリターまたはリモートインタープリターを選択するか、 閲覧ボタン をクリックして新しいインタープリターを構成することもできます。

  8. react-native-cli へのパスとアプリケーションの 作業ディレクトリ(英語)を指定します。 必要に応じて、 react-native run-android または react-native run-ios の環境変数を入力します。

  9. デフォルトでは、実行構成を呼び出すと PhpStorm が自動で React Native バンドラを起動します。

    すでにコマンドラインなど PhpStorm の外部でバンドラーを起動している場合、停止や再起動せずに再利用できます。 そのような場合は、 起動前 領域でバンドラを選択し、 削除 をクリックします。

    Before Launch からバンドラを削除

すべての実行構成に共通する設定の詳細については、 実行 / デバッグ構成 を参照してください。

デバイスまたはシミュレーターを準備する

Android デバイスを使用している場合、アプリケーションで作業開始時に毎回準備が必要です。

iOS シミュレーターは 1 回だけインストールする必要があります。その後、PhpStorm が react-native run-ios で自動的に起動します。

  • Android デバイスを準備するには、 Android 仮想デバイス を起動するか、USB 経由で物理 Android デバイスに接続してください。

    React Native オフィシャル Web サイトの詳細を参照してください。

  • iOS シミュレーターを準備するには、コマンドラインシェルまたは埋め込み ターミナルAlt+F12 )を開き、次のように入力してください:

    npm install --global ios-sim

アプリケーションの実行

ツールバーの 実行 / デバッグ構成 ウィジェットリストから、新しく作成した React Native 構成を選択し、その横にある the Run button をクリックします。 PhpStorm は 実行 ツールウィンドウを開き、最初に新しい React Native タブで React Native バンドラーを起動します。

その後、選択したターゲットプラットフォームに応じて、 react-native run-ios または react-native run-android コマンドが実行されます。 ビルドが成功すると、シミュレーターはアプリケーションを表示します。

React Native パッケージャーが実行されています
2026 年 8 月 5 日