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

Configurar a extensão

Pré-requisitos

  • Visual Studio Code 1.85 ou mais recente, no ambiente de trabalho. A extensão funciona iniciando o programa aggrega e não disponibiliza nenhuma versão que um navegador possa executar em seu lugar, pelo que não funciona em editores que correm inteiramente num navegador web, como vscode.dev e github.dev.
  • O compilador aggrega, na máquina onde se encontra o workspace. A extensão executa aquele que a definição aggrega.server.binaryPath indica: um caminho que começa por ~/ (~\ no Windows) ou por ${userHome} é lido a partir da pasta pessoal nessa máquina, qualquer outro caminho é usado tal como está escrito, e um nome simples — o predefinido, aggrega — é procurado no PATH. Se não encontrar nenhum, a extensão oferece-se para transferir um, e Aggrega: Select Compiler Version altera a versão mais tarde; consulte Obter o compilador.
  • Uma pasta que o Aggrega reconhece como raiz de um workspace, na pasta que se abre ou acima dela. O Aggrega lê um único ficheiro na raiz do projeto — .aggrega-config.yaml, que contém um bloco workspace: — e sobe a partir da pasta aberta para o encontrar. Marcar a raiz com um bloco workspace: é a escolha explícita e a preferível; um projeto que nunca declarou um pode ainda assim ser reconhecido por outros marcadores, que a referência de configuração do Aggrega descreve juntamente com tudo o resto que a configuração permite fazer num projeto maior.

Nada disto tem de ser preparado à mão: consulte A página de boas-vindas.

Instalação da extensão

O identificador da extensão é aggrega-ai.aggrega, e está publicada em dois locais:

No editor, abra a vista Extensões, pesquise Aggrega e instale a entrada cujo identificador é aggrega-ai.aggrega.

Num terminal, passe o identificador ao programa de linha de comandos do Visual Studio Code:

Terminal window
code --install-extension aggrega-ai.aggrega

A extensão mostra o seu próprio texto — os seus comandos, definições, vistas e mensagens — no idioma de apresentação em que o Visual Studio Code é executado, quando está traduzido para esse idioma, e em inglês caso contrário; um idioma de apresentação alterado com Configure Display Language chega-lhe assim que o editor reinicia. O que o compilador comunica, incluindo os seus diagnósticos e as perguntas de uma importação, chega tal como o compilador o formula, como num terminal.

Obter o compilador

A extensão executa o compilador que aggrega.server.binaryPath indica, e procura um antes de se oferecer para obter um. Um caminho na definição que começa por ~/ — ~\ no Windows — ou por ${userHome} é lido a partir da pasta pessoal na máquina onde se encontra o workspace, pelo que, no Linux e no macOS, ~/.local/bin/aggrega designa o ficheiro que os scripts de instalação lá colocam; qualquer outro caminho é usado tal como está escrito. Um nome simples — o predefinido é aggrega — é procurado no PATH, e o canal de saída do Aggrega indica que ficheiro foi encontrado e a versão que este reporta.

O passo do compilador da página de boas-vindas, marcado como por fazer, que oferece Use the compiler on my PATH, Point at a compiler I have e Download the compiler.

Se não encontrar nenhum, oferece-se para transferir um — a partir do passo do compilador da página de boas-vindas, onde Download the compiler se encontra ao lado de Use the compiler on my PATH e Point at a compiler I have, e a partir da notificação de que o language server não conseguiu arrancar porque não existe nada no caminho. A transferência:

  • propõe a versão publicada mais recente com que esta extensão funciona, compilada para o sistema operativo e o processador da máquina onde se encontra o workspace — numa janela aberta numa máquina remota, num contentor ou no WSL, essa máquina. As Releases incluem binários para Linux e macOS em x86 de 64 bits e ARM de 64 bits, e para Windows em x86 de 64 bits; em qualquer outra máquina, a transferência é recusada, indicando-a;
  • propõe a pasta que os scripts de instalação do Aggrega utilizam — ~/.local/bin em Linux e macOS, %LOCALAPPDATA%\Programs\aggrega em Windows — onde o compilador é guardado como aggrega, ou aggrega.exe em Windows, e permite alterá-la; a versão consta do título da pergunta;
  • pede confirmação da versão e do ficheiro antes de transferir o que quer que seja, e depois mostra um progresso que é possível interromper;
  • verifica o ficheiro com o SHA256SUMS da versão publicada, eliminando uma transferência que não corresponda e indicando-a, torna-o executável e executa-o uma vez com aggrega version -o json. Só um ficheiro que passe as três verificações é colocado no lugar, e só então aggrega.server.binaryPath é definido para ele, nas definições pessoais do utilizador.

As transferências passam pelo proxy que o editor utiliza para as extensões, tal como as suas definições http.proxy e http.proxyStrictSSL o configuram. Se a lista de versões ou um ficheiro não puder ser lido — está offline, o GitHub está a limitar os pedidos a partir do seu endereço, ou o pedido é recusado — nada é transferido, a definição fica como está, e uma frase explica o motivo.

Só substitui um compilador que tem o direito de substituir: um nessa pasta partilhada, ou um que ela própria transferiu, do qual se lembra nessa máquina no seu próprio armazenamento em vez de numa definição. Se lhe for pedido que transfira por cima de um compilador colocado noutro local, indica que nunca substitui um desses e propõe, em vez disso, a pasta partilhada.

Nunca se atualiza por iniciativa própria. Para um compilador que pode substituir, lê a lista de versões quando se abre uma janela e indica, uma vez por cada versão, que existe uma versão mais recente disponível; não pergunta nada sobre um compilador para o qual o próprio utilizador a apontou.

Aggrega: Select Compiler Version altera a versão em execução, e mantém-na até ser alterada de novo. Lista as versões com que esta extensão funciona, da mais recente para a mais antiga, assinalando a que está em uso. Antes de transferir o que quer que seja, avisa que o compilador é aquele que todos os workspaces desta máquina utilizam, pelo que a versão muda para todos, e que uma Release cujo lockfile foi escrito por outra versão pode precisar que Pull seja executado de novo; a confirmação faz-se com Download and switch. A nova versão é transferida para junto da atual e verificada como qualquer transferência, o language server é iniciado com ela, e só então substitui a anterior. Se não iniciar o language server, é eliminada, a anterior mantém-se, e o language server é novamente iniciado com esta. Numa janela sem nenhum workspace do Aggrega aberto não existe language server para iniciar, pelo que a verificação da versão o substitui e a mensagem indica-o. Só substitui um compilador onde uma transferência o pode fazer; para um que o utilizador colocou algures, indica-o e propõe, em vez disso, a pasta partilhada.