Grunt
JetBrains Rider は Grunt JavaScript タスクランナー と連携します。 JetBrains Rider は Gruntfile.js ファイルを解析し、タスクとターゲットの定義を認識し、ツリービューでタスクとターゲットを表示し、ツリー内のタスクやターゲットと Gruntfile.js ファイルにあるその定義との間をナビゲートできるようにし、タスクやターゲットの実行およびデバッグをサポートします。
JetBrains Rider では、専用の Grunt ツールウィンドウ のタスクツリーや Grunt 実行構成 、または起動前タスクとして Grunt タスクを実行できます。 JetBrains Rider は 実行ツールウィンドウでタスク実行の結果を表示します。 ツールウィンドウには Grunt の出力が表示され、エラーが発生したことが表示され、見つからなかったパッケージやプラグインが一覧表示されます。 最後に実行されたタスクの名前がツールウィンドウのタイトルバーに表示されます。
始める前に
Node.js をダウンロードしてインストールします。
Grunt のインストール
JetBrains Rider プロジェクトで Grunt を使用するには、パッケージが 2 つ必要です:
Grunt コマンドを実行するためにグローバルにインストールされた grunt-cli パッケージ(Grunt コマンドラインインターフェース)。
プロジェクトタスクのツリーをビルドし、 Gruntfile.js または Gruntfile.coffee ファイルの編集時にコーディング支援を提供する開発依存関係としてインストールされた grunt パッケージ。 Grunt 公式サイトから Gruntfile.js について詳しく見ることができます。
grunt-cli をグローバルにインストールする
組み込み ターミナル (Alt+F12) で次のように入力します。
npm install -g grunt-cli
プロジェクトに Grunt をインストールする
組み込み ターミナル (Alt+F12) で次のように入力します。
npm install grunt --save-dev
タスクツリーから Grunt タスクを実行する
JetBrains Rider を使用すると、 Grunt ツールウィンドウのタスクツリーから Grunt タスクを簡単かつ迅速に実行できます。 JetBrains Rider は自動的に一時的な実行構成を作成し、必要に応じて保存して後で使用できます。
Grunt ツールウィンドウを開く
JetBrains Rider セッション中に初めてタスクのツリーをビルドするとき、 Grunt ツールウィンドウはまだ開かれていません。
エクスプローラー ツールウィンドウ(Alt+1 )で必要な Gruntfile.js ファイルを選択するか、エディターでファイルを開き、コンテキストメニューから Grunt タスクを表示 を選択します。
Grunt ツールウィンドウからタスクのツリーを構築する
Grunt ツールウィンドウで、ツールバーの
をクリックし、リストから必要な Gruntfile.js ファイルを選択します。 デフォルトでは、JetBrains Rider はプロジェクトのルートに Gruntfile.js ファイルを表示します。
別の Gruntfile.js ファイルがある場合は、 Gruntfile.js を選択 をクリックし、表示されるダイアログで必要な Gruntfile.js ファイルを選択します。 JetBrains Rider は、タイトルに選択した Gruntfile.js ファイルへのパスを持つ新しいノードを追加し、そのノードの下にタスクツリーを構築します。
ツリーを再構築する
必要なノードに切り替えて、ツールバーの
をクリックします。
ツリー内のタスクを名前で並べ替える
ツールバーの
をクリックし、メニューから 並べ替え を選択し、続けて 名前 を選択します。
デフォルトでは、ツリーには、 Gruntfile.js (オプション 定義順序 )で定義されている順序でタスクが表示されます。
タスクまたはターゲットを実行する
タスクまたはターゲットをダブルクリックします。
ツリーでタスクまたはターゲットを選択して Enter を押すか、コンテキストメニューから 実行 <タスク名> を選択します。
タスクツリーからタスクを実行する場合、 強制実行と 詳細モードのオプションは使用できないことに注意してください。 その結果、たとえば警告を無視したり詳細なログを提供したりするように JetBrains Rider を構成することはできません。 これらのオプションを使用するには、下記 実行構成によるタスクの実行とデバッグで説明されているように、実行構成からタスクまたはターゲットを実行してください。
デフォルトのタスクを実行する
ツリーのルートノードを選択し、選択したコンテキストメニューから デフォルトを実行 を選択します。
いくつかのタスクまたはターゲットを実行する
複数選択モードを使用します:隣接するアイテムの場合は Shift (for adjacent items)キーを、隣接しないアイテムの場合は Ctrl (for non-adjacent items)キーを押しながら、必要なタスクまたはターゲットを選択し、選択した項目のコンテキストメニューから 実行 または デバッグ を選択します。
タスクまたはターゲットの定義に移動する
ツリーで必要なタスクまたはターゲットを選択して、選択のコンテキストメニューから ソースに移動 を選択します。
実行構成に応じたタスクの実行とデバッグ
タスクやターゲットを実行したときに JetBrains Rider が自動で作成する 一時的な実行構成を使用する他に、独自の Grunt.js 実行構成を作成して起動できます。
Grunt.js の実行 / デバッグ構成を作成する
に進みます。 または、ツールバーの 実行 ウィジェットから 実行構成の編集 を選択します。

開いた 実行構成の編集 ダイアログで、ツールバーの 追加 ボタン (
) をクリックし、リストから Grunt.js を選択します。 実行/デバッグ構成: Grunt.js ダイアログが開きます。
実行構成の名前、実行するタスク(区切り文字として空白スペースを使用)、これらのタスクが定義されている Gruntfile.js ファイルの場所、およびグローバルにインストールされた grunt-cli パッケージへのパスを指定します。
使用する Node.js ランタイムを指定します。
プロジェクト エイリアスを選択すると、JetBrains Rider は ノードランタイム フィールドがある JavaScript ランタイムページのプロジェクトデフォルトインタープリターを自動的に使用します。 ほとんどの場合、JetBrains Rider はプロジェクトのデフォルトランタイムを検出し、フィールドに自動入力します。
別の構成済みのローカルインタープリターまたはリモートインタープリターを選択するか、
をクリックして新しいインタープリターを構成することもできます。
必要に応じて、Node.js に渡す Node.js 固有のオプションパラメーターと 環境変数(英語)を指定します。
タスクを実行する
ツールバーの 実行 / デバッグ構成 ウィジェットリストから、新しく作成した 構成を選択し、その横にある
をクリックします。 JetBrains Rider は 実行ツールウィンドウにタスクの出力を表示します。
タスクをデバッグする
Grunt.js 実行/デバッグ構成を 上記の手順で作成します。
エディターで Gruntfile.js ファイルを開き、必要に応じて ブレークポイント を設定します。
デバッグセッションを開始するには、メインツールバーのリストから必要なデバッグ構成を選択して、リストの横にある
をクリックするか、メインメニューから を選択します。
開いた デバッグウィンドウ で、 中断されたプログラムを調べる や コードをステップスルーする に従い、中断されたタスク実行を分析したりタスクをステップ実行したりします。
Grunt タスクを起動前タスクとして実行する
メインメニューから を選択して 実行 / デバッグ構成ダイアログ ダイアログを開き、リストから必要な構成を選択するか、
をクリックして該当する実行構成タイプを選択し新しく作成します。
開いたダイアログで、 起動前 エリアの
をクリックし、リストから Grunt タスクを実行 を選択します。
表示される Grunt タスク ダイアログで、必要なタスクが定義されている Gruntfile.js を指定し、実行するタスクを選択して、Grunt ツールに渡す引数を指定します。
Node.js ランタイムの場所、それに渡すパラメーター、 grunt-cli パッケージへのパスを指定します。
Grunt タスクを自動的に実行する
定期的に実行するタスクまたはターゲットがある場合は、対応する実行構成を 起動タスクのリストに追加できます。 タスクはプロジェクトの起動時に自動的に実行されます。
設定 ダイアログ (Ctrl+Alt+S) で、 に進みます。
開いた 起動タスクページで、ツールバーの
をクリックします。
リストから、必要な Grunt 実行構成を選択します。 設定がリストに追加されます。
プロジェクトに適用可能な構成がない場合は、
をクリックして 実行構成の編集 を選択します。 次に、開いた 実行 / デバッグ構成ページで必要な設定を使用して構成を定義します。 新しい設定を保存すると、自動的に起動タスクのリストに追加されます。