La page d’accueil
Page d’accueil — la page propre d’Aggrega dans son propre onglet d’éditeur, qui explique ce qu’est Aggrega puis liste ce dont l’extension a besoin dans ce workspace, en marquant chaque condition Met ou To do. Chaque étape propose un moyen de créer l’élément et un moyen de désigner celui que vous avez déjà, explique la condition, et une étape déjà remplie ne vous demande rien. Une étape marquée Met repasse à To do si sa condition cesse d’être remplie. Une étape déjà remplie s’ouvre repliée, de sorte que la page s’ouvre sur le travail qui reste. Chaque étape montre aussi où elle en est — la racine du workspace, le compilateur, la Release, les registries — affiché plus grand et plus gras que les explications, introduit par Selected:, sous le titre lorsque l’étape est repliée et juste au-dessus des boutons lorsqu’elle est ouverte, et le disant en toutes lettres là où vous n’avez pas encore choisi — None selected. là où il y a quelque chose à choisir, None available. là où il n’y a rien du tout parmi quoi choisir. Son bas porte la case à cocher qui décide si elle s’ouvre au démarrage, le même interrupteur que celui de l’écran des paramètres, en dessous les versions de l’extension et du compilateur que vous exécutez, et enfin si le language server s’exécute et quelle version il signale. Une icône en forme de maison dans la barre de titre du panneau Commands la rouvre à tout moment. Elle ne coûte aucune place à la vue Aggrega.
Welcome to Aggrega! s’ouvre dans son propre onglet d’éditeur. Elle explique ce qu’est Aggrega, puis liste ce dont l’extension a besoin dans le workspace que vous avez ouvert :
- Un workspace qu’Aggrega reconnaît — la détection décrite sous Prérequis.
- Un compilateur que cet éditeur peut exécuter — le binaire
aggreganommé dansaggrega.server.binaryPath. - Une Release sur laquelle agir — la compilation, l’aperçu et le graphe de topologie agissent chacun sur une Release.
- Un registry depuis lequel résoudre — la récupération des dépendances et la recherche dans le catalogue publié se résolvent auprès des registries que nomme votre configuration.
Chaque étape explique à quoi sert la condition et comment l’éditeur la remplit, de sorte que la page est un endroit où lire sur le produit plutôt qu’une simple liste de contrôle.

Chaque étape offre plus d’un chemin, et l’un d’eux est toujours « Je l’ai déjà ». Vous pouvez créer une configuration de workspace ou indiquer à l’éditeur un dossier qui en contient déjà une ; utiliser le compilateur de votre PATH, sélectionner un build que vous avez ailleurs, ou en télécharger un ; rédiger une Release ou choisir l’une des vôtres ; initialiser le hub officiel, nommer votre propre registry, ou en ajouter un à une configuration que vous avez déjà. Rien ici n’est une impasse qui vous tend une boîte de dialogue de fichiers et laisse l’étape encore à faire.
Une étape déjà remplie est cochée et ne vous demande rien. La page lit ce qui est vrai plutôt que de poser les mêmes questions à tout le monde ; si vous avez construit votre configuration en ligne de commande puis ouvert l’éditeur, chaque étape arrive donc déjà cochée.
Chaque étape se replie, et la page s’ouvre en montrant ce qui manque encore. Un chevron en haut à droite de chaque étape l’ouvre et la ferme. Une étape dont la condition est déjà remplie s’ouvre repliée, et une qui ne l’est pas s’ouvre avec son explication devant vous — ainsi la lecture porte sur le travail qu’il vous reste plutôt que sur celui que vous avez fait. Une étape repliée conserve son titre et chacun de ses boutons, et ne masque que l’explication : une fois que vous savez à quoi sert une étape, vous pouvez toujours agir dessus sans la relire.
La disposition est décidée à la création de la page et vous appartient ensuite. Une étape qui devient remplie pendant que vous la lisez met à jour sa marque et reste ouverte — elle ne se replie pas sous votre curseur — et un chevron sur lequel vous appuyez reste là où vous l’avez mis, quel que soit le nombre de fois où la page se rafraîchit autour de lui. Fermer et rouvrir la page relit les conditions et la réorganise de zéro. Il en va de même pour la page dessinée à la place de celle que vous aviez ouverte lorsque votre éditeur redémarre ses extensions — comme il le fait quand un dossier est ajouté à une fenêtre ouverte sur un seul dossier : la page que vous aviez est fermée et une nouvelle est dessinée dans le même groupe d’onglets, que la page soit configurée pour s’ouvrir au démarrage ou non, de sorte que la fenêtre continue de contenir une seule page et que cette page suit le workspace dans lequel vous vous trouvez.
Chaque étape montre aussi où elle en est, de sorte que la page répond à lequel et pas seulement à si : la racine du workspace, le compilateur, la Release et les registries que déclare la configuration. La valeur est affichée plus grande et plus grasse que l’explication qui l’entoure, car une valeur dessinée dans la même graisse qu’un mur de texte est une valeur qu’il faut chercher. Une étape repliée l’affiche sous le titre, pour que vous puissiez confirmer votre sélection sans rien déplier ; une étape ouverte l’affiche au bas de l’explication, juste au-dessus des boutons, où c’est la dernière chose lue avant d’agir. Une valeur choisie est introduite par Selected:, affiché plus petit et plus léger que la valeur elle-même, pour que le libellé désigne la valeur plutôt que de rivaliser avec elle.

Là où vous n’avez pas encore choisi, l’étape le dit en toutes lettres plutôt que de laisser une ligne vide, qui donnerait l’impression que la page n’a pas réussi à s’afficher — et elle distingue deux états sur lesquels un lecteur agit différemment. None selected. signifie qu’il y a quelque chose à choisir et que vous n’avez rien choisi. None available. signifie qu’il n’y a ici rien du tout parmi quoi choisir ; appuyer sur « J’en ai déjà un » de l’étape ne pourrait donc vous montrer qu’une liste vide, et ce qu’il vous faut, c’est son autre chemin. Seules les deux étapes qui proposent une liste peuvent afficher None available. — le workspace et la Release. Un compilateur est nommé et un registry est enregistré directement ; aucune de ces deux étapes n’a donc de liste qui pourrait être vide. L’étape des registries conserve un troisième affichage, Not read yet., pour le cas où le compilateur n’a pas pu être interrogé : vous dire que vous n’en avez configuré aucun alors que rien n’a pu répondre en dirait plus que ce que la page sait.
La marque d’une étape suit sa condition dans les deux sens. Chaque étape indique son état en toutes lettres à côté de la marque — Met ou To do — car la marque elle-même est un glyphe, et un glyphe seul laisse son sens à deviner. Une étape affiche Met lorsque sa condition devient vraie et de nouveau To do si la condition cesse plus tard de l’être — un compilateur qui ne répond plus, une Release désélectionnée. La page lit ce qui est vrai à chaque rafraîchissement plutôt que de se souvenir de ce qui l’a été, de sorte qu’elle ne signale jamais quelque chose que vous avez perdu depuis. Là où une perte compte, elle est aussi signalée là où vous regardez déjà : la barre d’état indique un compilateur qui ne répond plus, et les lignes Project folder, Aggrega workspace et Release en haut du panneau Commands nomment la sélection actuelle.
C’est volontairement un onglet d’éditeur ordinaire plutôt qu’une boîte de dialogue : chaque étape vous demande de désigner quelque chose dans votre propre workspace, et une boîte de dialogue couvrirait les fichiers qui contiennent les réponses. Elle se trouve dans la zone d’édition plutôt que dans la vue Aggrega, de sorte qu’elle ne coûte aucune place à la barre latérale et peut dire ce qu’est le produit — ce pour quoi une colonne étroite n’a pas de place. C’est l’onglet propre d’Aggrega, que l’on atteint et ferme selon ses propres règles, et il n’offre aucun chemin vers la page d’accueil de l’éditeur.
La page porte cette décision en bas, centrée, et la Command Palette la porte aussi. Les deux modifient l’unique paramètre aggrega.getStarted.show, écrit dans vos propres paramètres — jamais dans le dépôt, de sorte que votre choix ne suit pas quiconque l’ouvre. Le contrôle du bas est une case à cocher libellée Show Aggrega welcome page on startup, cochée tant que la page s’ouvre au démarrage — elle rend donc compte du paramètre tel qu’il est plutôt que de vous proposer l’action qui le changerait. Désactivez-le dans l’écran des paramètres et la case suit ; appuyez sur la case et l’écran des paramètres suit. C’est un seul interrupteur à deux endroits plutôt que deux interrupteurs. La case conserve le focus clavier quand on appuie dessus, de sorte que la touche Espace la coche et la décoche tour à tour.
Le désactiver empêche la page de s’ouvrir au démarrage sans la rendre inaccessible, et ce n’est pas un aller simple : Aggrega: Get started dans la Command Palette le réactive et ouvre la page, et Aggrega: Stop opening the welcome page on startup est le propre chemin de la palette vers le même paramètre.
Le panneau Commands offre un chemin de retour vers la page, à côté de l’engrenage. C’est l’icône en forme de maison en haut à droite, et son infobulle indique Open the welcome page — ainsi, revenir à la page est quelque chose que l’on trouve en regardant la vue Aggrega plutôt que quelque chose qu’il faut savoir taper. Elle ouvre la page et laisse votre paramètre de démarrage exactement là où vous l’avez mis : regarder de nouveau la page ne le réactive pas. C’est la commande de la palette qui le fait, car le réactiver est une décision plutôt qu’un coup d’œil.
La page indique en bas ce que vous exécutez. Deux indications de version y figurent : Extension, le build de cette extension que votre éditeur a chargé, et Compiler, ce que le binaire aggrega exécuté par le language server dit de lui-même. L’indication Extension est enregistrée lors de la compilation de l’extension, à partir de l’état de ses sources à ce moment-là, sous la même forme que celle qu’utilise le build du compilateur pour sa version — ainsi une fenêtre de développement, une copie installée et une copie empaquetée à partir d’une arborescence modifiée disent chacune laquelle elles sont :
- un tag de release seul, comme
0.2.0, signifie que le build est exactement cette release ; - un tag suivi d’un nombre et d’un commit, comme
0.2.0-3-g1a2b3c4, désigne un build du commit1a2b3c4, trois commits après cette release — et un commit seul, comme1a2b3c4, désigne un build de ce commit lorsqu’aucune release ne le précède ; - un suffixe
-dirtysur l’un de ces éléments signifie que le build a été réalisé à partir d’une copie des sources contenant des modifications non commitées ; devsignifie que le build a été réalisé là où l’historique des sources ne pouvait pas être lu.
Aucune des deux indications n’est écrite dans la page — les deux sont lues lorsque la page est dessinée, de sorte qu’un build de développement se signale comme tel plutôt que de ne rien afficher, et redémarrer sur un autre compilateur change l’indication. Là où une indication ne peut pas être relevée — l’extension a été compilée sans enregistrer de quel build il s’agit, rien ne s’exécute qu’on puisse interroger, ou ce qui s’exécute n’a pas répondu — le libellé reste et indique que la version n’a pas été signalée, de sorte qu’une indication absente n’est jamais confondue avec une que vous n’auriez pas remarquée.
La dernière ligne de la page indique si le language server est en cours d’exécution, et de quel build il s’agit. Elle affiche Language server running, starting, not running ou failed to start, avec les mots qu’utilisent la barre d’état et les notifications ; failed to start signifie que la dernière tentative de démarrage a échoué et qu’aucun ne s’est exécuté depuis. Le canal de sortie Aggrega en donne la raison, tout comme la notification émise lorsque le premier démarrage ou un redémarrage échoue. Tant que le serveur s’exécute, la ligne ajoute la version que le serveur en cours d’exécution a signalée à son sujet lorsque l’extension s’y est connectée, écrite de la même façon que l’indication Compiler écrit une version. L’indication Compiler au-dessus est un fait différent : c’est ce que dit, lorsqu’on l’interroge, le binaire à partir duquel le serveur a été démarré, et les deux diffèrent lorsque le fichier à ce chemin est remplacé alors que le serveur démarré à partir de lui continue de s’exécuter ; c’est pourquoi la page affiche les deux. Un language server qui ne signale aucune version propre y affiche version not reported, plutôt que d’emprunter celle du binaire. La ligne et les deux indications au-dessus suivent le serveur lorsqu’il démarre, s’arrête, redémarre ou échoue, sans que la page soit rouverte ; les étapes conservent leurs marques lors d’un redémarrage.