Grunt

grunt-cli をグローバルにインストールする

• 組み込み ターミナル (Alt+F12) で次のように入力します。

  npm install -g grunt-cli

プロジェクトに Grunt をインストールする

• 組み込み ターミナル (Alt+F12) で次のように入力します。

  npm install grunt --save-dev

Grunt ツールウィンドウを開く

WebStorm セッション中に初めてタスクのツリーを構築するとき、 Grunt ツールウィンドウはまだ開かれていません。

• プロジェクト ツールウィンドウ（Alt+1 ）で必要な Gruntfile.js ファイルを選択するか、エディターでファイルを開き、コンテキストメニューから Grunt タスクの表示 を選択します。

Grunt ツールウィンドウからタスクのツリーを構築する

1. Grunt ツールウィンドウで、ツールバーの をクリックし、リストから必要な Gruntfile.js ファイルを選択します。 デフォルトで WebStorm はプロジェクトのルートの Gruntfile.js ファイルを表示します。

2. 別の Gruntfile.js ファイルがある場合は、 Gruntfile.js を選択 をクリックして表示されるダイアログで必要な Gruntfile.js ファイルを選択します。 WebStorm は、タイトルに選択した Gruntfile.js ファイルのパスを表示した新しいノードを追加し、その下にタスクツリーを構築します。

ツリーを再構築する

• 必要なノードに切り替えて、ツールバーの をクリックします。

ツリー内のタスクを名前で並べ替える

• ツールバーの をクリックし、メニューから 並べ替え を選択してから、 名前 を選択します。

  デフォルトでは、ツリーには、 Gruntfile.js （オプション 定義順序 ）で定義されている順序でタスクが表示されます。

タスクまたはターゲットを実行する

• タスクまたはターゲットをダブルクリックします。

• ツリーでタスクまたはターゲットを選択して Enter を押すか、コンテキストメニューから 実行 <タスク名> を選択します。

タスクツリーからタスクを実行する場合、 強制実行と 詳細モードのオプションは使用できないことに注意してください。 その結果、たとえば警告を無視したり詳細なログを出力したりするように WebStorm を設定することはできません。 これらのオプションを使うには、下記の 実行構成によるタスクの実行およびデバッグの手順に従って、実行構成からタスクやターゲットを実行してください。

デフォルトのタスクを実行する

• ツリーのルートノードを選択し、選択したコンテキストメニューから デフォルトを実行 を選択します。

いくつかのタスクまたはターゲットを実行する

• マルチ選択モードを使います：隣接する項目は Shift キー、非隣接項目は Ctrl キーを押しながら必要なタスクやターゲットを選択し、その選択範囲のコンテキストメニューから 実行 または デバッグ を選択します。

タスクまたはターゲットの定義に移動する

• ツリーで必要なタスクまたはターゲットを選択して、選択のコンテキストメニューから ソースに移動 を選択します。

Grunt.js の実行 / デバッグ構成を作成する

1. 実行 | 実行構成の編集 に進みます。 または、ツールバーの 実行 ウィジェットから 実行構成の編集 を選択します。

   

   開いた 実行構成の編集 ダイアログで、ツールバーの 追加 ボタン () をクリックし、リストから Grunt.js を選択します。 実行/デバッグ構成：Grunt.jsダイアログが開きます。

2. 実行構成の名前、実行するタスク（区切り文字として空白スペースを使用）、これらのタスクが定義されている Gruntfile.js ファイルの場所、およびグローバルにインストールされた grunt-cli パッケージへのパスを指定します。

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

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

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

   詳細については、「リモート Node.js ランタイムの構成」、「ローカル Node.js ランタイムの構成」、「Linux の Windows サブシステムで Node.js を使用する 」を参照してください。

   必要に応じて、Node.js に渡す Node.js 固有のオプションパラメーターと 環境変数(英語)を指定します。

タスクを実行する

• ツールバーの 実行 / デバッグ構成 ウィジェットリストから、新しく作成した 構成を選択し、その横にある をクリックします。 WebStorm は 実行ツールウィンドウ でタスクの出力を表示します。

タスクをデバッグする

1. Grunt.js の実行 / デバッグ構成を 上記の手順に従って作成してください。

2. エディターで Gruntfile.js ファイルを開き、必要に応じて ブレークポイントを設定します。

3. デバッグセッションを開始するには、メインツールバーのリストから必要なデバッグ構成を選択して、リストの横にある をクリックするか、メインメニューから 実行 | デバッグ <構成名> を選択します。

4. 開いた デバッグツールウィンドウ で、中断されたタスクの実行を分析したり、 中断されたプログラムを調べる や プログラムのステップスルー に従ってステップ実行したりします。

Grunt タスクを起動前タスクとして実行する

1. メインメニューで 実行 | 実行構成の編集 を選択して 実行 / デバッグ構成ダイアログ ダイアログを開き、リストから必要な構成を選択するか、 をクリックして該当する実行構成タイプを選択して新規作成してください。

2. 開いたダイアログで、 起動前 エリアの をクリックし、リストから Grunt タスクを実行 を選択します。

3. 表示される Grunt タスク ダイアログで、必要なタスクが定義されている Gruntfile.js を指定し、実行するタスクを選択して、Grunt ツールに渡す引数を指定します。

   Node.js ランタイムの場所、それに渡すパラメーター、 grunt-cli パッケージへのパスを指定します。

1. 設定 ダイアログ（Ctrl+Alt+S ）で ツール | スタートアップタスク に移動します。

2. 開いた 起動タスクページで、ツールバーの をクリックします。

3. リストから、必要な Grunt 実行構成を選択します。 設定がリストに追加されます。

   プロジェクトに適用可能な構成がない場合は、 をクリックして 実行構成の編集 を選択します。 次に、開いた 実行 / デバッグ構成ページで必要な設定を使用して構成を定義します。 新しい設定を保存すると、自動的に起動タスクのリストに追加されます。