Paramètres
La roue dentée en haut à droite du panneau Commands les ouvre — c’est la page de paramètres de l’éditeur lui-même, restreinte à cette extension, et c’est la seule surface de paramètres qui existe. Tout ce qui suit est aussi accessible depuis l’éditeur Settings habituel et depuis votre fichier de paramètres.

Chacun de ces paramètres vous appartient, pas au projet. Chacun décrit votre propre environnement ou vos propres habitudes de lecture — où se trouve votre binaire, combien de temps attendre avant de revalider, combien de relances tolérer, s’il faut afficher des valeurs lisibles par-dessus votre épaule, comment vous voulez qu’un panneau soit dessiné —, chacun est donc limité à vos paramètres utilisateur, et à vos paramètres distants lorsque vous travaillez sur un hôte distant ou conteneurisé. Ce dernier point compte en particulier pour le chemin du binaire : le compilateur s’exécute sur le même hôte que l’extension, le chemin peut donc différer entre votre ordinateur portable et un conteneur, et chaque hôte conserve sa propre valeur.
La conséquence est délibérée : un dépôt ne peut fixer aucun de ces paramètres pour quiconque l’ouvre. En écrire un dans un .vscode/settings.json de workspace n’a aucun effet — l’éditeur le marque comme non applicable à cet endroit et continue d’utiliser votre valeur. Si vous voulez qu’un choix soit enregistré dans le workspace lui-même, les deux commandes de Release décrites dans Sélectionner une Release sont celles qui le font, et elles écrivent .aggrega/active-release ou .aggrega-config.yaml plutôt qu’un paramètre de l’éditeur.
| Paramètre | Par défaut | Objectif |
|---|---|---|
aggrega.getStarted.show | true | Indique si la page d’accueil s’ouvre au démarrage. Trois surfaces modifient ce paramètre unique et restent synchronisées : la case à cocher au pied de la page elle-même, Aggrega: Stop opening the welcome page on startup et Aggrega: Get started. Le désactiver empêche la page de s’ouvrir sans la supprimer ; le réactiver avec Aggrega: Get started l’ouvre également. |
aggrega.server.binaryPath | aggrega | Chemin du binaire aggrega. Un nom simple est recherché dans PATH ; un chemin commençant par ~/ (~\ sous Windows) ou ${userHome} est lu depuis votre dossier personnel sur l’hôte où s’exécute l’extension ; tout autre chemin est utilisé tel qu’il est écrit. |
aggrega.server.debounceMs | 300 | Fenêtre d’anti-rebond pour la validation proactive à la modification. |
aggrega.server.respawnAttempts | 5 | Nombre de fois, dans la fenêtre ci-dessous, où le serveur de langage est redémarré après s’être arrêté sans qu’on le lui demande, avant que l’extension le laisse arrêté et déclenche la notification indiquant qu’il ne répond plus. Un serveur redémarré qui s’arrête avant d’avoir répondu compte de la même façon qu’un serveur qui s’arrête en cours d’exécution. Voir Cycle de vie. |
aggrega.server.respawnWindowSeconds | 180 | Fenêtre glissante, en secondes, sur laquelle ces redémarrages sont comptés. |
aggrega.server.restartGraceSeconds | 5 | Délai de grâce avant que l’extension redémarre automatiquement le serveur de langage après une modification de binaryPath. La barre d’état affiche un compte à rebours ; le menu d’actions rapides propose Restart now et Cancel restart. |
aggrega.server.buildOnInspect | false | Exécute l’étape de rendu des artefacts lors de l’inspection d’un graphe, de sorte que les avertissements que aggrega build émet pendant le rendu apparaissent aussi comme problèmes dans l’éditeur. N’ajoute aucune des vérifications sur lesquelles un build s’arrête. L’inspection coûte plus cher lorsqu’elle s’exécute ; rien n’est écrit sur le disque. |
aggrega.graph.showSensitiveValues | false | Affiche dans le graphe de topologie les valeurs qu’une Feature déclare sensibles, en affichant en clair un identifiant transmis par valeur ; tant que c’est activé, la requête du graphe les demande au serveur de langage. Laissé désactivé, le serveur de langage les retient du graphe qu’il envoie, et elles sont à nouveau supprimées avant que le graphe soit dessiné. |
aggrega.operations.layout | buttons | Manière dont le panneau Commands dessine ses groupes — buttons place chaque opération dans un flux unique de boutons qui passe à la ligne, sans rien dessiner entre un groupe et le suivant, sections fait de chaque groupe une section que vous ouvrez sous son propre titre. Mêmes groupes, mêmes opérations, même ordre dans les deux cas. |
aggrega.notifications.toastDebounceMode | time | Fréquence à laquelle l’avis indiquant qu’une Release n’a pas de lockfile est réaffiché pour un travail que vous n’avez pas demandé, comme un graphe ouvert redessiné après un enregistrement : time le réaffiche une fois que toastThrottleSeconds se sont écoulées depuis la fermeture du dernier, session l’affiche une fois jusqu’au redémarrage du serveur de langage. Un Build, une Preview ou un graphe que vous ouvrez et qui est refusé pour cause de lockfile manquant affiche toujours l’avis. |
aggrega.notifications.toastThrottleSeconds | 300 | Secondes après la fermeture de l’avis de lockfile manquant avant qu’il soit réaffiché pour un travail que vous n’avez pas demandé. Lu uniquement lorsque toastDebounceMode vaut time. |