新規ウォッチャーダイアログ

ファイルタイプ

このリストを使用して、予想される入力ファイルの種類を指定します。 File Watcher は、この種類のファイルのみを分析および処理の対象と見なします。 ファイルの種類は、 ファイルの種類とファイル拡張子の関連付けに基づいて認識されます。

スコープ

このリストでファイルウォッチャーを適用するファイルの範囲を定義します。

これらのファイルを変更すると、 編集したファイルを自動保存してウォッチャーをトリガーする チェックボックスの状態に応じて、直ちに、または保存またはフレームの非アクティブ化時にファイル監視が起動されます。

リストから定義済みスコープの 1 つを選択します。 プロジェクトレベルのファイル監視の場合は、 をクリックして、表示される スコープ ダイアログでカスタムスコープを設定することもできます。

• すべての場所: 下記のすべての範囲

• プロジェクトファイル ：プロジェクトコンテンツルート内のすべてのファイル（プロジェクト構造を構成する を参照）。

• プロジェクトのプロダクション用ファイル: テストソースを除くプロジェクトコンテンツルート内のすべてのファイル。

• プロジェクトテストファイル: プロジェクト内のすべてのファイルがテストソースのルートになります。

• スクラッチとコンソール: プロジェクト ツールウィンドウにある スクラッチとコンソール ディレクトリからのすべてのファイル。

• 開いているファイル: 現在エディターで開かれているすべてのファイル。

• 現在のファイル: アクティブなエディタータブで開かれたファイル

VCS スコープ: これらのスコープは、 プロジェクトがバージョン管理されている場合にのみ使用できます。

• すべての変更ファイル: すべての変更されたファイル、つまりすべての既存の変更リストに関連付けられたすべてのファイル。

• デフォルト変更リスト: 変更リスト   デフォルト に関連付けられているすべてのファイル。

または、 をクリックし、開いた スコープダイアログで カスタムスコープを構成します。

ルートファイルのみを追跡する

ルートファイルとは、他のファイル 指定されたスコープ内に（たとえば import 経由などで）含まれていないファイルです。

• このチェックボックスをオンにすると、File Watcher は ルートファイルに対してのみ実行されます。

• チェックボックスをオフにすると、File Watcher はファイルウォッチャーが呼び出されたファイルに対して実行され、このファイルが指定されたスコープ内に再帰的に含まれるすべてのファイルに対して実行されます。

スコープ 設定は ルートファイルのみを追跡する チェックボックスの設定よりも優先されることに注意してください。依存関係が指定された範囲の外にある場合、ファイルウォッチャーはそれに適用されません。

例2 つのファイル root.scss と another.scss があり、 root.scss が another.scss をインポートしているとします。 ルートファイルのみを追跡する チェックボックスをオンにすると、 another.scss を編集すると、 root.scss でのみ File Watcher が呼び出されます。 チェックボックスをオフにすると、File Watcher はこれらの両方のファイルを処理します。

プログラム

このフィールドでは、ツールの実行可能ファイルへのパスを指定します（ .com 、 .exe 、 .cmd 、 .bat 、または特定のツールに応じてその他）。

引数

このフィールドでは、ツールに渡す引数を定義してツールの挙動に影響を与えます。

引数は通常、実際のファイル名に置き換えられる $FileName$ や $FileNameWithoutExtension$ などの マクロを使用して指定されます。

マクロを手動で入力するか、 をクリックして、開いた マクロ ダイアログのリストから関連するパターンを選択します。

リフレッシュする出力パス

このフィールドで、RubyMine にツールの出力、つまり生成されるソースコード・ソースマップ・依存関係やファイル自体をどこで検索するか伝えます。 出力の場所はツールによって異なります。

通常、出力パスは マクロを使用して指定されます。 手動で入力するか、 をクリックして、開いたダイアログのリストから関連するものを選択できます。

複数のマクロを指定するには、区切り文字としてコロン : を使用します (例: $FileNameWithoutExtension$.css:$FileNameWithoutExtension$.css.map)。

作業ディレクトリ

このフィールドでは、ツールが適用されるディレクトリを指定します。 ツールは常にファイルのコンテキストで呼び出されるため、デフォルトの作業ディレクトリは現在のファイルのディレクトリです。 デフォルトの作業ディレクトリは、 $FileDir$ マクロを使用してすべての定義済みテンプレートで指定されます。 カスタム作業ディレクトリを指定するには、そのパスをフィールドに入力するか、 をクリックし パスの選択 ダイアログでディレクトリを選択、または をクリックして マクロ ダイアログのリストから目的の マクロを選択してください。

環境変数

このフィールドには、ツールが必要とするがオペレーティングシステムレベルでは指定されていない環境変数を指定します。

編集したファイルを自動保存してウォッチャーをトリガーする

• このチェックボックスをオンにすると、RubyMine はファイル編集後すぐ保存し、ファイルウォッチャーが即座に起動します。

• チェックボックスをオフにすると、保存時（ファイル | すべて保存 ）または RubyMine からフォーカス移動時（フレーム非アクティブ化時）にファイルウォッチャーが起動します。

外部の変更でウォッチャーをトリガーする

• このチェックボックスをオンにすると、RubyMine 外での変更やバージョン管理システムでブランチをチェックアウト後の変更を含め、そのスコープ内ファイルへのすべての変更時にファイルウォッチャーが起動します。

• チェックボックスをオフにすると、そのスコープ内のファイルが RubyMine から更新された場合のみファイルウォッチャーが起動し、バージョン管理システムから受信した変更等は無視されます。

構文エラーに関係なくウォッチャーをトリガーする

• チェックボックスをオンにすると、File Watcher はファイルの構文上の正確さに関係なく起動します。 ファイルウォッチャーは、 編集したファイルを自動保存してウォッチャーをトリガーする チェックボックスの状態に応じて、更新、保存、フレームの非アクティブ化時に開始されます。

• このチェックボックスをオフにすると、File Watcher は構文上無効なファイル内のすべてのトリガーを無視し、エラーのないファイルでのみ起動します。

stdout から出力ファイルを作成

• ほとんどの場合、このチェックボックスは、ほとんどのツールが関連するファイルに直接出力を書き込むため、クリアする必要があります。

• このチェックボックスを選択すると、RubyMine はネイティブツールの出力 standard output stream (stdout) を読み込み、そこから生成ファイルを作成します。 生成されたファイルの名前は リフレッシュする出力パス フィールドから取られます。 フィールドに複数の名前が含まれている場合は、リストの最初の名前が使用されます。

コンソールの表示

このリストから、ファイルウォッチャーでコンソールを開くタイミングを選択します。

• 常時: このオプションを使用すると、ツールの実行が完了した後にコンソールが常に開きます。

• エラー時: このオプションを使用すると、 Exit code が 0 と異なる場合にのみツール実行後にコンソールが開きます。

• なし: コンソールをまったく開かないようにするには、このオプションを選択します。

出力フィルター

このフィールドで、ツールに関連付けられている出力フィルターを指定します。 これらのフィルターに基づいて、ツールの出力の絶対ファイルパスと行番号がハイパーリンクに変換されます。 これらのリンクをクリックすると、対応するファイルがエディターで開きます。

例: 有用なエラーメッセージを表示するには、 $FILE_PATH$:$LINE$ $MESSAGE$ と入力します