Pular para o conteúdo
AggregaAggrega
Selecionar língua: Português (Portugal)
Esta página foi traduzida automaticamente. Ler o original em inglês.

O servidor de linguagem

Estado do language server — um indicador na barra de estado, à esquerda, ao lado do indicador da Release, que apresenta running, starting, ou not running a vermelho. É a única superfície presente independentemente do que o compilador esteja a fazer, pelo que é aí que se descobre que nada está em execução em vez de ter de o deduzir a partir de superfícies que ficaram em silêncio — e a sua dica indica qual dos dois motivos se aplica: nenhuma pasta aqui é uma que o Aggrega reconheça, ou existe uma e o servidor não está ligado a ela. Clicar nele oferece Start quando nada está em execução e Restart quando algo está, e executa o que for escolhido. Consulte Quando o language server não está em execução.

Quando o servidor de linguagem não está em execução

Todos os comandos que esta extensão fornece existem desde o momento em que ela arranca, haja ou não um servidor de linguagem em execução, e só dois deles esperam por um servidor antes que o índice de comandos os liste: o indicado abaixo, e Aggrega: Attach a Feature to the connection at the cursor, que só é listado num documento que o servidor de linguagem identifica como um Aggregate ou uma Release. Um comando que só passasse a existir depois de um servidor se ligar faltaria no índice de comandos precisamente na janela que mais precisa dele — aquela em que nada está em execução e se procura a forma de o iniciar.

O indicador à esquerda na barra de estado é onde se descobre o que se passa. Mostra running, starting ou not running a vermelho, e a sua dica explica porquê: nenhuma pasta nesta janela é uma que o Aggrega reconheça, ou há uma e o servidor não está ligado a ela. Clicar nele oferece Start ou Restart — o que se aplicar — e executa-o.

A barra de estado a indicar a vermelho que o servidor de linguagem do Aggrega não está em execução, e o menu que o seu indicador abre, que oferece Start.

Esse indicador existe porque um comando que não pode ser executado não explica nada: o índice de comandos omite-o em vez de dizer porquê, e nenhuma superfície do editor mostra uma dica num controlo desativado. O indicador é onde o motivo fica escrito, e é também onde se age em conformidade.

Um arranque que falha indica o que está errado no caminho do compilador. Onde aggrega.server.binaryPath não aponta para nada, a notificação diz Aggrega language server failed to start: the compiler at ⟨path⟩ was not found. (Falha ao iniciar o servidor de linguagem do Aggrega: o compilador em ⟨path⟩ não foi encontrado.); onde aponta para um ficheiro que não pode ser executado, diz … ⟨path⟩ is not an executable file. (… ⟨path⟩ não é um ficheiro executável.) ⟨path⟩ é o ficheiro que a extensão tentou iniciar: uma definição que comece por ~/ ou ${userHome} é apresentada resolvida a partir da pasta pessoal do utilizador, tal como foi procurada. Ambas indicam depois que se defina aggrega.server.binaryPath como o binário aggrega, e trazem Open binary path setting, que abre o ecrã de definições nessa única definição, e Show output. Onde o caminho não aponta para nada, a notificação traz também Download the compiler e Choose another file antes desses dois, porque nesse caso não há compilador a substituir: o primeiro transfere um como descrito em Obter o compilador, e o segundo pede um ficheiro de compilador disponível e aponta a definição para ele. Um ficheiro que lá está e não pode ser executado foi lá colocado pelo utilizador, pelo que essa notificação não oferece nenhuma transferência. Qualquer outra falha de arranque apresenta o motivo que lhe foi dado, após a mesma abertura, e depois indica o compilador que foi executado e a definição que o designa. O canal de saída do Aggrega contém o mesmo relato.

Validate indica que o servidor não está em execução e oferece o caminho de regresso. Premido quando nenhum servidor de linguagem está em execução, responde Aggrega: the language server is not running. (Aggrega: o servidor de linguagem não está em execução.) — seguido, onde o último arranque falhou, do motivo, nas palavras com que essa falha foi comunicada — com Show output, Open binary path setting e o próprio Start do indicador da barra de estado.

Os painéis de lista indicam que o servidor não está em execução em vez de reportarem uma falha. Sem nenhum servidor de linguagem em execução, os painéis Registries e Catalog mostram cada um The Aggrega language server is not running. (O servidor de linguagem do Aggrega não está em execução.) no lugar da sua lista, com a própria dica do indicador, e premir a linha inicia o servidor. A lista do painel Plugins provém da execução do compilador como comando e não do servidor de linguagem, pelo que, onde esse comando não pôde ser iniciado, a sua linha indica o que está errado no caminho com as palavras da notificação, e premi-la abre a definição.

Aggrega: Open status bar menu fica fora do índice de comandos enquanto nenhum servidor de linguagem responde: tudo o que oferece é uma ação sobre um servidor de linguagem em execução, e o editor não lista um comando que não pode ser executado ali. Regressa no momento em que um servidor responde.

Um comando que funciona sem servidor permanece no índice de comandos, mesmo que diga respeito ao servidor. Aggrega: Toggle the artifact-rendering stage while inspecting escreve uma preferência, e o servidor lê essa preferência ao arrancar — pelo que um servidor parado é o momento mais útil para a definir, e não um motivo para a ocultar.

Ciclo de vida

A extensão gere todo o ciclo de vida do processo do servidor de linguagem. Quando para o servidor de linguagem — ao fechar o editor, quando o servidor de linguagem passa para outro espaço de trabalho do Aggrega, ou quando não resta um único espaço de trabalho a que o ligar — pede primeiro ao servidor de linguagem que termine de forma cooperativa, o que permite que o trabalho em curso termine. Se o servidor de linguagem ainda estiver a trabalhar quando esse período de tolerância terminar, é-lhe pedido mais uma vez — desta vez que abandone esse trabalho em vez de o terminar. Se mesmo assim não tiver terminado, a extensão recorre à terminação ao nível do sistema operativo. Um reinício — o comando de reinício, uma alteração de aggrega.server.binaryPath ou uma alteração de configuração feita pela própria extensão — não pede: termina o processo ao nível do sistema operativo e inicia um novo. Cada um destes passos é registado no canal de saída do Aggrega, de modo que um encerramento lento mostra que passo está a demorar e se o servidor de linguagem chegou a responder. A semântica é idêntica em anfitriões POSIX e Windows.

Um servidor de linguagem que para sem que tal lhe tenha sido pedido é iniciado de novo, um número limitado de vezes. Quando um servidor em execução termina, a extensão inicia um novo; se esse também terminar — ao arrancar, antes de ter respondido ao pedido inicial da extensão, ou já em execução — é por sua vez iniciado de novo, até aggrega.server.respawnAttempts reinícios em aggrega.server.respawnWindowSeconds segundos. O término após o último deles deixa o servidor parado e apresenta Aggrega language server has stopped responding. (O servidor de linguagem do Aggrega deixou de responder.), indicando o comando que o inicia de novo, e a partir daí nada o volta a iniciar por si só — assim, um servidor que morre sempre que arranca é iniciado de novo esse número de vezes e não mais. O canal de saída do Aggrega descreve cada passo por palavras: que o servidor parou inesperadamente e como terminou, cada reinício e quantos a definição permite, um reinício que não arrancou e porquê, e que não está a ser iniciado de novo. Uma paragem ou um reinício pedido pelo utilizador — o comando de reinício, uma alteração de aggrega.server.binaryPath ou uma alteração de configuração feita pela própria extensão — não é contado, e um reinício repõe a contagem a zero. O primeiro arranque, e um reinício pedido pelo utilizador, não são repetidos quando falham: cada um termina na notificação de que o servidor de linguagem não conseguiu arrancar, com o motivo.

Cada servidor de linguagem começa o painel Problems a partir do que ele próprio indica. Quando um servidor arranca — o primeiro, um reinício independentemente de como foi pedido, um iniciado de novo depois de o último ter parado inesperadamente, um movido para outro espaço de trabalho do Aggrega e um iniciado onde nenhum estava em execução — o painel Problems é esvaziado de tudo o que o servidor anterior indicou, e cada ficheiro YAML aberto é verificado com o novo assim que este responde. Um servidor não pode retirar o que indicou, e o que é iniciado depois dele não sabe o que era, pelo que uma constatação mantida seria uma que nenhum servidor em execução sustenta — depois de uma mudança, uma sobre o espaço de trabalho que se deixou. As constatações desaparecem e voltam enquanto os ficheiros abertos são verificados. Uma constatação que só outro pedido calcula fica de fora até esse pedido ser executado de novo: as constatações do build voltam quando o grafo é desenhado ou quando é executado um build ou um build de pré-visualização, o aviso de desvio de um lockfile quando o grafo é desenhado — ambos ao mesmo tempo onde estiver aberto um painel de grafo nessa Release, uma vez que é redesenhado quando o servidor regressa — e as constatações das convenções de publicação quando se executa Lint. Um servidor que para e não é substituído — esgotados os seus reinícios, ou sem nenhum espaço de trabalho do Aggrega a que se ligar — deixa o painel Problems como estava.

O servidor de linguagem lê a sua configuração quando arranca e mantém-na até parar. A linha de comandos volta a lê-la em cada execução, pelo que uma edição de .aggrega-config.yaml ou de ~/.config/aggrega/config.yaml altera de imediato o que um terminal faz e não altera nada num servidor de linguagem que já está em execução. Por isso a extensão observa os ficheiros de configuração que o servidor em execução indica ter lido — os caminhos de ficheiro que Show config lista entre os ficheiros que contribuíram — e, quando um deles muda no disco, é eliminado ou volta a existir, deixando assim de corresponder ao que o servidor leu, apresenta um aviso que indica o ficheiro e diz que o servidor de linguagem lê a sua configuração quando arranca, com um botão Restart server que executa Aggrega: Start or restart the language server. Várias escritas de uma mesma gravação apresentam um único aviso. O aviso não volta a ser apresentado para esse ficheiro enquanto estiver no ecrã, nem depois de ser dispensado até o ficheiro mudar de novo, e um reinício recomeça a observação a partir do que o servidor reiniciado leu. Um ficheiro de configuração que não existia quando o servidor arrancou não foi lido, pelo que não é observado e criá-lo não apresenta nada; o arranque seguinte lê-o. Os ficheiros observados são escritos no canal de saída do Aggrega sempre que um servidor arranca.

Uma alteração de configuração que a própria extensão faz é aplicada reiniciando o servidor de linguagem, sem perguntar. Adicionar ou remover um registo, inicializar um registo a partir da página de boas-vindas, adicionar ou remover um plugin, criar a configuração do espaço de trabalho a partir da página de boas-vindas e Aggrega: Set authoring_release in .aggrega-config.yaml… quando tem de criar o ficheiro são, cada um, seguidos de um reinício, mostrado enquanto decorre como uma notificação que indica o ficheiro que o servidor está prestes a ler, e nenhum deles apresenta o aviso: essa alteração foi pedida pelo utilizador. Onde a criação da configuração do espaço de trabalho inicia ela própria o servidor de linguagem — nenhum estava em execução, ou estava em execução para outra pasta — esse arranque lê o novo ficheiro, e não se segue um segundo reinício. Assim que um servidor de linguagem iniciado após a alteração a tiver lido, o próprio desfecho da operação acrescenta uma frase a dizer que a alteração está agora em vigor, em vez de uma segunda notificação; onde o reinício falhou, ou nenhum servidor de linguagem estava em execução para ler a alteração, a frase é omitida, porque a alteração está então no ficheiro e ainda não em vigor. Definir authoring_release termina com a abertura do ficheiro em vez de uma frase, pelo que não acrescenta nada.