Aller au contenu
AggregaAggrega
Selectionner la langue: Français
Cette page a été traduite automatiquement. Lire l’original en anglais.

Choisir la Release sur laquelle vous travaillez

Release sélectionnée — un indicateur dans la barre d’état et une ligne Release en haut du panneau Commands, chacun nommant l’unique Release sur laquelle travaille l’éditeur. Tout ce qui agit sur une Release — la validation, le graphe de topologie, la compilation, la compilation d’aperçu et la récupération — agit sur celle-là. Un panneau de graphe déjà ouvert conserve la Release à partir de laquelle il a été dessiné lorsque vous en sélectionnez une autre, et afficher de nouveau le graphe dessine celle nouvellement sélectionnée. Le graphe, la compilation, la compilation d’aperçu et la récupération lisent les répertoires de catalogue avec lesquels cette Release est compilée : les siens, là où la configuration de votre workspace en nomme pour elle sous workspace.releases, et sinon ceux du workspace — les mêmes que lit aggrega build --release dans un terminal, de sorte qu’une seule fenêtre compile chaque Release d’un workspace avec son propre catalogue sans flag à passer. Le panneau Catalog, une inspection, la vérification de la ligne Catalog, le survol, la complétion, Go to Definition, Find References et Find Implementations répondent eux aussi dans les termes de la Release sélectionnée : là où la configuration de votre workspace nomme des répertoires de catalogue pour chaque Release, chacun lit les documents que contient le workspace, sauf ceux d’un répertoire que seule une autre Release lit, ainsi que les répertoires de catalogue avec lesquels la Release sélectionnée est compilée — de sorte qu’un nom que plusieurs variantes déclarent, une par Release, se résout en celle de la Release sélectionnée. Sans Release sélectionnée, ils répondent dans les termes propres du workspace. Voir Sélectionner une Release.

Sélectionner une Release

La plupart de ce que fait l’extension est limitée à une Release : quels répertoires de catalogue sont lus, quels composants se résolvent, quels pins du lockfile s’appliquent et quels constats un document reçoit. L’extension travaille donc sur une seule Release sélectionnée à la fois, et vous indique laquelle dans la barre d’état, à côté d’une icône de fusée.

Une Release que vous choisissez est mémorisée par cette fenêtre de l’éditeur. Lorsque le serveur de langage se connecte, un choix mémorisé est comparé à ce que le workspace propose encore et restauré s’il y figure toujours ; s’il a disparu, l’éditeur vous le signale et se rabat sur ce qu’implique votre workspace, qui est aussi le point de départ de la sélection lorsque vous n’avez rien choisi dans cette fenêtre. Cette réponse provient, par ordre de priorité, de :

  1. build.authoring_release dans .aggrega-config.yaml, le paramètre commité que toute une équipe partage.
  2. .aggrega/active-release, un fichier marqueur local qui n’est pas commité.
  3. L’unique Release du workspace, lorsqu’il y en a exactement une.

Cliquez sur l’un ou l’autre indicateur pour sélectionner une autre Release (ou exécutez Aggrega: Select Release… depuis la Command Palette). Le changement prend effet immédiatement — rien ne redémarre, chaque fichier YAML ouvert est revérifié par rapport à la Release que vous venez de choisir, et le panneau Catalog relit sa liste pour elle ; il en va de même lorsqu’une Release est adoptée à la connexion du serveur de langage. La mémorisation est locale à la fenêtre de l’éditeur : choisir n’écrit rien dans votre workspace. Si le focus était sur le panneau Commands à l’ouverture du sélecteur — sur sa ligne Release ou sur l’un de ses contrôles —, il revient à ce contrôle à la fermeture du sélecteur, que vous ayez choisi une Release ou l’ayez fermé ; ouvert depuis n’importe quel autre endroit, le sélecteur laisse le panneau sans le focus.

Le sélecteur de Release listant les quatre Releases d’un espace de travail par leurs chemins, tandis que la ligne Release et la barre d’état indiquent qu’aucune n’est sélectionnée.

Les Releases proposées sont celles qui se trouvent dans le dossier auquel le serveur de langage s’est ancré, nommées relativement à celui-ci, car c’est la forme qu’il accepte. Lorsqu’une Release ne peut pas être proposée, l’éditeur indique combien il y en a et où elles se trouvent au lieu de les omettre silencieusement. Le serveur de langage ne lit aucune Release à travers un lien qui sort de ce dossier, de sorte qu’une Release que l’arborescence de fichiers de votre éditeur affiche à travers un lien qui en sort — un lien vers un répertoire extérieur, ou vers un fichier de Release extérieur — n’est pas proposée. La seule exception est un lien vers un fichier de Release que la configuration du workspace nomme, comme build.authoring_release ou comme clé de workspace.releases : cette Release est lue à travers son lien et proposée. À son ouverture, le sélecteur le signale dans une notification distincte, en nommant par son chemin relatif à ce dossier chaque lien de ce type situé là où le serveur de langage lirait autrement : d’abord les liens vers des répertoires, puis les liens vers des fichiers. Un lien dont le nom se termine par .yaml ou .yml est nommé quel que soit le contenu du fichier vers lequel il mène, car ce fichier n’est pas lu pour le savoir.

Lorsque vous voulez qu’un choix soit enregistré dans le workspace lui-même — pour qu’un checkout neuf démarre dessus —, deux commandes le font, et aucune ne change ce sur quoi vous travaillez en ce moment :

  • Aggrega: Set the selected Release as this workspace’s default fait écrire par le serveur de langage la Release actuellement sélectionnée dans .aggrega/active-release. Ce fichier est local à votre checkout, c’est donc le bon endroit pour une valeur par défaut personnelle. Lorsque .aggrega ou le marqueur est un lien qui sort du workspace Aggrega, rien n’est écrit, et la notification reprend les propres mots du compilateur pour en donner la raison.
  • Aggrega: Set authoring_release in .aggrega-config.yaml… ouvre le fichier de configuration pour que vous puissiez définir build.authoring_release. Ce paramètre est commité et partagé, et il prime sur le fichier marqueur. Lorsque le serveur de langage signale que le fichier de configuration est un lien qui sort du workspace Aggrega, le fichier n’est pas ouvert, et une erreur indique qu’il sort du workspace, de sorte qu’Aggrega ne l’utilise pas ; le contrôle de la page d’accueil qui crée une configuration de workspace fait de même avec un fichier qu’il trouve déjà présent.

Si le workspace ne propose aucune Release — aucune configurée, aucun marqueur et pas exactement un fichier sur lequel se rabattre —, l’indicateur le signale, et il indique laquelle de deux situations est vraie. Il affiche Release: none selected lorsqu’il existe des Releases parmi lesquelles choisir et que vous n’êtes sur aucune, et Release: none available lorsque le workspace Aggrega n’en a proposé aucune. La seconde n’est pas un état auquel vous pouvez répondre en choisissant, aussi son infobulle nomme-t-elle les moyens d’en sortir — travailler dans un autre workspace Aggrega, ou créer une Release — au lieu de vous envoyer vers une liste qui ne peut que revenir vide. Lorsque rien n’a encore lu le workspace, l’infobulle le dit au lieu de rapporter un décompte que personne n’a fait. Chacune de ces indications précise ce qui a été recherché, et le compte rendu complet est écrit dans le canal de sortie Aggrega. La validation s’exécute toujours dans cet état : vous obtenez les constats auxquels un document répond à lui seul — s’il s’analyse et si sa propre forme est admissible — et les vérifications qui nécessitent une Release sont ignorées jusqu’à ce que vous en sélectionniez une.