Salta ai contenuti
AggregaAggrega
Seleziona lingua: Italiano
Questa pagina è stata tradotta automaticamente. Leggi l’originale in inglese.

La pagina di benvenuto

Pagina di benvenuto — la pagina di Aggrega in una propria scheda dell’editor, che dice che cos’è Aggrega e poi elenca ciò di cui l’estensione ha bisogno in questo workspace, contrassegnando ogni condizione come Met o To do. Ogni passaggio offre un modo per creare l’elemento e un modo per indicarne uno che hai già, spiega la condizione, e un passaggio già soddisfatto non ti chiede nulla. Un passaggio contrassegnato Met torna a To do se la sua condizione viene meno. Un passaggio già soddisfatto si apre richiuso, così la pagina si apre sul lavoro che resta. Ogni passaggio mostra anche il suo stato attuale — la radice del workspace, il compilatore, la Release, i registry — reso più grande e più marcato delle indicazioni, introdotto da Selected:, sotto il titolo quando il passaggio è richiuso e subito sopra i pulsanti quando è aperto, e lo dice a parole dove non hai ancora scelto — None selected. dove c’è qualcosa da scegliere, None available. dove non c’è proprio nulla tra cui scegliere. In fondo riporta la casella di controllo che decide se si apre all’avvio, lo stesso interruttore presente nella schermata delle impostazioni, sotto di essa le versioni dell’estensione e del compilatore che stai eseguendo, e infine se il language server è in esecuzione e quale versione riporta. Un’icona a forma di casa nella barra del titolo del pannello Commands la riapre in qualsiasi momento. Non occupa spazio nella vista Aggrega.

Welcome to Aggrega! si apre in una propria scheda dell’editor. Spiega che cos’è Aggrega, poi elenca ciò di cui l’estensione ha bisogno nel workspace che hai aperto:

  1. Un workspace che Aggrega riconosce — l’individuazione descritta in Prerequisiti.
  2. Un compilatore che questo editor può eseguire — il binario aggrega indicato in aggrega.server.binaryPath.
  3. Una Release su cui agire — la build, l’anteprima e il grafo della topologia agiscono ciascuno su una Release.
  4. Un registry da cui risolvere — il pull delle dipendenze e la ricerca nel catalogo pubblicato risolvono rispetto ai registry indicati dalla tua configurazione.

Ogni passaggio spiega a cosa serve la condizione e come l’editor la raggiunge, così la pagina è un luogo in cui leggere del prodotto anziché soltanto una checklist.

La scheda Welcome to Aggrega! in una cartella che Aggrega non riconosce ancora, con il suo primo passaggio, Un workspace che Aggrega riconosce, contrassegnato come da fare e aperto sulla sua spiegazione.

Ogni passaggio offre più di una strada, e una di esse è sempre «ce l’ho già». Puoi creare una configurazione del workspace o indicare all’editor una cartella che ne contiene già una; usare il compilatore nel tuo PATH, selezionare una build che hai altrove, o scaricarne una; abbozzare una Release o sceglierne una delle tue; inizializzare l’hub ufficiale, indicare il tuo registry, o aggiungerne uno a una configurazione che hai già. Niente qui è un vicolo cieco che ti consegna una finestra di selezione file e lascia il passaggio ancora da fare.

Un passaggio già soddisfatto viene spuntato e non ti chiede nulla. La pagina legge ciò che è vero anziché porre a tutti le stesse domande, quindi se hai creato la tua configurazione dalla riga di comando e poi hai aperto l’editor, ogni passaggio arriva già spuntato.

Ogni passaggio si richiude, e la pagina si apre mostrando ciò che serve ancora. Una freccetta in alto a destra di ogni passaggio lo apre e lo chiude. Un passaggio la cui condizione è già soddisfatta si apre richiuso, e uno che non lo è si apre con la sua spiegazione davanti a te — così la lettura riguarda il lavoro che ti resta anziché quello che hai fatto. Un passaggio richiuso mantiene il suo titolo e ognuno dei suoi pulsanti, e nasconde solo la spiegazione: una volta che sai a cosa serve un passaggio, puoi comunque agire su di esso senza rileggerlo.

La disposizione viene decisa quando la pagina viene creata e da quel momento è tua. Un passaggio che diventa soddisfatto mentre lo stai leggendo aggiorna il suo segno e resta aperto — non si richiude sotto il tuo cursore — e una freccetta che premi resta dove l’hai messa, per quante volte la pagina si aggiorni intorno a essa. Chiudere e riaprire la pagina rilegge le condizioni e la ridispone da capo. Lo stesso fa la pagina disegnata al posto di una che avevi aperta quando il tuo editor riavvia le sue estensioni — come avviene quando si aggiunge una cartella a una finestra aperta su una sola cartella: la pagina che avevi viene chiusa e ne viene disegnata una nuova nello stesso gruppo di schede, che la pagina sia impostata per aprirsi all’avvio o no, così la finestra continua a contenere una sola pagina e quella pagina segue il workspace in cui ti trovi.

Ogni passaggio mostra anche il suo stato attuale, così la pagina risponde a quale e non solo a se: la radice del workspace, il compilatore, la Release e i registry che la configurazione dichiara. Il valore è reso più grande e più marcato della spiegazione intorno, perché un valore disegnato con lo stesso peso di un muro di testo è un valore che devi andare a cercare. Un passaggio richiuso lo mostra sotto il titolo, così puoi confermare la tua selezione senza aprire nulla; uno aperto lo mostra in fondo alla spiegazione, subito sopra i pulsanti, dove è l’ultima cosa che leggi prima di agire. Un valore scelto è introdotto da Selected:, reso più piccolo e più leggero del valore stesso, così l’etichetta indica il valore anziché competere con esso.

La pagina di benvenuto in un workspace configurato, con i passaggi del compilatore, della Release e del registry contrassegnati come soddisfatti e richiusi, ciascuno con il valore selezionato sopra i pulsanti, e in fondo la casella di avvio, le versioni e lo stato del language server.

Dove non hai ancora scelto, il passaggio lo dice a parole anziché lasciare una riga vuota, che sembrerebbe un errore di disegno della pagina — e distingue due stati su cui chi legge agisce in modo diverso. None selected. significa che c’è qualcosa da scegliere e non hai scelto nulla. None available. significa che qui non c’è proprio nulla tra cui scegliere, quindi premere «ne ho già uno» del passaggio potrebbe mostrarti solo un elenco vuoto, e ciò che ti serve è la sua altra strada. Solo i due passaggi che offrono un elenco possono indicare None available. — il workspace e la Release. Un compilatore viene indicato per nome e un registry viene registrato direttamente, quindi nessuno di questi due passaggi ha un elenco che potrebbe essere vuoto. Il passaggio dei registry ha una terza indicazione, Not read yet., per quando non è stato possibile interrogare il compilatore: dirti che non ne hai configurato nessuno quando nulla ha potuto rispondere direbbe più di quanto la pagina sappia.

Il segno di un passaggio segue la sua condizione in entrambe le direzioni. Ogni passaggio riporta il suo stato a parole accanto al segno — Met o To do — perché il segno in sé è un glifo, e un glifo da solo lascia indovinare il proprio significato. Un passaggio indica Met quando la sua condizione diventa vera e di nuovo To do se la condizione in seguito viene meno — un compilatore che smette di rispondere, una Release che viene deselezionata. La pagina legge ciò che è vero a ogni aggiornamento anziché ricordare ciò che era vero un tempo, quindi non segnala mai qualcosa che nel frattempo hai perso. Dove il venir meno conta, viene segnalato anche dove stai già guardando: la barra di stato riporta un compilatore che ha smesso di rispondere, e le righe Project folder, Aggrega workspace e Release in cima al pannello Commands indicano la selezione corrente.

È una normale scheda dell’editor anziché una finestra di dialogo, di proposito: ogni passaggio ti chiede di indicare qualcosa nel tuo workspace, e una finestra di dialogo coprirebbe i file che contengono le risposte. Si trova nell’area dell’editor anziché nella vista Aggrega, così non occupa spazio nella barra laterale e può dire che cos’è il prodotto — cosa per cui una colonna stretta non ha spazio. È la scheda di Aggrega, che si raggiunge e si chiude alle sue condizioni, e non offre alcun percorso verso la pagina di benvenuto dell’editor.

La pagina riporta quella decisione in fondo, centrata, e la riporta anche la Command Palette. Entrambe modificano l’unica impostazione, aggrega.getStarted.show, scritta nelle tue impostazioni personali — mai nel repository, così la tua scelta non arriva a chiunque altro lo apra. Il controllo in fondo è una casella di controllo con l’etichetta Show Aggrega welcome page on startup, spuntata finché la pagina si apre all’avvio — così riporta l’impostazione com’è anziché offrirti l’azione che la cambierebbe. Disattivala nella schermata delle impostazioni e la casella la segue; premi la casella e la schermata delle impostazioni la segue. È un unico interruttore in due posti anziché due interruttori. La casella mantiene il focus della tastiera quando viene premuta, così Spazio la spunta e la toglie alternativamente.

Disattivarla impedisce alla pagina di aprirsi all’avvio anziché renderla irraggiungibile, e non è una porta a senso unico: Aggrega: Get started nella Command Palette la riattiva e la apre, e Aggrega: Stop opening the welcome page on startup è il modo che la palette stessa offre per raggiungere la stessa impostazione.

Il pannello Commands offre un modo per tornare alla pagina, accanto all’ingranaggio. È l’icona a forma di casa in alto a destra, e il suo tooltip dice Open the welcome page — così tornare alla pagina è qualcosa che trovi guardando la vista Aggrega anziché qualcosa che devi sapere di dover digitare. Apre la pagina e lascia l’impostazione di avvio esattamente dove l’hai messa: guardare di nuovo la pagina non la riattiva. È il comando della palette a farlo, perché riattivarla è una decisione e non un’occhiata.

La pagina riporta, in fondo, ciò che stai eseguendo. Lì si trovano due indicazioni di versione: Extension, quale build di questa estensione ha caricato il tuo editor, e Compiler, ciò che il binario aggrega eseguito dal language server dice di sé. L’indicazione Extension viene registrata quando l’estensione viene compilata, dallo stato del suo sorgente in quel momento, nella stessa forma che la build del compilatore usa per la propria versione — così una finestra di sviluppo, una copia installata e una copia impacchettata da un albero modificato dicono ciascuna quale sono:

  • un tag di release da solo, come 0.2.0, significa che la build è esattamente quella release;
  • un tag seguito da un conteggio e da un commit, come 0.2.0-3-g1a2b3c4, indica una build dal commit 1a2b3c4, tre commit dopo quella release — e un commit da solo, come 1a2b3c4, indica una build da quel commit quando nessuna release lo precede;
  • un suffisso -dirty su uno qualsiasi di questi significa che la build è stata creata da una copia del sorgente con modifiche non ancora committate;
  • dev significa che la build è stata creata dove non è stato possibile leggere la cronologia del sorgente.

Nessuna delle due indicazioni è scritta nella pagina — entrambe vengono lette quando la pagina viene disegnata, così una build di sviluppo si presenta come tale anziché non mostrare nulla, e riavviare su un compilatore diverso cambia l’indicazione. Dove non è possibile rilevare un’indicazione — l’estensione è stata compilata senza registrare quale build sia, non c’è nulla in esecuzione da interrogare, o ciò che è in esecuzione non ha risposto — l’etichetta resta e dice che la versione non è stata riportata, così un’indicazione assente non viene mai scambiata per una che non hai notato.

L’ultima riga della pagina dice se il language server è in esecuzione, e quale build è. Riporta Language server running, starting, not running o failed to start, con le stesse parole usate dalla barra di stato e dalle notifiche; failed to start significa che il tentativo più recente di avviarlo è fallito e da allora non ne è stato eseguito nessuno. Il canale di output Aggrega dice perché, e lo dice anche la notifica emessa quando il primo avvio o un riavvio fallisce. Mentre il server è in esecuzione, la riga aggiunge la versione che il server in esecuzione ha riportato di sé quando l’estensione vi si è connessa, scritta come l’indicazione Compiler scrive una versione. L’indicazione Compiler sopra di essa è un fatto diverso: è ciò che dice, se interrogato, il binario da cui il server è stato avviato, e le due differiscono quando il file in quel percorso viene sostituito mentre il server avviato da esso continua a girare, per questo la pagina le mostra entrambe. Un language server che non riporta una propria versione indica lì version not reported, anziché prendere in prestito quella del binario. La riga e le due indicazioni sopra di essa seguono il server mentre si avvia, si arresta, si riavvia o fallisce, senza che la pagina venga riaperta; i passaggi mantengono i loro segni durante un riavvio.