IntelliJ IDEA 2020.3 ヘルプ

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

ファイルウォッチャーページ追加the Add button または編集the Edit button ボタンをクリックするとダイアログが開きます。ダイアログを使用して、事前定義済み IntelliJ IDEA File Watcher テンプレートに基づいてプロジェクトファイル監視を作成するか、既存のプロジェクトファイル監視を編集します。

各テンプレートには、選択したツールに最適な設定が含まれています。ほとんどの場合、必要なのは、ツールの実行可能ファイルへのパスを指定することだけです。

名前

名前」フィールドに、ファイル監視の名前を入力します。デフォルトでは、IntelliJ IDEA は選択された定義済みテンプレートの名前を提案します。

監視するファイル

ファイルタイプ

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

スコープ

このリストを使用して、ファイル監視を適用できるファイルの範囲を定義します。

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

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

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

  • プロジェクトファイル : プロジェクトコンテンツルート内のすべてのファイル(コンテンツルートを参照)。

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

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

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

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

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

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

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

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

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

ルートファイルのみを追跡する ルートファイルとは、指定された範囲内の他のファイルに含まれていないファイルです(たとえば import を介して)。
  • このチェックボックスをオンにすると、ファイルウォッチャーはルートファイルに対してのみ実行されます。

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

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


root.scssanother.scss をインポートする 2 つのファイル root.scssanother.scss があるとします。ルートファイルのみを追跡するチェックボックスを選択した状態で、another.scss を編集すると、root.scss でのみファイルウォッチャーが呼び出されます。それ以外の場合、チェックボックスがオフになっていると、ファイルウォッチャーはこれらのファイルの両方を処理します。

変更時に実行するツール

この領域では、ツールとの対話を構成します。使用する実行可能ファイル、渡す引数、IntelliJ IDEA がツールの出力を探す場所を指定します。

プログラム

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

引数

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

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

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

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

このフィールドで、IntelliJ IDEA にツールの出力を検索する場所(結果のソースコード、ソースマップ、依存関係、またはファイル自体)を指定します。出力の場所はツールによって異なります。

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

リフレッシュする出力パスフィールドの値を変更しても、ツールはその出力を別の場所に保存しません。それでもそれを行う必要がある場合は、引数フィールドに希望のカスタム出力位置を指定します。コロンとしてコロンを使用して出力パスを区切り文字として入力し、マクロを使用します。

作業ディレクトリと環境変数

作業ディレクトリ

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

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

拡張オプション

編集したファイルを自動保存してウォッチャーをトリガーする
  • このチェックボックスをオンにすると、ファイルウォッチャーがすぐに起動するように IntelliJ IDEA はファイルを編集するとすぐにファイルを保存します。

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

外部の変更でウォッチャーをトリガーする
  • このチェックボックスをオンにすると、IntelliJ IDEA 以外の変更や、バージョン管理システムのブランチをチェックアウトした後の変更を含め、ファイルウォッチャーがそのスコープからファイルを変更したときに起動します。

  • チェックボックスをオフにすると、スコープのファイルが IntelliJ IDEA から更新され、バージョン管理システムから受け取った変更などの他の変更は無視されます。

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

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

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

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

コンソールの表示

このリストから、ファイル監視がいつコンソールを開くかを選択します。

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

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

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

出力フィルター

このフィールドでは、ツールに関連付けられた出力フィルターを指定します。これらのフィルターに基づいて、ツールの出力の絶対ファイルパスと行番号がハイパーリンクに変換されます。これらのリンクをクリックすると、対応するファイルがエディターで開きます。
例: 有用なエラーメッセージを表示するには、$FILE_PATH$:$LINE$ $MESSAGE$ と入力します

関連ページ:

設定: ファイル監視

このページは、ファイル監視プラグインが有効になっている場合に使用できます。ファイル監視の構成の詳細については、ファイル監視を参照してください。ファイル監視プラグインは IntelliJ IDEA にバンドルされていませんが、JetBrains リポジトリからプラグインをインストールするに従って設定 / 環境設定 | プラグインページにインストールできます。ファイル監視は、ファイルへの変更を追跡し、サードパーティのスタンドアロンアプリケーションを実行する IntelliJ IDEA システムです。...

ファイルタイプの関連付けを設定する

IntelliJ IDEA はデフォルトのファイルタイプのセットを認識します。そのようなファイルは、対応する言語の構文に従って解析およびハイライトされます。IntelliJ IDEA が認識できないファイルタイプで作業している場合(たとえば、それが独自開発のファイルタイプである場合)、カスタムファイルタイプを作成することもできます。キーワード、コメント、数字などのハイライトスキームを定義することによって、IDE がファイルを解析する方法を設定することができます。各ファイル形式を拡張子に関連付ける...

コンテンツルート

IntelliJ IDEA のコンテンツは、ソースコード、ビルドスクリプト、単体テスト、ドキュメントを含むファイルのグループです。これらのファイルは通常、階層構造になっています。最上位のフォルダーはコンテンツルートと呼ばれます。モジュールには通常、1 つのコンテンツルートがあります。コンテンツルートを追加することができます。たとえば、コードがコンピューター上の別の場所に格納されている場合には、これは便利です。同時に、モジュールはコンテンツルートなしで存在することができます。この場合、他のモジュー...

バージョン管理を有効にする

IntelliJ IDEA は 2 つのレベルでバージョン管理統合をサポートします。IDE レベルでは、VCS 統合は、デフォルトで有効になっているバンドルされたプラグインのセットを通じて提供されます。プロジェクトレベルでは、プロジェクトフォルダーを 1 つまたは複数のバージョン管理システムと関連付けることで、VCS 統合が有効になります。プロジェクトルートをバージョン管理システムに関連付ける:IntelliJ IDEA を使用すると、プロジェクトとバージョン管理システムとの統合をすばやく有効...

スコープとファイルの色

スコープは、プロジェクト内のファイル、パッケージ、フォルダーのグループです。スコープを使用して、さまざまな IDE ビューのプロジェクトアイテムを視覚的に区別し、特定の操作の範囲を制限できます。スコープは、プロジェクト内のファイルを論理的に整理するように設計されています。テストソースはテスト関連のスコープに移動でき、製品コードは製品ファイルのスコープに関連付けることができます。これらの論理チャンクにより、プロジェクトの管理が容易になります。例: テスト関連のインスペクションをテストクラスでのみ実...

パス変数

パス変数は、プロジェクトにリンクされているがその外部に格納されているリソースへの絶対パスを表すプレースホルダーです。チームで働いているなら、あなたのチームメイトのコンピューター上のこれらの絶対パスは異なるかもしれません。パス変数を使用すると、パス変数が特定の各コンピューターの構成に応じて値を受け入れるため、リンクされたリソースへのすべての参照が正しく解決されるように、コードを柔軟に共有できます。IntelliJ IDEA にはいくつかの事前定義された変数があります:: ホームディレクトリを表しま...