React Native
React Native を使用すると、JavaScript および React を使用して、iOS および Android 用のネイティブモバイルアプリケーションを開発できます。 これは Facebook によって作成され、Instagram、Airbnb などの有名なアプリで使用され、現在は JetBrains 独自の YouTrack mobile(英語) アプリケーションで使用されています。 React Native オフィシャル Web サイト(英語)の詳細を参照してください。
RubyMine は、React Native アプリケーションの作成、編集、リント、実行、デバッグ、保守を支援します。 RubyMine は、React および Flow シンボルのコード補完も提供します。
始める前に
お使いのコンピューターに Node.js(英語) がインストールされていることを確認してください。
設定 | プラグイン ページ、タブ インストール済み で、 JavaScript および TypeScript と JavaScript デバッガー の必要なプラグインが有効化されていることを確認してください。 詳細は、 プラグインの管理を参照してください。
新しい React Native アプリケーションの作成
RubyMine で React Native アプリケーションを作成する推奨方法は、専用のプロジェクトジェネレーター、例えば React Native CLI を使用することです。
ウェルカム 画面で 新規プロジェクト をクリックするか、メインメニューから を選択します。 新規 プロジェクト ダイアログが開きます。
左側のペインで、 React Native を選択します。
右側のペインで：
プロジェクト関連ファイルが保存されるフォルダーへのパスを指定します。
ノードランタイム フィールドで使用する Node.js ランタイムを指定します。 リストから設定済みのランタイムを選択するか、 追加 を選択して新しいランタイムを設定してください。
React Native リストから npx --パッケージ react-native-cli react-native を選択してください。
または、npm バージョン 5.1 以前の場合、 ターミナル Alt+F12 で
npm install -g react-native-cliを実行して、react-native-cliパッケージを自分でインストールします。 アプリケーションを作成するときに、react-native-cliパッケージが保存されているフォルダーを選択します。
作成 をクリックすると、RubyMine は必要な設定ファイルをすべて含んだ React Native 専用プロジェクトを生成し、依存関係をダウンロードし、デフォルト設定の React Native タイプの実行/デバッグ構成を作成します。。
React Native の使用を開始するには、他のツール（iOS シミュレーターなど）をインストールします。 これらのツールのリストは、オペレーティングシステムと、アプリケーションのターゲットとなるモバイルプラットフォームによって異なります。 詳細なインストール手順については、 React Native Getting Started ガイド(英語)を参照してください。
既存の React Native アプリケーションから開始する
既存の React Native アプリケーションの開発を続けるには、RubyMine で開いて必要な依存関係をダウンロードします。
すでにマシン上にあるアプリケーションソースを開く
ウェルカム 画面で オープン をクリックするか、メインメニューから を選択します。 開いたダイアログで、ソースが保存されているフォルダーを選択します。
バージョン管理からアプリケーションのソースをチェックアウト
ウェルカム 画面で リポジトリのクローン をクリックします。
あるいは、メインメニューから 、 、 を選択します。
メインメニューの Git の代わりに、プロジェクトに関連付けられている他のバージョン管理システムが表示される場合があります。 例えば、 Mercurial または Perforce です。
表示されるダイアログで、リストからバージョン管理システムを選択し、アプリケーションソースをチェックアウトするリポジトリを指定します。 詳細については、 プロジェクトをチェックアウトする（クローン）を参照してください。
依存関係をダウンロードする
ポップアップで 'npm install' の実行 または 実行 'yarn install' をクリックします。
npm、 Yarn 1 、または Yarn 2 を使用できます。詳細は npm と Yarn を参照してください。
または、エディターの package.json のコンテキストメニュー、または プロジェクト ツールウィンドウ (Alt+1) で 'npm install' の実行 または 実行 'yarn install' を選択します。
プロジェクトから android フォルダーと iOS フォルダーを除外する
プロジェクト ツールウィンドウ（Alt+1 ）で、 android または iOS フォルダーを選択します。
選択のコンテキストメニューから ディレクトリをマーク を選択し、次に 除外 を選択します。
React Native の使用を開始するには、他のツール（iOS シミュレーターなど）をインストールします。 これらのツールのリストは、オペレーティングシステムと、アプリケーションのターゲットとなるモバイルプラットフォームによって異なります。 詳細なインストール手順については、 React Native Getting Started ガイド(英語)を参照してください。
プロジェクトのセキュリティ
RubyMine の外部で作成され、インポートされたプロジェクトを開くと、RubyMine はこのプロジェクトの馴染みのないソースコードの処理方法を決定できるダイアログを表示します。
次のいずれかのオプションを選択してください：
セーフモードでプレビュー ：この場合、RubyMine はプロジェクトをプレビューモードで開きます。 これは、プロジェクトのソースを参照することはできますが、タスクやスクリプトを実行したり、プロジェクトを実行 / デバッグしたりすることはできないことを意味します。
RubyMine はエディター領域上部に通知を表示し、 プロジェクトを信頼する… リンクをクリックするといつでもプロジェクトをロードできます。
プロジェクトを信頼 ：この場合、RubyMine はプロジェクトを開いてロードします。 これは、プロジェクトが初期化され、プロジェクトのプラグインが解決され、依存関係が追加され、すべての RubyMine 機能が利用可能になることを意味します。
開かない ：この場合、RubyMine はプロジェクトを開きません。
詳細は プロジェクトのセキュリティ をご覧ください。
コーディング支援
RubyMine は、JavaScript コード内の React API や JSX にコード補完を提供します。 コード補完は、React メソッド、React 固有の属性、HTML タグとコンポーネント名、 React イベント(英語) 、コンポーネントプロパティなどに対して機能します。 詳細については、 React: コードの補完を参照してください。
React Native StyleSheet プロパティのコード補完も利用できます：
プロジェクトで Flow を使用している場合、RubyMine はエディターでこの型チェッカーからのエラーをハイライトできます。 詳細は、 RubyMine での Flow の設定 および WebStorm での Flow の使用 を参照してください。
React Native アプリケーションの実行とデバッグ
物理デバイス上またはシミュレータ上でアプリケーションを実行およびデバッグできます。 アプリケーションを起動する前に、シミュレータがすでに実行されていることを確認するか、物理デバイスを使用している場合は、すでにコンピューターに接続されていることを確認してください。
RubyMine により、React Native アプリケーションの実行およびデバッグが非常に柔軟になります。 例: 初めてアプリケーションを起動する場合は、実行セッションまたはデバッグセッションの一部として、React Native バンドラの実行、アプリケーションのビルド、シミュレータ上でのオープンを選択できます。 すでに実行中の場合はバンドルを起動しないでも、以前の実行以降にネイティブコードに変更を加えていない場合はアプリケーションのビルドを拒否することもできます。
React Native 実行 / デバッグ構成を作成する
ツールバーの 実行 / デバッグ構成 ウィジェットから 実行構成の編集 を選択し、 新規構成を追加 ボタン (
) をクリックして、リストから React Native を選択して 構成設定を開きます。
RubyMine でアプリケーションをビルドして起動するかどうかを選択してください：
最初にアプリケーションを起動している場合、または前回の実行後にネイティブコードを更新した場合は、 ビルドと起動 チェックボックスを選択します。
前回ビルド以来アプリケーションのネイティブコードに変更がない場合は、このチェックボックスをオフにしてください。 デバッグを開始すると、RubyMine は React Native 公式サイト に記載されているとおりリモートデバッグを有効化したシミュレータでアプリケーションを開くのを待機します
ビルドと起動 チェックボックスを選択した場合は、ターゲットプラットフォーム、Android または iOS を選択します。
選択に応じて、RubyMine は
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"。使用するブラウザーを指定します。
React Native アプリケーションのデバッグ時、RubyMine は React Native 自体で利用されている Chrome ランタイムに依存しています。 DevTools も RubyMine と一緒に利用できます。 デバッグセッションを開始すると、RubyMine は新しい Chrome インスタンスを起動して接続します。 新しい Chrome ウィンドウを表示したくない場合は、 Chrome ヘッドレスモード をご利用ください。
Bundler ホスト フィールドに、React Native バンドラが実行されるホストを指定します。デフォルト値は localhost です。
Bundler ポート フィールドで、React Native バンドルが実行されるポートを指定します。デフォルトでは 8081 が選択されています。詳しくは React Native の公式サイト を参照してください。
使用する Node.js ランタイムを指定します。
プロジェクト エイリアスを選択すると、RubyMine は ノードランタイム フィールドから JavaScript ランタイム ページのプロジェクトデフォルトインタープリターを自動的に使用します。 ほとんどの場合、RubyMine がプロジェクトのデフォルトランタイムを検出し、自動的にそのフィールドに入力します。
別の構成済みのローカルインタープリターまたはリモートインタープリターを選択するか、
をクリックして新しいインタープリターを構成することもできます。react-native-cli へのパスとアプリケーションの 作業ディレクトリ(英語)を指定します。 必要に応じて、
react-native run-androidまたはreact-native run-iosの環境変数を入力します。デフォルトでは、実行 / デバッグ構成を起動すると RubyMine が自動的に React Native バンドラーを起動します。 すでに RubyMine の外部、例えばコマンドラインからバンドラーを起動している場合は、停止や再起動をせずに再利用できます。 起動前 領域でバンドラを選択し、
をクリックします。
全ての実行 / デバッグ構成に共通する設定の詳細は、 実行 / デバッグ構成 を参照してください。
デバイスまたはシミュレーターを準備する
Android デバイスを利用している場合、アプリケーションで作業を開始するたびにデバイスを準備する必要があります。
iOS シミュレーターは 1 回だけインストールする必要があります。その後、RubyMine が react-native run-ios で自動的に起動します。
Android デバイスを準備するには、 Android 仮想デバイス(英語)を起動するか、USB 経由でデバッグを有効にして、USB 経由で物理 Android デバイスに接続します。
React Native オフィシャル Web サイトの詳細を参照してください。
iOS シミュレーターを準備するには、埋め込まれた ターミナル （Alt+F12 ）を開き、次のように入力します。
npm install --global ios-sim
アプリケーションの実行
ツールバーの 実行 / デバッグ構成 ウィジェットリストから、新しく作成した React Native 構成を選択し、その横にある 
をクリックします。 RubyMine は 実行 ツールウィンドウを開き、最初に新しい React Native タブで React Native バンドラーを起動します。
その後、選択したターゲットプラットフォームに応じて、 react-native run-ios または react-native run-android コマンドが実行されます。 ビルドが成功すると、シミュレーターはアプリケーションを表示します。
React Native アプリケーションをデバッグする
RubyMine を利用すると、ネイティブ React Native バンドラーを使うアプリケーションや Expo を使うアプリケーションもデバッグできます。
React Native アプリケーションのデバッグ時、RubyMine は React Native 自体で利用されている Chrome ランタイムに依存しています。 DevTools も RubyMine と一緒に利用できます。 デバッグセッションを開始すると、RubyMine は新しい Chrome インスタンスを起動して接続します。 新しい Chrome ウィンドウを表示したくない場合は、 Chrome ヘッドレスモード をご利用ください。
ネイティブバンドラーを使用する React Native アプリケーションをデバッグする
必要に応じて、コードに ブレークポイントを設定します。
上記の説明に従って、新しい React Native 実行 / デバッグ構成を作成します。 バンドラーがすでに RubyMine の外部で実行中の場合は、 起動前 領域で選択し、 削除 ボタン（
）をクリックします。ツールバーの 実行 / デバッグ構成 ウィジェットリストから、新しく作成した React Native 構成を選択し、その横にある
をクリックします。 RubyMine は 実行ツールウィンドウ を開き、新しい React Native タブでバンドラーを実行します。ビルドが完了し、アプリケーションがシミュレーター アプリ内デベロッパーメニューを開く(英語)に表示されたら、 JS をリモートでデバッグする を選択します。 React オフィシャル Web サイト(英語)の詳細を参照してください。
組み込みの RubyMine デバッガーはシミュレータへ接続します。
最初のブレークポイントで停止したら、デバッグセッションを続行し、 ブレークポイントをステップ実行 、フレームを切り替え、オンザフライで値を変更し、 中断中のプログラムを調べ、 式を評価、 ウォッチを設定 できます。
RubyMine で Chrome ヘッドレスを構成する
メインメニューから を選択します。
実行 / デバッグ構成 ダイアログで、React Native 構成を選択
デバッグ用のブラウザー フィールドの横にある 閲覧 ボタン (
) をクリックします。 ウェブブラウザーとプレビュー ダイアログが開きます。Chrome を選択し、 コピー (
) をクリックして、コピーした構成の名前を、たとえば Chrome ヘッドレス に変更します。新しいブラウザー構成を選択し、 編集 ボタン (
) をクリックして、 Chrome 設定 ダイアログで、macOS の場合は --headless、Windows の場合は Linux または--headless --disable-gpuと入力します。実行 / デバッグ構成で、 デバッグ用のブラウザー リストから新しい Chrome ヘッドレス 構成を選択します。 /Users/varvara.zaikina/Library/Application Support/JetBrains/WebStorm2023.3/chrome-user-data
