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

Il language server

Stato del language server — un indicatore nella barra di stato, a sinistra, accanto all’indicatore della Release, che riporta running, starting, o not running in rosso. È l’unica superficie presente qualunque cosa stia facendo il compilatore, quindi è lì che scopri che non c’è nulla in esecuzione anziché doverlo dedurre da superfici diventate silenziose — e il suo tooltip dice quale dei due motivi si applica: nessuna cartella qui è una che Aggrega riconosce, oppure ce n’è una e il server non vi è collegato. Facendo clic su di esso viene offerto Start quando non c’è nulla in esecuzione e Restart quando c’è qualcosa, e viene eseguito quello che scegli. Vedi Quando il language server non è in esecuzione.

Quando il language server non è in esecuzione

Ogni comando che questa estensione fornisce esiste dal momento in cui si avvia, che un language server sia in esecuzione o no, e solo due di essi attendono un server prima che l’indice dei comandi li elenchi: quello nominato più sotto, e Aggrega: Attach a Feature to the connection at the cursor, che viene elencato solo in un documento che il language server segnala come un Aggregate o una Release. Un comando che nascesse solo dopo che un server si è collegato mancherebbe dall’indice dei comandi esattamente nella finestra che ne ha più bisogno — quella in cui non è in esecuzione nulla e stai cercando il modo di avviarlo.

L’indicatore a sinistra nella barra di stato è dove scopri cosa sta succedendo. Mostra running, starting o not running in rosso, e il suo tooltip dice perché: nessuna cartella in questa finestra è una che Aggrega riconosce, oppure ce n’è una e il server non è collegato a essa. Facendo clic offre Start o Restart — quello che si applica — e lo esegue.

La barra di stato che segnala in rosso che il language server di Aggrega non è in esecuzione, e il menu aperto dal suo indicatore che offre Start.

Quell’indicatore esiste perché un comando che non può essere eseguito non spiega nulla: l’indice dei comandi lo omette invece di dire perché, e nessuna superficie dell’editor mostra un tooltip su un controllo disabilitato. L’indicatore è dove viene scritto il motivo, ed è anche dove agisci di conseguenza.

Un avvio che fallisce dice cosa non va nel percorso del compilatore. Dove aggrega.server.binaryPath non nomina nulla, la notifica mostra Aggrega language server failed to start: the compiler at ⟨path⟩ was not found. (Avvio del language server di Aggrega non riuscito: il compilatore in ⟨path⟩ non è stato trovato.); dove nomina un file che non può essere eseguito, mostra … ⟨path⟩ is not an executable file. (… ⟨path⟩ non è un file eseguibile.) ⟨path⟩ è il file che l’estensione ha tentato di avviare: un’impostazione che inizia con ~/ o ${userHome} viene mostrata risolta a partire dalla tua cartella home, così come è stata cercata. Entrambe proseguono dicendo di impostare aggrega.server.binaryPath sul binario aggrega, e portano Open binary path setting, che apre la schermata delle impostazioni su quella sola impostazione, e Show output. Dove il percorso non nomina nulla, la notifica porta anche Download the compiler e Choose another file prima di quei due, perché in quel caso non c’è alcun compilatore da sostituire: il primo ne scarica uno come descritto in Ottenere il compilatore, e il secondo chiede un file di compilatore che hai e vi punta l’impostazione. Un file che c’è e non può essere eseguito è uno che hai messo tu, quindi quella notifica non offre alcun download. Qualsiasi altro fallimento dell’avvio fornisce il motivo che gli è stato dato, dopo la stessa apertura, e poi nomina il compilatore che è stato eseguito e l’impostazione che lo nomina. Il canale di output Aggrega riporta lo stesso resoconto.

Validate dice che il server non è in esecuzione e offre la via per tornare. Premuto mentre nessun language server è in esecuzione, risponde Aggrega: the language server is not running. (Aggrega: il language server non è in esecuzione.) — seguito, dove l’ultimo avvio è fallito, dal motivo, nelle parole con cui quel fallimento è stato segnalato — con Show output, Open binary path setting e lo Start dell’indicatore della barra di stato.

I pannelli elenco dicono che il server non è in esecuzione invece di segnalare un fallimento. Senza alcun language server in esecuzione, i pannelli Registries e Catalog mostrano ciascuno The Aggrega language server is not running. (Il language server di Aggrega non è in esecuzione.) al posto del loro elenco, con lo stesso tooltip dell’indicatore, e premere la riga avvia il server. L’elenco del pannello Plugins deriva dall’esecuzione del compilatore come comando anziché dal language server, quindi dove non è stato possibile avviare quel comando la sua riga dice cosa non va nel percorso con le parole della notifica, e premerla apre l’impostazione.

Aggrega: Open status bar menu viene omesso dall’indice dei comandi mentre nessun language server risponde: tutto ciò che offre è un’azione su un language server in esecuzione, e il tuo editor non elenca un comando che lì non può essere eseguito. Ricompare nel momento in cui uno risponde.

Un comando che funziona senza server resta nell’indice dei comandi, anche se riguarda il server. Aggrega: Toggle the artifact-rendering stage while inspecting scrive una preferenza, e il server legge quella preferenza all’avvio — quindi un server fermo è il momento più utile per impostarla, non un motivo per nasconderla.

Ciclo di vita

L’estensione gestisce l’intero ciclo di vita del processo del language server. Quando arresta il language server — alla chiusura dell’editor, quando il language server passa a un altro workspace Aggrega, o quando non resta un singolo workspace a cui collegarlo — chiede prima al language server di terminare in modo cooperativo, il che consente al lavoro in corso di concludersi. Se il language server sta ancora lavorando quando quella finestra di tolleranza si chiude, gli viene chiesto ancora una volta — questa volta di abbandonare quel lavoro anziché concluderlo. Se non è ancora terminato, l’estensione ricorre alla terminazione a livello di sistema operativo. Un riavvio — il comando di riavvio, una modifica di aggrega.server.binaryPath o una modifica di configurazione fatta dall’estensione stessa — non chiede: termina il processo a livello di sistema operativo e ne avvia uno nuovo. Ciascuno di questi passaggi è riportato nel canale di output di Aggrega, così un arresto lento mostra quale passaggio sta richiedendo tempo e se il language server ha risposto. La semantica è identica su host POSIX e Windows.

Un language server che si arresta senza che gli sia stato chiesto viene riavviato, un numero limitato di volte. Quando un server in esecuzione termina, l’estensione ne avvia uno nuovo; se termina anche quello — all’avvio, prima di aver risposto alla richiesta iniziale dell’estensione, o una volta in esecuzione — viene a sua volta riavviato, fino a aggrega.server.respawnAttempts riavvii entro aggrega.server.respawnWindowSeconds secondi. La terminazione successiva all’ultimo di questi lascia il server arrestato e solleva Aggrega language server has stopped responding. (Il language server di Aggrega ha smesso di rispondere.), nominando il comando che lo riavvia, e da quel momento nulla lo riavvia da solo — così un server che muore ogni volta che si avvia viene riavviato quel numero di volte e non di più. Il canale di output di Aggrega descrive ogni passaggio a parole: che il server si è arrestato inaspettatamente e come è terminato, ogni riavvio e quanti ne consente l’impostazione, un riavvio che non è partito e perché, e che non viene più riavviato. Un arresto o un riavvio che hai chiesto tu — il comando di riavvio, una modifica di aggrega.server.binaryPath o una modifica di configurazione fatta dall’estensione stessa — non viene conteggiato, e un riavvio fa ripartire il conteggio da zero. Il primo avvio, e un riavvio che hai chiesto tu, non vengono ripetuti quando falliscono: ciascuno termina con la notifica che il language server non è riuscito ad avviarsi, con il motivo.

Ogni language server avvia il pannello Problems da ciò che riporta esso stesso. All’avvio di un server — il primo, un riavvio comunque sia stato richiesto, uno riavviato dopo che l’ultimo si è arrestato inaspettatamente, uno spostato su un altro workspace Aggrega e uno avviato dove nessuno era in esecuzione — il pannello Problems viene svuotato di tutto ciò che il server precedente aveva riportato, e ogni file YAML aperto viene verificato con il nuovo non appena risponde. Un server non può ritirare ciò che ha riportato, e quello avviato dopo di esso non sa che cosa fosse, quindi un risultato lasciato in piedi sarebbe uno di cui nessun server in esecuzione si fa garante — dopo uno spostamento, uno relativo al workspace che hai lasciato. I risultati scompaiono e ricompaiono mentre i file aperti vengono verificati. Un risultato che solo un’altra richiesta calcola resta assente finché quella richiesta non viene eseguita di nuovo: i risultati della build tornano quando il grafo viene disegnato o quando viene eseguita una build o una build di anteprima, l’avviso di deriva di un lockfile quando il grafo viene disegnato — entrambi insieme dove è aperto un pannello del grafo su quella Release, poiché viene ridisegnato quando il server torna — e i risultati delle convenzioni di pubblicazione quando esegui Lint. Un server che si arresta e non viene sostituito — esauriti i suoi riavvii, o senza più un workspace Aggrega a cui collegarsi — lascia il pannello Problems com’era.

Il language server legge la configurazione quando si avvia, e la mantiene finché non si arresta. La riga di comando la rilegge a ogni esecuzione, quindi una modifica a .aggrega-config.yaml o a ~/.config/aggrega/config.yaml cambia subito ciò che fa un terminale e non cambia nulla in un language server già in esecuzione. Per questo l’estensione osserva i file di configurazione che il server in esecuzione riporta di aver letto — i percorsi di file che Show config elenca tra i file che hanno contribuito — e quando uno di essi cambia su disco, viene eliminato o ricompare, e quindi non corrisponde più a ciò che il server ha letto, solleva un avviso che nomina il file e dice che il language server legge la configurazione quando si avvia, con un pulsante Restart server che esegue Aggrega: Start or restart the language server. Più scritture di un unico salvataggio sollevano un solo avviso. L’avviso non viene sollevato di nuovo per quel file mentre è a schermo, né dopo che lo hai chiuso finché il file non cambia di nuovo, e un riavvio fa ripartire l’osservazione da ciò che ha letto il server riavviato. Un file di configurazione che non esisteva quando il server si è avviato non è stato letto, quindi non viene osservato e crearlo non solleva nulla; l’avvio successivo lo legge. Quali file vengono osservati è scritto nel canale di output di Aggrega ogni volta che un server si avvia.

Una modifica di configurazione fatta dall’estensione stessa viene applicata riavviando il language server, senza chiedere. Aggiungere o rimuovere un registry, inizializzare un registry dalla pagina di benvenuto, aggiungere o rimuovere un plugin, creare la configurazione del workspace dalla pagina di benvenuto e Aggrega: Set authoring_release in .aggrega-config.yaml… quando deve creare il file sono ciascuno seguiti da un riavvio, mostrato mentre è in corso come una notifica che nomina il file che il server sta per leggere, e nessuno di essi solleva l’avviso: quella modifica l’hai chiesta tu. Dove la creazione della configurazione del workspace avvia essa stessa il language server — non ne era in esecuzione nessuno, o era in esecuzione per un’altra cartella — quell’avvio legge il nuovo file, e non segue un secondo riavvio. Una volta che un language server avviato dopo la modifica l’ha letta, la conclusione dell’operazione stessa aggiunge una frase che dice che la modifica è ora in vigore, anziché una seconda notifica; dove il riavvio è fallito, o nessun language server era in esecuzione per leggere la modifica, la frase viene omessa, perché la modifica è allora nel file e non ancora in vigore. Impostare authoring_release termina aprendo il file anziché con una frase, quindi non aggiunge nulla.