コンテンツにスキップ
AggregaAggrega
言語の選択: 日本語
このページは機械翻訳されています。英語の原文を読む。

作業する Release を選択する

選択中の Release:状態バーのインジケーターと Commands パネル上部の Release 行で、どちらもエディターが作業対象としている 1 つの Release を示します。Release を対象とするすべての操作(検証、トポロジーグラフ、ビルド、プレビュービルド、プル)は、その Release を対象にします。すでに開いているグラフパネルは、別の Release を選択しても描画元の Release を保ち、グラフを再表示すると新たに選択した Release が描画されます。グラフ、ビルド、プレビュービルド、プルは、その Release がビルドに使うカタログディレクトリを読み取ります。ワークスペース設定が workspace.releases の下でその Release 用のディレクトリを指定していればそれを、そうでなければワークスペースのディレクトリを使います。これはターミナルで aggrega build --release が読み取るものと同じなので、1 つのウィンドウで、フラグを渡すことなく、ワークスペースの各 Release をそれぞれ独自のカタログに対してビルドできます。Catalog パネル、インスペクション、Catalog 行のチェック、ホバー、補完、Go to Definition、Find References、Find Implementations も、選択中の Release の観点で応答します。ワークスペース設定が Release ごとにカタログディレクトリを指定している場合、それぞれが、別の Release だけが読み取るディレクトリ内のものを除いてワークスペースが保持するドキュメントと、選択中の Release がビルドに使うカタログディレクトリを読み取ります。そのため、複数のバリアントが Release ごとに 1 つずつ宣言している名前は、選択中の Release のものに解決されます。Release を選択していない場合は、ワークスペース自体の観点で応答します。Release の選択を参照してください。

Release の選択

拡張機能が行うことのほとんどは、Release を単位としています。どのカタログディレクトリが読み込まれるか、どのコンポーネントが解決されるか、どのロックファイルのピン留めが適用されるか、ドキュメントにどの検出結果が出るかです。そのため拡張機能は一度に 1 つの選択された Release に対して動作し、それがどれかをステータスバーのロケットアイコンの横に表示します。

選んだ Release は、そのエディターウィンドウに記憶されます。言語サーバーが接続すると、記憶された選択がワークスペースでまだ提供されているかが確認され、まだ存在すれば復元されます。存在しなくなっていれば、エディターはその旨を伝え、ワークスペースが示す選択にフォールバックします。このウィンドウで何も選んでいない場合も、選択はここから始まります。その答えは、優先順位の高い順に次から得られます:

  1. .aggrega-config.yaml の build.authoring_release。チーム全体が共有する、コミットされた設定です。
  2. .aggrega/active-release。コミットされないローカルのマーカーファイルです。
  3. ワークスペース内に Release がちょうど 1 つだけある場合の、その Release。

いずれかのインジケーターをクリックして、別の Release を選択します(またはコマンドパレットから Aggrega: Select Release… を実行します)。変更はただちに有効になります — 何も再起動せず、開いているすべての YAML ファイルが選んだばかりの Release に対して再チェックされ、Catalog パネルはその Release のためにリストを読み直します。言語サーバーの接続時に Release が採用された場合も同様です。記憶はエディターウィンドウに限られます。選択してもワークスペースには何も書き込まれません。チューザーが開いたときにフォーカスが Commands パネル — その Release 行、またはそのいずれかのコントロール — にあった場合、Release を選んだか閉じたかにかかわらず、チューザーが閉じるとフォーカスはそのコントロールに戻ります。それ以外の場所から開いた場合、チューザーはパネルにフォーカスを残しません。

ワークスペースの 4 つの Releases をパスで一覧表示している Release 選択画面。Release 行とステータスバーには、何も選択されていないと表示されています。

提供される Releases は、言語サーバーがアンカーとしたフォルダー内にあるもので、そのフォルダーからの相対名で示されます。サーバーが受け付けるのがその形式だからです。Release を提供できない場合、エディターはそれらを黙って除外するのではなく、その数と場所を示します。言語サーバーはそのフォルダーの外へ向かうリンクを通じて Release を読み込まないため、外へ向かうリンク — 外部のディレクトリへのリンク、または外部の Release ファイルへのリンク — を通じてエディターのファイルツリーに表示される Release は提供されません。唯一の例外は、ワークスペース設定が build.authoring_release として、または workspace.releases のキーとして指定する Release ファイルへのリンクです。その Release はリンクを通じて読み込まれ、提供されます。チューザーを開くと専用の通知でそのことが示され、言語サーバーが本来読み込む場所にあるそのような各リンクが、そのフォルダーからの相対パスで示されます。ディレクトリへのリンクが先、ファイルへのリンクが後です。名前が .yaml または .yml で終わるリンクは、その先のファイルが何を含んでいても示されます。それを調べるためにそのファイルを読み込むことはないからです。

ワークスペース自体に選択を記録したい場合 — 新しいチェックアウトがその選択から始まるように — それを行うコマンドが 2 つあり、どちらも現在作業中の内容は変更しません:

  • Aggrega: Set the selected Release as this workspace’s default は、現在選択されている Release を言語サーバーに .aggrega/active-release へ書き込ませます。このファイルはチェックアウトにローカルなので、個人のデフォルトを置くのに適した場所です。.aggrega またはマーカーが Aggrega ワークスペースの外へ向かうリンクである場合、何も書き込まれず、通知にはその理由がコンパイラ自身の言葉で示されます。
  • Aggrega: Set authoring_release in .aggrega-config.yaml… は設定ファイルを開き、build.authoring_release を設定できるようにします。この設定はコミットされて共有され、マーカーファイルより優先されます。設定ファイルが Aggrega ワークスペースの外へ向かうリンクであると言語サーバーが報告した場合、ファイルは開かれず、それがワークスペースの外へ向かうため Aggrega はそれを使用しないことをエラーが示します。ウェルカムページにあるワークスペース設定を作成するコントロールも、すでに存在するファイルを見つけた場合は同じように動作します。

ワークスペースが Release を何も提供しない場合 — 設定もマーカーもなく、フォールバック先となるファイルがちょうど 1 つあるわけでもない場合 — インジケーターはその旨を示し、2 つのうちどちらに該当するかを示します。選択できる Releases があるのにそのどれも選んでいない場合は Release: none selected(Release: 未選択)と表示され、Aggrega ワークスペースが Release をまったく提供しなかった場合は Release: none available(Release: 利用可能なものなし)と表示されます。後者は選択によって解消できる状態ではないため、そのツールチップは、空で返ってくるしかないリストに誘導するのではなく、そこから抜け出す方法 — 別の Aggrega ワークスペースで作業する、または Release を作成する — を示します。まだ何もワークスペースを読み込んでいない場合、ツールチップは誰も数えていない件数を報告するのではなく、その旨を示します。これらの表示にはいずれも何を探したかが含まれ、詳しい説明は Aggrega 出力チャネルに書き込まれます。この状態でも検証は実行されます。ドキュメントが単独で答えられる検出結果 — パースできるかどうか、それ自体の形が許容されるかどうか — が得られ、Release を必要とするチェックは Release を選択するまでスキップされます。