RubyMine 2025.3 ヘルプ

Bundler

RubyMine は Bundler(英語) との統合をサポートし、IDE 内でアプリケーションの gem 依存関係を処理できるようにします。

Bundler をインストールする

通常、Ruby インタープリターをインストールすると、Bundler もインストールされます。インストールされていない場合は、以下のいずれかの方法でプロジェクトインタープリターに Bundler をインストールできます。

  • メインメニューからツール | Bundler | Bundler をインストールするを選択します。

  • Ctrl を 2 回押し、呼び出されたポップアップで gem install bundler コマンドを実行します。

  • RubyMine ターミナルエミュレータを開き、gem install bundler コマンドを実行します。

バンドル初期化

Bundler をインストールした後、現在のプロジェクトの Gemfile を生成できます。

  • メインメニューからツール | Bundler | 初期化を選択します。

gems をインストールする

次のようにして、Gemfile で定義された gems をプロジェクトインタープリターにインストールできます。

  1. 以下のいずれか 1 つを実行します:

    • Ctrl を 2 回押します。呼び出されたポップアップで、bundler と入力し始め、bundle install を選択して Enter を押します。

    • メインメニューからツール | Bundler | インストールを選択します。

    • Gemfile を開き、プロジェクトインタープリターでハイライト表示されている gem にカーソルを置き、Alt+Enter を押します。'bundler' を使用して、不足している gems をインストールするを選択し、Enter を押します。

      Gemfile inspection
  2. (オプション) デフォルトでは、現在のプロジェクトインタープリターGemfile.lock で指定された必要な Bundler バージョンがない場合、RubyMine によってインストールされます。

    このオプションを無効にするには、次の手順を実行します。

  3. バンドルインストールダイアログで、実行をクリックして、引数なしで bundle install コマンドを実行します。

    Bundle Install dialog

    必要に応じて、このコマンドを実行するときに必要な引数を渡します。例:

    • --without production : Gemfile 内の本番グループでメンションされているものを除くすべての gems をインストールします。

    • --path vendor/bundle : gems を vendor/bundle プロジェクトディレクトリにインストールします。この場合、Bundler は .bundle/config ファイルをプロジェクトのルートに追加します。RubyMine はこの構成ファイルを処理して、gems が vendor/bundle にインストールされていることを検出します。

  4. gems がインストールされるまで待ちます。実行ツールウィンドウに次のプロセスが表示されます。

    Bundler output

    インストールされている gems は、設定 | 言語 & フレームワーク | Ruby インタープリター Ctrl+Alt+S ページで確認できます。

    Ruby Interpreters page

    また、プロジェクトビュー Alt+1外部ライブラリノードでも見つけることができます。

    External libraries

Bundler 設定をカスタマイズする

Bundler メニューを使用して、必要な Bundler バージョンの自動インストールを無効または有効にし、Bundler コマンドのデフォルト引数をカスタマイズします。

Bundler settings menu

Bundler の自動インストールを無効にする

デフォルトでは、RubyMine は Gemfile.lock ファイルで指定されたバージョンの Bundler を自動的にインストールします。この設定を無効にするには、以下の手順を実行してください。

  1. 設定(Ctrl+Alt+S)を開き、ツール | Bundler に移動します。

  2. 常に必要なバージョンの Bundler をインストールするチェックボックスをクリアします。

このオプションを無効にすると、RubyMine は、それぞれの通知ウィンドウで確認した後にのみ、必要なバージョンの Bundler をインストールします。

デフォルト引数をカスタマイズする

このオプションを使用すると、Bundler コマンドのデフォルト引数を指定できます。これにより、Bundler コマンドを実行するたびに引数を尋ねられることなく、これらのコマンドを実行できます。

  1. 設定(Ctrl+Alt+S)を開き、ツール | Bundler に移動します。

  2. デフォルト引数を使用するチェックボックスが選択されていることを確認し、下のテキストフィールドに必要な引数を入力します。

gems をリモートインタープリターにインストールする

リモート Ruby インタープリターを使用している場合、RubyMine はリモートマシンに配置された Gemfile を使用して gems をインストールします。これには、ローカルプロジェクトとリモートプロジェクトのファイル間のマッピングを構成する必要があります。これを行うには、設定 | 言語 & フレームワーク | Ruby インタープリターパスマッピングの編集 Edit Path Mappings ボタンをクリックします。

Ruby Interpreters page

プロジェクトパスマッピングの編集ダイアログで、ローカルおよびリモートプロジェクトのルートパスを指定します。

Edit project path mappings

マッピングを設定したら、ローカルインタープリターに Gems をインストールする命令を使用して gems をインストールします。

リモートインタープリターを使用している場合、RubyMine はリモートマシンからローカルキャッシュに gems をダウンロードして、コードインサイト機能を使用できることに注意してください。この場合、新しい gems が IDE 外のリモートマシンにインストールされた場合があります。ローカルキャッシュに保存されている gems のセットを更新するには、Ruby インタープリターページの gems を同期させる Synchronize gems ボタンをクリックします。

バンドル実行

RubyMine は、Ruby および Rails アプリケーションを実行およびデバッグし、テストを実行し、実行 / デバッグ構成を使用して普遍的な方法でコードをデプロイする機能を提供します。実行 / デバッグ構成は、必要なコマンドをすばやく実行できるようにする起動パラメーターのデフォルトセットを提供します。これらのコマンドは、バンドルのコンテキストで次のように実行できます。

  1. 以下のいずれかの方法で実行 / デバッグ構成ダイアログを開きます。

    • メインメニューから実行 | 実行構成の編集を選択します。

    • ナビゲーションバーが表示された状態(表示 | 外観 | ナビゲーションバー)で、実行 / デバッグ構成セレクターから実行構成の編集を選択します。

      Edit run configurations
    • Alt+Shift+F10 を押してから、0 を押します。

  2. 開いた実行 / デバッグ構成ダイアログで、必要な構成を選択し、Bundler タブを開きます。

  3. バンドルのコンテキストでスクリプトを実行する ('bundle exec') オプションを構成します。

    • 自動検出 : 可能な場合に bundle exec でコードを実行するには、このオプションを選択します。

    • 無効: bundle exec の使用を無効にするには、このオプションを選択します。

    OK をクリックします。

ドライモードでバンドルチェックを実行する

RubyMine は、ドライモードで bundle check を実行するオプションを提供します。この場合、Bundler はロックファイルを作成または更新しません。

  1. メインメニューで、ヘルプ | アクションの検索 Ctrl+Shift+A に移動します。

  2. Run silent bundle check with --dry-run の入力を開始します。オプションを選択し、Enter を押して有効にします。

    Enabling dry mode

    このオプションを有効にしたら、自分でロックファイルを管理する必要があります。Gemfile を変更した後、bundle check/bundle lock を実行してロックファイルを更新します。

2025 年 6 月 19 日

関連ページ:

Ruby 開発環境をセットアップする

プロセスの概要:このトピックでは、ローカルマシンに Ruby 開発環境を構築する手順について説明します。すべてのプラットフォームと目的に同じように適した単一の手順は存在しないことにご注意ください。ここではベストプラクティスをいくつか推奨します。ご自身のニーズとローカルマシンのオペレーティングシステムに応じて、最適なものを選択してください。Ruby をインストールする:このトピックでは、Ruby (Ruby MRI) のリファレンス実装に焦点を当てていますが、RubyMine は JRuby...

Ruby インタープリターを構成する

Ruby コードを RubyMine で操作するには、少なくとも 1 つの Ruby インタープリターを設定する必要があります。インタープリターは、現在開いているプロジェクト用に設定するか、新しいプロジェクトを作成するときに設定できます。Ruby インタープリターの構成は、インストール方法によって異なります。パッケージマネージャー(Ubuntu では apt、macOS では Homebrew など)または Ruby インストーラー(たとえば、Windows では RubyInstaller)を使用して...

ターミナル

RubyMine には、IDE 内からコマンドラインシェルを操作するための組み込みターミナルエミュレータが含まれています。専用のターミナルアプリケーションに切り替えることなく、Git コマンドの実行、ファイルのアクセス許可の設定、その他のコマンドラインタスクの実行に使用します。ターミナルプラグインを有効にするこの機能は、デフォルトで RubyMine にバンドルされて有効になっているターミナルプラグインに依存しています。関連する機能が利用できない場合は、プラグインを無効にしていないことを確認して...

RubyMine クイックスタート

RubyMine は、コードの作成とデバッグから完成したアプリケーションのテストとデプロイまで、Ruby/Rails プロジェクト開発のあらゆる側面で生産性を高めるのに役立つ統合開発環境 (IDE) です。RubyMine は、macOS、Windows、Linux などのさまざまなプラットフォームで利用できます。このチュートリアルでは、Ruby on Rails チュートリアル用に作成されたサンプルアプリケーションのフォークを使用して、RubyMine の主な機能を紹介します。このチュートリアル...

実行 / デバッグ構成

RubyMine は、実行 / デバッグ構成を使用して、コードを実行、デバッグ、デプロイ、テストします。各構成は、何を実行し、どのパラメーターと環境を使用するかを定義する、名前付きのスタートアッププロパティのセットです。要件に応じて構成パラメーターをカスタマイズできます。例:Rails の実行 / デバッグ構成では、サーバータイプ(Puma や Passenger など)、IP アドレスとポート、環境(デフォルトでは開発)などを指定できます。Ruby の実行 / デバッグ構成では、コマンドライン引数...

ユーザーインターフェース

RubyMine でプロジェクトを開くと、デフォルトのユーザーインターフェースは次のようになります。ナビゲーションバー、プロジェクトツールウィンドウ、エディター、ポップアップメニュー、コンテキストメニュー、ステータスバー、ツールウィンドウバー、ツールバー、ガター、プラグインのセットと構成設定によっては、IDE の外観と動作が異なる場合があります。ナビゲーションバー:フォーカス: 表示 / 非表示: ナビゲーションバーはプロジェクトビューの代わりとなるもので、プロジェクトの構造を確認したり、特定のフ...