Scegli la Release su cui lavori
Release selezionata — un indicatore nella barra di stato e una riga Release in cima al pannello Commands, ciascuno dei quali indica l’unica Release su cui l’editor sta lavorando. Tutto ciò che agisce su una Release — la validazione, il grafo della topologia, la build, la build di anteprima e il pull — agisce su quella. Un pannello del grafo già aperto mantiene la Release da cui è stato disegnato quando ne selezioni un’altra, e mostrare di nuovo il grafo disegna quella appena selezionata. Il grafo, la build, la build di anteprima e il pull leggono le directory di catalogo rispetto a cui quella Release viene compilata: le sue, dove la configurazione del tuo workspace ne indica alcune per essa in workspace.releases, e altrimenti quelle del workspace — le stesse che legge aggrega build --release in un terminale, così una sola finestra compila ogni Release di un workspace rispetto al proprio catalogo senza alcun flag da passare. Il pannello Catalog, un’ispezione, il controllo della riga Catalog, l’hover, il completamento, Go to Definition, Find References e Find Implementations rispondono anch’essi nei termini della Release selezionata: dove la configurazione del tuo workspace indica directory di catalogo per ciascuna Release, ognuno legge i documenti contenuti nel workspace tranne quelli in una directory letta solo da un’altra Release, e le directory di catalogo rispetto a cui la Release selezionata viene compilata — così un nome dichiarato da più varianti, una per Release, si risolve in quella della Release selezionata. Senza alcuna Release selezionata rispondono nei termini del workspace stesso. Vedi Selezionare una Release.
Selezione di una Release
La maggior parte di ciò che l’estensione fa è circoscritta a una Release: quali directory di catalogo vengono lette, quali componenti si risolvono, quali pin del lockfile si applicano e quali segnalazioni riceve un documento. Per questo l’estensione lavora su una Release selezionata alla volta, e ti mostra quale nella barra di stato, accanto a un’icona a forma di razzo.
Una Release che scegli viene ricordata da quella finestra dell’editor. Quando il language server si connette, una scelta ricordata viene confrontata con ciò che il workspace offre ancora e ripristinata se è ancora presente; se non c’è più, l’editor te lo dice e ripiega su ciò che il tuo workspace implica, che è da dove parte la selezione quando non hai scelto nulla in questa finestra. Quella risposta deriva da, in ordine di precedenza:
build.authoring_releasein.aggrega-config.yaml, l’impostazione sottoposta a commit condivisa da un intero team..aggrega/active-release, un file marcatore locale che non viene sottoposto a commit.- L’unica Release nel workspace, quando ce n’è esattamente una.
Fai clic su uno dei due indicatori per selezionare un’altra Release (oppure esegui Aggrega: Select Release… dalla Command Palette). La modifica ha effetto immediato — nulla si riavvia, ogni file YAML aperto viene ricontrollato rispetto alla Release appena scelta e il pannello Catalog rilegge il proprio elenco per essa; lo stesso avviene quando una Release viene adottata alla connessione del language server. Il ricordo è locale alla finestra dell’editor: la scelta non scrive nulla nel tuo workspace. Se il focus era sul pannello Commands quando si è aperto il selettore — sulla sua riga Release o su uno qualsiasi dei suoi controlli — torna a quel controllo alla chiusura del selettore, sia che tu abbia scelto una Release sia che l’abbia chiuso; aperto da qualsiasi altro punto, il selettore lascia il pannello senza il focus.

Le Releases offerte sono quelle all’interno della cartella a cui il language server si è ancorato, nominate in modo relativo a essa, perché è la forma che accetta. Dove una Release non può essere offerta, l’editor dice quante sono e dove si trovano invece di ometterle in silenzio. Il language server non legge alcuna Release attraverso un link che esce da quella cartella, quindi una Release che l’albero dei file del tuo editor mostra attraverso un link che ne esce — un link a una directory esterna, o a un file di Release esterno — non viene offerta. L’unica eccezione è un link a un file di Release che la configurazione del workspace nomina, come build.authoring_release o come chiave di workspace.releases: quella Release viene letta attraverso il suo link e offerta. All’apertura il selettore lo segnala con una notifica a sé, nominando con il percorso relativo a quella cartella ogni link di questo tipo che si trova dove il language server altrimenti leggerebbe: prima i link a directory, poi i link a file. Un link il cui nome termina in .yaml o .yml viene nominato qualunque cosa contenga il file a cui porta, perché quel file non viene letto per scoprirlo.
Quando vuoi che una scelta sia registrata nel workspace stesso — così che un checkout nuovo parta da essa — due comandi lo fanno, e nessuno dei due cambia ciò su cui stai lavorando in questo momento:
- Aggrega: Set the selected Release as this workspace’s default fa scrivere al language server la Release attualmente selezionata in
.aggrega/active-release. Quel file è locale al tuo checkout, quindi è il posto giusto per un default personale. Dove.aggregao il marcatore è un link che porta fuori dal workspace Aggrega, non viene scritto nulla, e la notifica riporta le parole del compilatore stesso sul perché. - Aggrega: Set authoring_release in .aggrega-config.yaml… apre il file di configurazione così puoi impostare
build.authoring_release. Quell’impostazione è sottoposta a commit e condivisa, e prevale sul file marcatore. Dove il language server segnala che il file di configurazione è un link che porta fuori dal workspace Aggrega, il file non viene aperto e un errore dice che porta fuori dal workspace, quindi Aggrega non lo usa; il controllo della pagina di benvenuto che crea una configurazione del workspace fa lo stesso con un file che trova già presente.
Se il workspace non offre alcuna Release — nessuna configurata, nessun marcatore e non esattamente un file su cui ripiegare — l’indicatore lo dice, e dice quale di due cose è vera. Mostra Release: none selected dove ci sono Releases tra cui scegliere e non sei su nessuna di esse, e Release: none available dove il workspace Aggrega non ne ha offerta nessuna. Il secondo non è uno stato a cui puoi rispondere scegliendo, quindi il suo tooltip nomina le vie per uscirne — lavorare in un altro workspace Aggrega, o creare una Release — invece di mandarti a un elenco che può solo tornare vuoto. Dove nulla ha ancora letto il workspace, il tooltip dice questo invece di riportare un conteggio che nessuno ha fatto. Ognuna di queste letture riporta ciò che è stato cercato, e il resoconto completo viene scritto nel canale di output Aggrega. La validazione continua a essere eseguita in quello stato: ottieni le segnalazioni a cui un documento risponde da solo — se viene analizzato e se la sua forma è ammissibile — e i controlli che richiedono una Release vengono saltati finché non ne selezioni una.