スコープとファイルの色

スコープは、プロジェクト内のファイルとフォルダーのグループです。スコープを使用して、さまざまな IDE ビューでプロジェクト項目を視覚的に区別し、特定の操作の範囲を制限できます。

スコープは、プロジェクト内のファイルを論理的に編成するように設計されています。テストソースはテスト関連のスコープに移動でき、製品コードは製品ファイルのスコープに関連付けることができます。これらの論理チャンクにより、プロジェクトの管理が容易になります。例: テスト関連のインスペクションをテストクラスでのみ実行すると、アプリケーション内のすべてのファイルで実行する場合よりも時間がかかりません。

AppCode には一連の定義済みスコープが付属していますが、カスタムスコープを作成することもできます。そこで、任意のファイルとフォルダーを含めることができます。例: カスタムスコープに含めることができるのは、自分が担当するプロジェクト内のファイルのみです。

AppCode では、スコープはコードインスペクション、一部のリファクタリング、検索、コピーライト設定、コード分析のさまざまな機能などで使用されます。

スコープには、ローカルと共有の 2 種類があります。

ローカルスコープは IDE 構成ディレクトリに格納されているため、VCS を通じて共有されず、チームの他のメンバーは使用できません。
共有スコープは VCS に追加されるため、プロジェクトで作業する人々は同じスコープを使用できます。これらのスコープは、プロジェクトとともに .idea の scopes フォルダーに格納されます。各スコープは、.xml 拡張子を持つファイルとして保存されます（例: MyProject/.idea/scopes/shared-scope.xml）。

プロジェクトがバージョン管理されている場合は、共有スコープを使用することは理にかなっています。VCS を使用しない場合は、ローカルスコープで十分です。

新しいスコープを定義する

AppCode には一連の定義済みスコープがありますが、独自のスコープを定義することもできます。

Ctrl+Alt+S を押して IDE 設定を開き、外観 & 振る舞い | スコープを選択します。
をクリックし、定義するスコープの種類（ローカルまたは共有）を選択します。
後で VCS で共有するチェックボックスを使用して、選択したスコープの状態（ローカルまたは共有）を変更できます。
開いたダイアログで、新しいスコープに名前を付け、OK をクリックします。
新しいスコープにファイルを追加します。プロジェクトツリーで必要な項目を選択し、ツリーの右側にあるオプションのいずれかをクリックします。
- 含める : 選択したアイテムを含めます。フォルダーを含める場合、このアクションはこのフォルダー内にあるファイルのみを追加します。ネストされたすべてのサブフォルダーとその内容は含まれません。
- 再帰的に含める : ネストされたサブフォルダーとその内容とともに、選択したフォルダーを含めます。
- 除外 : 選択したアイテムをスコープから除外します。フォルダーを除外する場合、このアクションはこのフォルダー内にあるファイルのみを削除します。ネストされたすべてのサブフォルダーとその内容はスコープに残ります。
- 再帰的に除外する : 選択したフォルダーをネストされたサブフォルダーとその内容と共に除外します。
スコープにファイルを追加すると、AppCode によって式が作成され、パターンフィールドに表示されます。ボタンを使用する代わりに、スコープ言語構文リファレンスを使用してパターンフィールドにパターンを手動で入力することもできます。
変更を適用し、ダイアログを閉じます。

選択した範囲で表示されるファイルとフォルダーは、含まれているものと含まれていないものを理解するのに役立つように、さまざまな色で表示されます。

スコープに含まれるファイルとフォルダー。
除外されるファイルと含まれるファイルおよびフォルダーの両方を含むフォルダー。
選択したスコープから除外されているファイルとフォルダー。

カスタムスコープを作成すると、プロジェクトツールウィンドウとすべてのダイアログボックスに表示され、アクションを適用するファイルの数を制限できます。

The new scope shown in the Project tool window

定義済みのスコープ

AppCode は、事前定義されたスコープのセットを提供します。IDE は、それらに関する情報に基づいて、これらのスコープにファイルを自動的に追加します。これらのスコープは変更できないことに注意してください。

定義済みスコープのリスト

ファイル : このスコープには、プロジェクトコンテンツルート内のすべてのファイルが含まれます。ライブラリとフレームワークは、通常、このスコープには含まれません。
プロジェクトソースファイル : このスコープは、プログラムやテストなどのプロジェクトソースコードを含むファイルに対応します。
プロジェクト非ソースファイル : このスコープは、リソース、ライセンスなどの他のプロジェクトファイルに対応します。
スクラッチとコンソール : プロジェクトツールウィンドウにあるスクラッチとコンソールディレクトリのすべてのファイルが含まれます。
すべての変更ファイル : エディターで開いたり変更したりした最後の 50 個のファイルが含まれます。環境設定ダイアログ（Ctrl+Alt+S）のエディター | 一般ページの制限領域で最近のファイルの数を変更できます。
開いているファイル : 現在エディターで開いているファイルが含まれます。

スコープを色に関連付ける

異なるスコープに属するファイルは、検索結果、エディタータブ、プロジェクトツールウィンドウで異なる色でハイライトできます。

Scope highlighting in the editor tabs and search results

各スコープに、独自の色を割り当てることができます。例: 開いているファイルスコープに色を割り当て、プロジェクトツールウィンドウにこの色を表示するように IDE を構成できます。この場合、エディターで現在作業しているファイルは、プロジェクトツリーで色分けされます。これにより、プロジェクトのナビゲーションがより速く簡単になります。ファイルの色はスコープに関連してのみ機能することに注意してください。

スコープと同様に、色の関連付けはローカルで共有できます。

ローカル色はあなただけに表示され、VCS を通じて共有されません。
共有色はバージョン管理下に置かれるため、プロジェクトで作業する人々は同じ色の関連付けを使用できます。これらは、fileColors.xml ファイルの .idea のプロジェクトフォルダーに格納されます（例: MyProject/.idea/fileColors.xml）。

新しい色の関連付けを作成する

Ctrl+Alt+S を押して IDE 設定を開き、外観 & 振る舞い | ファイルカラーを選択します。
ファイルの色を使用可能にするチェックボックスが選択されていることを確認してから、色を使用する場所を選択します。エディタータブで使用するまたはプロジェクトビューで使用するを選択します。
プロジェクトビューで使用するチェックボックスを選択すると、プロジェクトツールウィンドウと検索結果（たとえば、複数ファイル内検索ダイアログ Ctrl+Shift+F）に色が表示されます。
をクリックし、色を設定するスコープを選択します。
事前定義されたスコープの 1 つを選択するか、カスタムスコープを使用できます。
必要なスコープの横にある矢印をクリックし、開いたリストから色を選択します。
独自の色を構成するには、カスタムをクリックします。
色を編集するには、色列で必要なスコープに対応するセルをクリックし、リストから新しい色を選択します。
VCS を介して色を共有するには、共有列の対応する行のチェックボックスを選択します。チェックボックスがオフの場合、色はローカルで使用されます。
変更を適用し、ダイアログを閉じます。