拡張機能のセットアップ
前提条件
- デスクトップ版の Visual Studio Code 1.85 以降。この拡張機能は
aggregaプログラムを起動して動作し、代わりにブラウザーで実行できるバージョンを提供していないため、vscode.dev や github.dev のように完全に Web ブラウザー内で動作するエディターでは実行できません。 - ワークスペースがあるマシン上の
aggregaコンパイラ。拡張機能はaggrega.server.binaryPath設定が指定するコンパイラを実行します。~/(Windows では~\)または${userHome}で始まるパスはそのマシン上のホームフォルダーを起点に読み取られ、それ以外のパスは記述どおりに使われ、単なる名前(デフォルトはaggrega)はPATH上で検索されます。見つからない場合、拡張機能はダウンロードを提案し、後から Aggrega: Select Compiler Version でバージョンを変更できます。コンパイラの入手を参照してください。 - 開いたフォルダー、またはその上位にある、Aggrega がワークスペースルートとして認識するフォルダー。Aggrega はプロジェクトルートにある 1 つのファイル(
workspace:ブロックを持つ.aggrega-config.yaml)を読み込み、開いたフォルダーから上位へたどってそれを探します。workspace:ブロックでルートを示すのが明示的な方法であり、推奨される方法です。ブロックを一度も宣言していないプロジェクトも他のマーカーで認識されることがあり、それらについては、大規模なプロジェクトで設定ができるその他すべてのことと併せて、Aggrega 自体の設定リファレンスで説明しています。
これらを手作業で整える必要はありません。ウェルカムページを参照してください。
拡張機能のインストール
拡張機能の識別子は aggrega-ai.aggrega で、次の 2 か所に掲載されています。
- Visual Studio Marketplace:Visual Studio Code のインストール元です。
- Open VSX:拡張機能を Open VSX からインストールするエディター向けです。
エディターで拡張機能ビューを開き、Aggrega を検索して、識別子が aggrega-ai.aggrega のエントリをインストールします。
ターミナルからは、識別子を Visual Studio Code のコマンドラインプログラムに渡します。
code --install-extension aggrega-ai.aggrega拡張機能は、自身のテキスト(コマンド、設定、ビュー、メッセージ)を、Visual Studio Code が実行されている表示言語に翻訳されている場合はその言語で、それ以外の場合は英語で表示します。Configure Display Language で変更した表示言語は、エディタを再起動すると反映されます。コンパイラが報告する内容は、その診断やインポートの質問を含め、ターミナルと同様にコンパイラの言葉のまま表示されます。
コンパイラの入手
拡張機能は aggrega.server.binaryPath が指定するコンパイラを実行し、入手を提案する前にまずコンパイラを探します。 設定内のパスのうち ~/(Windows では ~\)または ${userHome} で始まるものは、ワークスペースがあるマシン上のホームフォルダーを起点に読み取られます。そのため Linux と macOS では、~/.local/bin/aggrega はインストールスクリプトがそこに置くファイルを指します。それ以外のパスは記述どおりに使われます。単なる名前(デフォルトは aggrega)は PATH 上で検索され、Aggrega の出力チャネルに、見つかったファイルとそのファイルが報告するバージョンが表示されます。

見つからない場合はダウンロードを提案します。 提案は、ウェルカムページのコンパイラのステップ(Download the compiler が Use the compiler on my PATH と Point at a compiler I have の横に並んでいます)と、パスに何もないため言語サーバーを起動できなかったことを知らせる通知から行われます。ダウンロードでは次のことが行われます。
- この拡張機能が対応する最新の公開リリースを提示します。 これはワークスペースがあるマシンのオペレーティングシステムとプロセッサ向けにビルドされたもので、リモートマシン、コンテナー、WSL で開いたウィンドウではそのマシンが対象です。Releases には、64 ビット x86 と 64 ビット ARM 上の Linux と macOS、および 64 ビット x86 上の Windows 向けのバイナリが含まれます。それ以外のマシンではダウンロードは拒否され、そのマシンが示されます。
- Aggrega のインストールスクリプトが使うフォルダーを提案します。 Linux と macOS では
~/.local/bin、Windows では%LOCALAPPDATA%\Programs\aggregaで、コンパイラはそこにaggrega(Windows ではaggrega.exe)として保存されます。フォルダーは変更でき、バージョンは質問のタイトルに表示されます。 - 何かをダウンロードする前にバージョンとファイルの確認を求め、その後、停止可能な進行状況を表示します。
- ファイルをリリースの
SHA256SUMSと照合し、一致しないダウンロードは削除してその旨を示し、ファイルを実行可能にして、aggrega version -o jsonで一度実行します。3 つすべてに合格したファイルだけが配置され、そのときに初めて、ユーザー自身の設定でaggrega.server.binaryPathがそのファイルに設定されます。
ダウンロードは、エディターが拡張機能に使うプロキシ(エディターの http.proxy と http.proxyStrictSSL 設定で構成されたもの)を経由します。リリース一覧やファイルを読み取れない場合(オフラインである、GitHub がアドレスからのリクエストを制限している、またはリクエストが拒否された場合)、何もダウンロードされず、設定はそのまま残り、理由が一文で示されます。
置き換える権限のあるコンパイラだけを置き換えます。 対象は、その共有フォルダーにあるコンパイラか、拡張機能自身がダウンロードしたコンパイラです。後者は設定ではなく、そのマシン上の拡張機能独自のストレージに記録されます。他の場所に置いたコンパイラを上書きしてダウンロードするよう求められた場合は、そうしたコンパイラは決して置き換えないことを伝え、代わりに共有フォルダーを提案します。
自動でアップグレードすることはありません。 置き換えてよいコンパイラについては、ウィンドウが開いたときにリリース一覧を読み取り、新しいリリースが利用可能であることをバージョンごとに一度だけ知らせます。自分で指定したコンパイラについては何も尋ねません。
Aggrega: Select Compiler Version は実行するバージョンを変更し、再び変更するまでそのバージョンを維持します。 この拡張機能が対応するリリースを新しい順に一覧表示し、使用中のものに印を付けます。何かをダウンロードする前に、このコンパイラはこのマシン上のすべてのワークスペースが使うものなのでバージョンはそのすべてで変わること、そして別のバージョンがロックファイルを書いた Release では Pull の再実行が必要になる場合があることを警告します。Download and switch で確認します。新しいバージョンは現在のバージョンの横にダウンロードされ、他のダウンロードと同様に照合され、その上で言語サーバーが起動されます。そのうえで初めて以前のバージョンを置き換えます。言語サーバーが起動しない場合は新しいバージョンが削除され、以前のバージョンが残り、言語サーバーは再びそのバージョンで起動されます。Aggrega ワークスペースを開いていないウィンドウでは起動する言語サーバーがないため、バージョンチェックがその代わりとなり、メッセージにもそう表示されます。コンパイラを置き換えるのはダウンロードで置き換えてよい場所だけで、自分でどこかに置いたコンパイラについてはその旨を伝え、代わりに共有フォルダーを提案します。