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
aggregae 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çãoaggrega.server.binaryPathindica: 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 noPATH. 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 blocoworkspace:— e sobe a partir da pasta aberta para o encontrar. Marcar a raiz com um blocoworkspace:é 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:
- o Visual Studio Marketplace, a partir do qual o Visual Studio Code instala;
- o Open VSX, para editores que instalam as suas extensões a partir do Open VSX.
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:
code --install-extension aggrega-ai.aggregaA 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.

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/binem Linux e macOS,%LOCALAPPDATA%\Programs\aggregaem Windows — onde o compilador é guardado comoaggrega, ouaggrega.exeem 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
SHA256SUMSda versão publicada, eliminando uma transferência que não corresponda e indicando-a, torna-o executável e executa-o uma vez comaggrega version -o json. Só um ficheiro que passe as três verificações é colocado no lugar, e só entãoaggrega.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.