Configurer l’extension
Prérequis
- Visual Studio Code 1.85 ou une version plus récente, sur le bureau. L’extension fonctionne en lançant le programme
aggregaet ne fournit aucune version qu’un navigateur pourrait exécuter à sa place ; elle ne fonctionne donc pas dans les éditeurs qui s’exécutent entièrement dans un navigateur web, comme vscode.dev et github.dev. - Le compilateur
aggrega, sur la machine où se trouve votre workspace. L’extension exécute celui que nomme le paramètreaggrega.server.binaryPath: un chemin commençant par~/(~\sous Windows) ou par${userHome}est lu à partir de votre dossier personnel sur cette machine, tout autre chemin est utilisé tel qu’il est écrit, et un nom simple — la valeur par défaut,aggrega— est recherché dans lePATH. Si elle n’en trouve aucun, l’extension propose d’en télécharger un pour vous, et Aggrega: Select Compiler Version en change ensuite la version ; voir Obtenir le compilateur. - Un dossier qu’Aggrega reconnaît comme racine d’un workspace, au niveau du dossier que vous ouvrez ou au-dessus. Aggrega lit un seul fichier à la racine de votre projet —
.aggrega-config.yaml, qui contient un blocworkspace:— et remonte depuis le dossier ouvert pour le trouver. Marquer la racine avec un blocworkspace:est le choix explicite et celui à privilégier ; un projet qui n’en a jamais déclaré peut tout de même être reconnu par d’autres marqueurs, que la référence de configuration d’Aggrega décrit avec tout ce que la configuration permet de faire dans un projet plus grand.
Vous n’avez rien de tout cela à préparer à la main : voir La page d’accueil.
Installation de l’extension
L’identifiant de l’extension est aggrega-ai.aggrega, et elle est référencée à deux endroits :
- le Visual Studio Marketplace, depuis lequel Visual Studio Code installe ;
- Open VSX, pour les éditeurs qui installent leurs extensions depuis Open VSX.
Dans l’éditeur, ouvrez la vue Extensions, recherchez Aggrega et installez l’entrée dont l’identifiant est aggrega-ai.aggrega.
Depuis un terminal, passez l’identifiant au programme en ligne de commande de Visual Studio Code :
code --install-extension aggrega-ai.aggregaL’extension affiche son propre texte — ses commandes, ses paramètres, ses vues et ses messages — dans la langue d’affichage de Visual Studio Code, lorsqu’il est traduit dans cette langue, et en anglais sinon ; une langue d’affichage que vous changez avec Configure Display Language lui parvient une fois l’éditeur redémarré. Ce que le compilateur signale, y compris ses diagnostics et les questions d’un import, vous parvient tel que le compilateur le formule, comme dans un terminal.
Obtenir le compilateur
L’extension exécute le compilateur que nomme aggrega.server.binaryPath, et en cherche un avant de proposer d’en obtenir un. Un chemin du paramètre commençant par ~/ — ~\ sous Windows — ou par ${userHome} est lu à partir de votre dossier personnel sur la machine où se trouve votre workspace, de sorte que sous Linux et macOS ~/.local/bin/aggrega désigne le fichier que les scripts d’installation y placent ; tout autre chemin est utilisé tel qu’il est écrit. Un nom simple — la valeur par défaut est aggrega — est recherché dans votre PATH, et le canal de sortie Aggrega indique quel fichier a été trouvé et la version qu’il signale.

Si elle n’en trouve aucun, elle propose d’en télécharger un — depuis l’étape du compilateur de la page d’accueil, où Download the compiler se trouve à côté de Use the compiler on my PATH et de Point at a compiler I have, et depuis la notification indiquant que le language server n’a pas pu démarrer parce qu’il n’y a rien à ce chemin. Le téléchargement :
- propose la release publiée la plus récente avec laquelle cette extension fonctionne, compilée pour le système d’exploitation et le processeur de la machine où se trouve votre workspace — dans une fenêtre ouverte sur une machine distante, un conteneur ou WSL, cette machine-là. Les Releases contiennent des binaires pour Linux et macOS sur x86 64 bits et ARM 64 bits, et pour Windows sur x86 64 bits ; sur toute autre machine, le téléchargement est refusé, en la nommant ;
- propose le dossier qu’utilisent les scripts d’installation d’Aggrega —
~/.local/binsous Linux et macOS,%LOCALAPPDATA%\Programs\aggregasous Windows — où le compilateur est enregistré sous le nomaggrega, ouaggrega.exesous Windows, et vous permet de le changer ; la version figure dans le titre de la question ; - vous demande de confirmer la version et le fichier avant que quoi que ce soit ne soit téléchargé, puis affiche une progression que vous pouvez interrompre ;
- vérifie le fichier par rapport au
SHA256SUMSde la release, en supprimant un téléchargement qui ne correspond pas et en le signalant, le rend exécutable et l’exécute une fois avecaggrega version -o json. Seul un fichier qui réussit ces trois contrôles est mis en place, et ce n’est qu’alors queaggrega.server.binaryPathest défini sur lui, dans vos propres paramètres.
Les téléchargements passent par le proxy que votre éditeur utilise pour les extensions, tel que le configurent ses paramètres http.proxy et http.proxyStrictSSL. Si la liste des releases ou un fichier ne peut pas être lu — vous êtes hors ligne, GitHub limite les requêtes depuis votre adresse, ou la requête est refusée — rien n’est téléchargé, le paramètre reste tel quel, et une phrase en donne la raison.
Elle ne remplace qu’un compilateur qu’elle est en droit de remplacer : un compilateur dans ce dossier partagé, ou un qu’elle a téléchargé elle-même, dont elle se souvient sur cette machine dans son propre stockage plutôt que dans un paramètre. Si on lui demande de télécharger par-dessus un compilateur que vous avez placé ailleurs, elle indique qu’elle n’en remplace jamais un et propose plutôt le dossier partagé.
Elle ne met jamais à jour d’elle-même. Pour un compilateur qu’elle peut remplacer, elle lit la liste des releases à l’ouverture d’une fenêtre et signale, une fois par version, qu’une release plus récente est disponible ; elle ne demande rien au sujet d’un compilateur que vous lui avez indiqué vous-même.
Aggrega: Select Compiler Version change la version que vous exécutez, et la conserve jusqu’à ce que vous la changiez à nouveau. La commande liste les releases avec lesquelles cette extension fonctionne, de la plus récente à la plus ancienne, en marquant celle qui est utilisée. Avant que quoi que ce soit ne soit téléchargé, elle avertit que le compilateur est celui qu’utilise chaque workspace de cette machine, de sorte que la version change pour tous, et qu’une Release dont le lockfile a été écrit par une autre version peut nécessiter de relancer Pull ; vous confirmez avec Download and switch. La nouvelle version est téléchargée à côté de la version actuelle et vérifiée comme n’importe quel téléchargement, le language server est démarré dessus, et ce n’est qu’alors qu’elle remplace la précédente. Si elle ne démarre pas le language server, elle est supprimée, la précédente reste, et le language server est de nouveau démarré sur celle-ci. Dans une fenêtre sans workspace Aggrega ouvert, il n’y a pas de language server à démarrer ; la vérification de version en tient donc lieu, et le message le dit. Elle ne remplace un compilateur que là où un téléchargement le peut ; pour un compilateur que vous avez placé vous-même quelque part, elle le dit et propose plutôt le dossier partagé.