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

A vista do Aggrega

O grafo de topologia abre-se num painel próprio, descrito em O grafo de topologia, e os comandos que os botões do painel Commands executam são descritos em Comandos.

Vista do Aggrega na barra de atividade — quatro painéis por ordem de leitura: Commands, Registries, Catalog e Plugins. Os outros três listam o que a configuração e o espaço de trabalho contêm, e cada um começa com as operações que atuam sobre o que lista, como linhas com rótulo no topo da respetiva lista; qualquer outra operação é um botão com rótulo no painel Commands, pelo que cada operação tem um único sítio onde a procurar. Uma operação que atua sobre um registo, uma entidade ou um plugin específico encontra-se na linha correspondente.

O painel Commands começa com três linhas simples que indicam aquilo sobre que o editor está a atuar — Project folder, depois Aggrega workspace, depois Release —, cada uma das quais abre o seu próprio seletor. A linha do meio mostra o seu nome abreviado, como Agg. worksp., para que o valor de cada linha disponha de mais largura do painel; a sua descrição ao passar o ponteiro dá-o por extenso, como Aggrega workspace, tal como todas as mensagens que lhe dizem respeito. Os seus valores ficam numa única coluna, a seguir ao mais largo dos três rótulos; num painel demasiado estreito para esse rótulo, este é cortado com reticências em vez de alargar o painel lateralmente, e a descrição da linha continua a indicar qual é. Estão por esta ordem porque cada uma está dentro da que está acima, e a disposição é a forma de o mostrar em vez de o explicar. A linha do meio mantém o nome do produto, abreviado ou não, porque «espaço de trabalho» por si só já designa o conjunto de pastas abertas na janela. A linha Aggrega workspace indica a pasta à qual o servidor de linguagem se ancorou, que é aquela em relação à qual a lista de Release é calculada; passar o ponteiro sobre ela mostra o caminho completo e, quando difere da pasta aberta, indica também essa — assim é possível perceber porque é que as Releases oferecidas são as que são. Quando a janela tem exatamente uma pasta aberta, a descrição da linha Project folder diz que é a única, em vez de deixar abrir uma lista com um único elemento, e termina com o que clicar na linha oferece aí — abrir uma pasta ou adicionar uma à janela —, e quando nenhuma Release está selecionada e nada leu ainda o que este espaço de trabalho do Aggrega oferece, a descrição di-lo em vez de tentar adivinhar. Quando um nível não contém nada, a descrição indica a forma de sair desse estado em vez de pedir uma escolha: nada selecionado e nada para selecionar leem-se de forma diferente, porque só o primeiro é uma decisão à espera do utilizador. A um projeto que não contém nenhum espaço de trabalho do Aggrega responde-se abrindo uma pasta que contenha um ou criando um; a um espaço de trabalho do Aggrega que não contém nenhuma Release, trabalhando noutro ou redigindo uma Release.

O painel Commands, encabeçado pelas linhas Project folder, Agg. worksp. e Release, com as operações por baixo como um único fluxo de botões com rótulo.

As linhas Aggrega workspace e Release têm cada uma um + à direita, ao lado da linha e não sobre ela: premir a linha escolhe entre os que existem, e premir o + abre o caminho para criar um novo. O + de Release abre o mesmo fluxo de redação que Draft entity no topo do painel Catalog, com o tipo já definido: pede o nome e nada mais, e o pedido indica que está a dar nome a uma Release. A linha Project folder não tem nenhum — criar uma pasta de projeto é tarefa do editor, não do Aggrega.

Quando o espaço de trabalho do Aggrega não é a pasta aberta — fica acima dessa pasta ou dentro dela —, a linha Aggrega workspace tem mais um controlo, que abre esse espaço de trabalho como pasta de projeto. É oferecido em vez de executado automaticamente, e o seu nome diz o que custa, além de para onde leva: abrir uma pasta recarrega a janela, pelo que o servidor de linguagem e esta extensão reiniciam e tudo o que não estiver guardado na janela se perde com eles. Quando a pasta aberta é ela própria o espaço de trabalho do Aggrega, não há nada para abrir, e o controlo não é desenhado.

Quando uma janela se abre numa pasta cujo espaço de trabalho do Aggrega fica fora dela — nem é essa pasta nem está dentro dela —, o editor indica-o também numa caixa de diálogo que é preciso fechar antes de continuar: começa com Aggrega is using a workspace from outside the folder you opened. e, por baixo, uma linha Aggrega workspace: e uma linha Project folder: com o caminho completo de cada um. Os seus botões são Open workspace (reloads the window), que abre o espaço de trabalho do Aggrega como pasta de projeto tal como o próprio controlo da linha; Continue here, que fecha a caixa de diálogo e não altera nada; e Don’t show again for this folder. Fechar a caixa de diálogo de qualquer outra forma — com Escape ou com o seu próprio controlo de fecho — equivale a Continue here. A caixa de diálogo aparece uma vez por pasta em cada janela, e de novo se o espaço de trabalho do Aggrega a que essa pasta pertence mudar; depois de Continue here, deixa de aparecer até a janela ser recarregada ou aberta de novo, e então regressa. Don’t show again for this folder é memorizado para essa janela e restaurado quando é reaberta, pelo que a caixa de diálogo não regressa para essa pasta. Nenhum dos três elimina o facto em si: enquanto o espaço de trabalho ficar fora da pasta, a linha Aggrega workspace tem uma marca de aviso à direita do seu valor, e passar o ponteiro sobre a linha mostra o mesmo título e os mesmos dois caminhos que a caixa de diálogo mostra. Um espaço de trabalho do Aggrega dentro da pasta aberta não está fora dela, pelo que não gera nenhuma caixa de diálogo e a sua linha não tem marca nem esse título; passar o ponteiro sobre a linha continua a indicar a pasta aberta, e o controlo que abre o espaço de trabalho como pasta de projeto continua a ser desenhado.

A caixa de diálogo é desenhada pelo sistema operativo, a menos que a definição window.dialogStyle do editor seja custom; por predefinição, segue portanto o tema do ambiente de trabalho e não o do editor, e nenhuma extensão pode alterar o seu aspeto; com window.dialogStyle definido como custom, o editor desenha-a no seu próprio tema.

Clicar na linha Aggrega workspace abre a escolha seja qual for o que está associado, incluindo quando é um único espaço de trabalho ou nenhum: o seletor lista os espaços de trabalho do Aggrega que a Project folder alcança — subindo a partir dela e examinando tudo o que contém —, cada um designado pela sua própria raiz, e, por último, uma forma de chegar a uma pasta que a janela não tem de todo aberta: Choose another folder Aggrega recognises…, ou Choose a folder Aggrega recognises… quando o seletor não tem nenhum espaço de trabalho para listar. Essa última entrada existe porque o alcance é limitado pelo que a janela contém: o editor só pesquisa nas pastas abertas, pelo que um espaço de trabalho situado noutro lugar é alcançável adicionando a sua pasta, e por nada mais curto. O servidor de linguagem inicia-se assim que a subida encontra um ponto de partida, sem esperar que essa pesquisa termine, pelo que uma janela pode associar-se e só um momento depois indicar que um segundo espaço de trabalho é alcançável — a lista no seletor atualiza-se quando a pesquisa regressa. O espaço de trabalho do Aggrega em que esta janela trabalhou por último também é retomado de imediato, incluindo um escolhido dentro da Project folder, porque o editor consulta o próprio marcador desse espaço de trabalho em vez de esperar pela pesquisa; só quando o marcador desaparece, ou deixa de marcar um espaço de trabalho que a Project folder alcança, é que a escolha é abandonada, e o utilizador é informado disso. Escolher outra entrada move o servidor de linguagem para lá e indica-o, quer seja alcançada a partir da mesma pasta que a que está em uso quer de outra, e escolher a entrada já em uso não reinicia nada e indica onde o editor já trabalha: Aggrega: the editor already works in ⟨path⟩., com a raiz do espaço de trabalho por extenso. Um espaço de trabalho do Aggrega alcançado a partir de duas pastas abertas ao mesmo tempo é uma única entrada e conta como uma: a descoberta sobe, pelo que uma raiz um nível acima responde por cada pasta abaixo dela, e perguntar qual dessas pastas contém o espaço de trabalho seria uma pergunta com duas respostas verdadeiras.

Clicar na linha Project folder abre o mesmo tipo de escolha: as pastas abertas na janela, cada uma identificada pelo próprio caminho, e, por último, duas formas de chegar a uma que a janela não tem aberta. Open folder… pede uma pasta através da caixa de diálogo de pastas do editor, cujo botão diz Open, e abre a pasta escolhida nesta janela em vez do que nela estiver aberto, tal como faz o próprio Open Folder do editor. Isso recarrega a janela, o que a descrição da entrada indica antecipadamente, e, se o editor não conseguir abrir a pasta, o utilizador é informado. Add folder to this window… pergunta da mesma forma, com um botão que diz Add, e adiciona a pasta escolhida à janela, depois das que já estão abertas, como a pasta a partir da qual o editor trabalha: foi escolhida nesta linha, pelo que a linha a nomeia em vez de voltar a perguntar, e os espaços de trabalho Aggrega propostos são os que ela alcança. Numa janela já aberta sobre um ficheiro de espaço de trabalho, a pasta junta-se a ele no mesmo lugar, e o utilizador é informado de que o editor passa a trabalhar a partir dela. Uma pasta que a janela já tem aberta não é adicionada novamente, e o utilizador é informado; se o editor recusar a pasta, o utilizador também é informado, e o editor continua a trabalhar a partir da pasta anterior. Fechar qualquer uma das caixas de diálogo sem escolher não altera nada.

Adicionar uma pasta a uma janela com uma única pasta, ou nenhuma, transforma a janela num espaço de trabalho multi-raiz, o que o editor faz reiniciando as suas extensões — incluindo esta — ou, numa janela remota como um dev container, recarregando a janela. Se a página de boas-vindas estava aberta quando as extensões reiniciam, é redesenhada no mesmo lugar, pelo que a janela continua a ter uma única página e esta descreve a janela tal como está agora. Tanto Add folder to this window… como a última entrada do seletor de espaço de trabalho Aggrega terminam numa adição deste tipo, pelo que, quando escolher qualquer uma delas teria esse efeito, a respetiva descrição indica-o antecipadamente. Esse espaço de trabalho é novo para o editor e começa sem aquilo que a janela abandonada memorizava, exceto a única resposta dada pela própria adição: uma pasta adicionada através de Add folder to this window… é aí a Project folder, e um espaço de trabalho Aggrega escolhido através da última entrada do seletor de espaço de trabalho Aggrega, ou através de Use a folder that already has one da página de boas-vindas, é aí o espaço de trabalho Aggrega. A Release que tinha sido escolhida, e as pastas para as quais se pediu à caixa de diálogo que não voltasse a aparecer, ficam com a janela abandonada.

A escolha é memorizada para essa janela e restaurada quando é reaberta, e determina o que a linha abaixo propõe: os espaços de trabalho Aggrega propostos são os que essa pasta alcança. Alcançar não é o mesmo que conter: como a descoberta sobe, o espaço de trabalho que uma pasta alcança é muitas vezes a pasta acima dela, pelo que escolher um subdiretório do repositório continua a propor o espaço de trabalho do próprio repositório. Com uma única pasta aberta não há nada a escolher e a linha limita-se a nomeá-la. Com várias e nenhuma escolhida, a linha indica none selected, e os espaços de trabalho Aggrega propostos são os que a janela inteira alcança. Quando há apenas um, ou quando um deles é aquele em que esta janela trabalhou por último, o servidor de linguagem arranca aí; quando há vários e nenhum está memorizado, não arranca até ser escolhido um, e Choose Aggrega workspace… da barra de estado e uma notificação pedem que se faça essa escolha. Um servidor de linguagem que para ou não consegue arrancar por si só deixa a linha Project folder a nomear a pasta — o espaço de trabalho continua escolhido, e é o indicador do servidor de linguagem que dá conta do estado do servidor.

Abaixo dessas linhas, as operações estão agrupadas segundo aquilo que se pretende fazer: Build (validate, lint, build, preview, graph), Dependencies (pull), Author (import, inspect), Publish (push, sign, deprecate) e Configuration (show config, cache).

Ao lado de Commands encontram-se um painel Registries, encabeçado por Add registry e Update index e que lista cada registo que a configuração efetiva declara; um painel Catalog, encabeçado por Search catalog e Draft entity e que lista as entidades que o espaço de trabalho vê; e um painel Plugins, encabeçado por Add plugin e Generate entities e que lista os plugins Wasm incorporados e configurados. Essas primeiras linhas fazem parte da própria lista do painel: cada uma tem rótulo e ícone, pelo que é visível sem apontar para nada, premi-la executa a operação, e recolher o painel recolhe-a juntamente com o resto. Estão presentes seja o que for que a lista abaixo indique — incluindo quando indica que nada está configurado, que é precisamente quando adicionar o primeiro é o objetivo, e quando indica que nenhum espaço de trabalho Aggrega está disponível. Quando uma ainda não pode ser executada, fica onde está e indica o motivo ao lado do nome, com as palavras que o painel Commands usa para o mesmo estado, e premi-la não executa nada. Cada um desses três painéis tem também na barra de título uma atualização, que volta a ler essa única lista, e nada mais — uma operação aí seria um ícone sem rótulo que seria preciso sobrevoar para encontrar. Validate, build, preview build e lint reportam no painel Problems; as operações baseadas na linha de comandos enviam a sua saída para o canal de saída Aggrega.

Os painéis Registries, Catalog e Plugins, cada um a abrir com as suas próprias operações como linhas com rótulo acima da lista que contém.

O painel Commands

  • Uma única superfície de definições, acessível a partir de uma roda dentada — o painel Commands tem uma roda dentada no canto superior direito, que abre as definições do próprio editor filtradas para esta extensão. Não existe uma segunda página de definições própria da extensão, pelo que uma preferência tem um único sítio onde reside e um único sítio onde é escrita. Cada preferência pertence ao utilizador e não ao projeto; consulte Definições.

  • Duas formas para o painel Commands — aggrega.operations.layout escolhe entre buttons, o valor predefinido, em que cada operação é um botão com etiqueta num único fluxo contínuo sem qualquer título de grupo, e sections, em que cada grupo é uma secção que se abre sob o seu próprio título e o painel mostra tanto quanto se mantiver aberto. Ambas contêm os mesmos grupos com as mesmas operações, pela mesma ordem; a definição muda a forma como um grupo é desenhado, nunca as operações que existem. Em ambas as formas, as linhas Project folder, Aggrega workspace e Release ficam acima de qualquer operação, pelo que fechar uma secção nunca retira as informações que indicam a que se aplicaria uma operação. Em sections, o controlo pendente ao lado de Build é uma linha própria por baixo dele, que mostra Build options antes da sua divisa, para que não seja lido como uma secção a abrir. Alterar a definição volta a desenhar o painel aberto e não reinicia nada. O painel Commands abre com uma parte da barra lateral maior do que os três painéis ao lado — numa janela com 900 píxeis de altura, o suficiente para mostrar todo o seu fluxo na largura predefinida da barra lateral; a partir daí, o editor mantém as alturas dos painéis para cada espaço de trabalho, pelo que um espaço de trabalho cuja barra lateral já tenha sido organizada antes mantém as alturas que tinha.

  • Um botão que oferece uma escolha apresenta-a ao seu lado — uma operação que responde a um clique perguntando sobre que elemento ou que entidade agir apresenta essa escolha como um menu ao lado do botão premido, em vez de numa caixa de diálogo que ocupa a janela inteira: Cache… oferece as quatro operações de cache, e Inspect e Push oferecem as entidades que o espaço de trabalho consegue ver. O menu abre-se por baixo do botão ou por cima dele, do lado em que o painel tem mais espaço, e não é mais alto do que esse espaço, pelo que nunca ultrapassa a margem do painel — uma lista mais longa do que o espaço desloca-se dentro dele — e o seu nome, aquilo que está a escolher, permanece no topo durante o deslocamento. Isto aplica-se onde quer que o painel esteja, incluindo ancorado numa barra lateral baixa. O menu alcança-se premindo o botão e nunca com a tecla Tab, pelo que o painel continua a custar uma única paragem, por muitos menus que contenha. Dentro dele, as teclas de seta movem-se entre as opções e Enter escolhe aquela em que se está; escrever restringe a lista — a correspondência é um fragmento do nome de uma opção ou da linha por baixo dele, e o menu indica quantas restam —, Backspace desfaz o que foi escrito, Escape fecha o menu e devolve o foco ao botão, e clicar em qualquer outro sítio — no painel ou noutra parte do editor — fecha-o sem executar nada. As mesmas operações estão no índice de comandos do editor, onde não há nenhum botão ao lado do qual abrir um menu, pelo que, invocada a partir daí, cada uma faz a sua pergunta como uma lista a partir da qual se escolhe.

    O menu do botão Inspect aberto ao lado dele, com o título Entity to inspect e a lista das entidades que o espaço de trabalho vê.

  • Um menu cujas opções têm de ser pedidas indica que está a ler — os menus abertos por Inspect e Push não contêm nada até que o servidor de linguagem responda que entidades o espaço de trabalho contém, uma leitura que mostra o progresso e pode ser interrompida. Ambos abrem com uma linha a dizer que estão a ler e preenchem-se quando a resposta chega, em vez de abrirem vazios: uma lista de opções vazia lê-se como não há nada, o que é uma resposta diferente de aguarde. O que tiver sido escrito enquanto a leitura decorria continua a aplicar-se quando as opções chegam. Onde não há nada a oferecer — nenhuma entidade que a operação possa nomear —, o menu fecha-se e uma mensagem indica-o, a mesma mensagem que se obtém ao executar a operação a partir do índice de comandos, em vez de um menu sem nada lá dentro.

  • Escolher e consentir continuam a ser atos distintos — um menu é o sítio onde se diz qual, e nunca contém uma confirmação. As três operações de cache que removem algo continuam a apresentar uma confirmação modal depois da escolha, nomeando as caches que essa operação alcança, e a geração de entidades Plugin continua a pedir confirmação antes de escrever. Uma confirmação justifica a sua interrupção: integrá-la numa lista em linha permitiria que um clique acidental esvaziasse uma cache. A pesquisa no catálogo publicado mantém a sua lista de filtros, à qual se regressa depois de editar cada faceta, porque um menu se adequa mal a algo em que se volta a entrar após cada resposta.

  • O que separa um grupo do seguinte, em cada forma — no fluxo, nada é desenhado entre um grupo e o seguinte: os grupos decidem a ordem pela qual os botões aparecem, e a ordem é tudo o que exprime o agrupamento, pelo que o painel não gasta largura com um divisor. Na forma de secções, o grupo Publish tem uma linha por cima, porque as suas operações mudam aquilo que obtém quem quer que resolva esse catálogo, enquanto as restantes atuam nesta máquina — uma diferença de natureza, que merece ser assinalada uma vez e que tem uma caixa de grupo onde ser assinalada.

  • Um painel estreito muda de linha em vez de truncar ou deslocar-se lateralmente — o fluxo ocupa tantas linhas quantas a largura exigir, e nenhuma quebra é fixa: ao alargar o painel, os botões reorganizam-se em menos linhas. A etiqueta de cada botão é apenas o nome da operação, com a explicação ao passar o ponteiro, pelo que uma linha contém tantas operações quantas puder. Nada fica escondido atrás de um gesto lateral, e nenhuma etiqueta é truncada.

  • Cada operação pede aquilo de que precisa antes de ser executada — uma operação que o painel vê que não pode ser executada permanece no lugar, a cinzento, e indica porquê: passar o ponteiro por cima dela nomeia o que falta, e um leitor de ecrã anuncia-a como indisponível com o mesmo motivo. Não é removida, porque num fluxo de botões remover um desloca os outros para baixo do ponteiro, e um clique cai então em algo diferente do que lá estava um instante antes — e é também por isso que o controlo pendente ao lado de Build permanece ao seu lado enquanto Build não pode ser executado, a cinzento com ele, dando o mesmo motivo e não abrindo nada. Duas condições põem um controlo a cinzento: as operações que atuam sobre uma Release precisam de uma selecionada, e as que executam o binário aggrega precisam de uma pasta de espaço de trabalho ancorada onde ser executadas. Uma operação que só precisa do servidor de linguagem não fica a cinzento quando o servidor está parado — ao ser premida, comunica a própria mensagem do compilador, e a barra de estado é o sítio onde esse estado é nomeado. Push, sign e deprecate pedem cada uma primeiro o seu objeto: push oferece as entidades listadas pelo painel Catalog que têm um documento no espaço de trabalho, enquanto sign e deprecate pedem uma referência a um artefacto que já está num registo, porque é isso que essas duas alteram. Deprecate pede também uma gravidade e um motivo, que o compilador exige e que não tem forma de pedir a partir do editor. Pull é executada sobre a Release selecionada em vez de pedir um objeto. As operações no topo dos painéis Registries, Catalog e Plugins perguntam da mesma forma: adicionar um registo pede o anfitrião e em que ficheiro de configuração escrevê-lo, adicionar um plugin faz as duas ou três perguntas de que o seu tipo precisa, gerar entidades Plugin pergunta o que abranger e onde escrever, a pesquisa no catálogo publicado abre uma lista de filtros que se compõe antes de ser executada, e redigir uma entidade pede o tipo e depois um nome. Todas, exceto Draft entity, precisam de uma pasta de espaço de trabalho ancorada, pelo que, sem ela, cada uma dessas linhas o indica ao lado do seu nome e premi-la não executa nada — a informação é dada antes de se responder a qualquer coisa, e não depois. Draft entity só precisa do servidor de linguagem, pelo que nunca é desenhada como impossível de executar.

Os painéis Registos, Catálogo e Plugins

  • Detalhe do painel Registos — cada linha indica o host do registo, o seu alias quando existe um configurado, qual o registo predefinido, se são exigidas assinaturas para os artefactos obtidos a partir dele e se existe uma credencial para esse host. A leitura da lista não contacta nenhum registo: o estado da credencial indica apenas a presença, pelo que diz que existe uma credencial, e não que o registo a aceitaria.

    As operações que atuam sobre o conjunto inteiro são as duas primeiras linhas do painel — Adicionar registo e Atualizar índice, que atualiza o índice pesquisável de cada registo configurado —, enquanto as operações que atuam sobre um único registo estão na linha desse registo: atualizar o índice apenas para ele, remover a credencial guardada e remover o registo. A barra de título do próprio painel contém apenas a atualização.

    Adicionar um registo e remover um perguntam, cada um, que ficheiro de configuração alterar, propondo primeiro o ficheiro global partilhado por todos os projetos desta máquina, porque é aí que estas duas operações escrevem, salvo indicação em contrário; a outra opção é o ficheiro de configuração do próprio projeto. Cada uma das duas termina indicando o ficheiro que efetivamente alterou e o alcance desse ficheiro, de acordo com o que o compilador fez e não com o que foi pedido. O servidor de linguagem lê a sua configuração ao arrancar, pelo que cada uma das duas é seguida de um reinício do servidor de linguagem, sem perguntar, e o painel e o passo dos registos da página de boas-vindas são lidos novamente quando este volta: o registo adicionado aparece na lista, ou o removido desaparece, sem recarregar nem atualizar. Depois de o servidor reiniciado ter lido a alteração, a mensagem final acrescenta que a alteração já está em vigor; se o reinício falhou, não o acrescenta, porque a alteração está então no ficheiro, mas ainda não em vigor.

    Remover um registo e remover uma credencial pedem, cada um, uma confirmação prévia, e cada um indica o alcance da alteração: a confirmação para um registo indica o ficheiro escolhido, pelo que retirar uma entrada do ficheiro global é descrito como algo que afeta todos os projetos que resolvem através dele, e retirar uma do ficheiro do próprio projeto como algo que não afeta nenhum outro projeto, enquanto uma credencial é eliminada do armazenamento de credenciais partilhado e a entrada do registo se mantém. Remover uma credencial não oferece escolha de ficheiro, porque o armazenamento de credenciais é partilhado por todos os projetos da máquina e não tem uma forma por projeto na qual escrever.

    A construção do índice mostra o progresso e pode ser interrompida, e é a única destas operações oferecida com um botão Cancelar. Premi-lo termina a própria varredura, e não apenas a espera do editor, e a construção termina dizendo que foi interrompida. As entradas de cada registo só são escritas quando a sua própria varredura termina, pelo que uma construção interrompida deixa indexados os registos cujas varreduras tinham terminado, e o registo que estava a ser varrido mantém o índice que tinha antes, inalterado — trata-se, portanto, de uma interrupção e não de uma anulação. Uma construção que chega ao fim indica quantas entidades foram indexadas a partir de quantos registos e o diretório em que o índice foi escrito, o que mostra que uma atualização não altera nada através do qual outro projeto desta máquina resolve, e um registo que não foi possível indexar é indicado com o motivo dado pelo próprio compilador: de um que não foi possível alcançar diz-se que não foi alcançado — Não foi possível alcançar ⟨registo⟩: antes desse motivo — e de um que respondeu e falhou de outra forma, como um cuja listagem de repositórios se repetia, o que termina a varredura desse registo em vez de o percorrer novamente em círculo enquanto os outros registos continuam a ser indexados, diz-se que não foi possível indexá-lo; a frase final indica os dois grupos separadamente. Atualizar o índice de um único registo que não pode ser alcançado termina da mesma forma, indicando-o como não alcançado.

    Adicionar um registo também acede à rede, uma vez que obtém a política de confiança que o registo anuncia, e é oferecido sem botão Cancelar; em qualquer dos casos, termina indicando o ficheiro que escreveu. Um registo que não foi possível alcançar é indicado como não alcançado nessa mensagem final, antes do motivo dado pelo próprio compilador, em vez de se dizer que não anuncia nenhuma política — incluindo o hub oficial, cuja entrada passa então a ter a sua linha de base integrada. Quando um registo que não seja o hub oficial não anuncia nenhuma política de confiança ou não foi possível alcançá-lo — ou, com o espaço de trabalho offline, é recusado porque não foi possível obter nenhuma —, a mensagem final é seguida de uma pergunta que propõe fixar uma manualmente, com exatamente o que --identity e --key da linha de comandos aceitam nesse caso: identidades sem chave, cada uma escrita como identity=issuer e introduzida uma de cada vez, um ficheiro de chave pública escolhido numa caixa de diálogo de ficheiros, ambos ou nenhum. O que for fornecido é registado novamente para o mesmo host no mesmo ficheiro, e essa mensagem final indica que tipo de política a entrada tem agora, sem repetir as identidades nem o ficheiro; uma identidade mal formada, ou um ficheiro de chave que não pode ser lido ou não é uma chave pública, termina com a recusa do próprio compilador. A recusa de um ficheiro que não é uma chave pública indica o que o compilador esperava e omite o que o ficheiro contém, pelo que uma chave privada escolhida por engano não aparece nem na notificação nem no canal de saída do Aggrega. Premir Escape em qualquer destes pedidos, ou escolher Nenhum, não fixa nada, e mantém-se o que a linha de comandos deixa quando não recebe nenhuma das duas flags. Um registo cuja política anunciada foi fixada, e o hub oficial com a sua linha de base integrada, não são questionados.

    Remover um registo, remover uma credencial e ler a lista não contactam nenhum registo. O início de sessão num registo não é oferecido no painel, porque o comando lê uma palavra-passe a partir de um terminal e não existe nenhum por trás de um botão — execute-o a partir de um terminal e prima atualizar.

  • Detalhe do painel Catálogo — as entidades que o espaço de trabalho consegue ver, agrupadas sob um cabeçalho por tipo, com cada linha a indicar a entidade e as etiquetas que declara, com o seu apiVersion e a sua descrição na dica. As linhas provêm de dois locais e cada uma indica de qual. Uma entidade declarada por um documento no espaço de trabalho tem o caminho desse documento na dica, e clicar na linha abre esse ficheiro. Uma entidade resolvida a partir de um diretório de catálogo — o diretório catalog/ na raiz do espaço de trabalho, e os que a configuração indica para a Release selecionada em workspace.releases ou, quando não indica nenhum para ela ou nenhuma está selecionada, para todo o espaço de trabalho em workspace.catalog_dirs — é marcada como proveniente daí e não tem caminho: o espaço de trabalho não contém nenhum ficheiro próprio para ela, pelo que a linha indica de onde provém em vez de oferecer um clique que não leva a lado nenhum.

    A lista é a da Release selecionada: um documento num diretório que a configuração indica apenas para outras Releases fica de fora, pelo que, quando cada Release lê uma variante de uma mesma entidade a partir de um diretório próprio, o painel lista apenas a variante da Release selecionada. Sem nenhuma Release selecionada, todos os documentos do espaço de trabalho são listados. Um documento que não declara kind: ou metadata.name: não é listado, e é isso que mantém o painel como um índice de entidades e não de ficheiros.

    O servidor de linguagem não lê nenhuma entidade através de uma ligação que leva para fora do espaço de trabalho — uma ligação a um diretório exterior, ou uma ligação com nome de ficheiro YAML que leva a um ficheiro exterior —, pelo que nenhuma entidade por trás de uma dessas ligações é listada, embora a árvore de ficheiros do editor a mostre. A única exceção é uma Release que a configuração do espaço de trabalho nomeia, como build.authoring_release ou como chave de workspace.releases, que é lida através da sua ligação e listada no lugar da própria ligação. Onde a lista omite uma dessas ligações, uma linha própria a seguir à lista indica-o: As entidades alcançadas através desta ligação não são listadas, porque ela leva para fora do espaço de trabalho Aggrega: seguido do caminho da ligação relativo ao espaço de trabalho — ou As entidades alcançadas através destas ligações não são listadas, porque cada uma leva para fora do espaço de trabalho Aggrega: para várias, nomeando primeiro as ligações a diretórios e depois as ligações a ficheiros. Passar o ponteiro sobre a linha mostra a frase inteira, uma vez que um caminho longo é cortado na linha. Com uma Release selecionada, uma ligação dentro de um diretório de catálogo que só outras Releases leem não é nomeada, uma vez que nada por trás dela seria listado para essa Release de qualquer forma.

    A lista é a própria resposta do servidor de linguagem, pelo que nomeia as mesmas entidades que o compilador lê — incluindo os buffers não guardados do editor, que prevalecem sobre os bytes em disco — e é apresentada pela ordem em que o servidor a enviou, em vez de ser reordenada aqui. O painel volta a ler a lista por iniciativa própria quando o servidor de linguagem passa a poder responder, quando a Release selecionada muda, quando um documento .yaml numa pasta aberta na janela é criado, alterado ou eliminado em disco — pelo editor, por um terminal ou por um checkout, indiferentemente — e quando o editor fecha um documento YAML. Só o pede depois de o servidor de linguagem ter descartado o que guardava para esse ficheiro, pelo que um ficheiro eliminado enquanto estava aberto no editor sai da lista em vez de ser comunicado a partir da última cópia que o editor enviou, um documento renomeado num buffer e fechado sem guardar volta a ser listado tal como está em disco, e uma rajada dessas alterações e fechos resulta numa única leitura. O editor fecha um documento quando o liberta, o que não promete fazer no momento em que o separador do documento é fechado, pelo que uma linha obtida do texto de um documento cujo separador foi fechado pode permanecer até que o editor o faça. O painel não acompanha a escrita por iniciativa própria. Uma alteração ainda num buffer não guardado é enviada ao servidor de linguagem assim que se faz uma pausa na escrita nesse documento — cada documento aberto aguarda a sua própria pausa, pelo que escrever num nunca atrasa outro — e aparece da próxima vez que a lista for lida depois disso. Premir a atualização do painel lê a lista para cada documento aberto tal como o editor o mantém no momento em que se prime, por pouco tempo que tenha passado desde a última tecla ou anulação: uma alteração ainda não enviada é enviada de imediato, e a lista só é pedida depois de o servidor de linguagem ter respondido a cada alteração que lhe foi enviada até ao momento em que se premiu. Uma pasta eliminada por inteiro aparece da próxima vez que a lista for lida, ou quando se premir a atualização, uma vez que o editor pode comunicá-la como uma única alteração à pasta em vez de uma a cada documento que contém.

    Pesquisar no catálogo publicado é a primeira linha deste painel, Search catalog: pede um filtro e copia a referência do que se escolher. Redigir uma nova entidade é a segunda linha, Draft entity: pede o tipo, como uma lista a partir da qual se escolhe, e abre o documento inicial num separador sem escrever nada em disco. A barra de título deste painel contém apenas a atualização. As operações que atuam sobre uma entidade estão na linha dessa entidade, e uma linha oferece uma operação apenas onde o compilador a aceita para o tipo da linha. Os tipos que cada operação aceita são a própria resposta do servidor de linguagem, lida de novo com a lista de cada vez, pelo que as linhas acompanham o compilador em execução em vez de uma lista mantida na extensão. Inspecionar aquilo em que uma entidade se resolve é a única operação acessível sem abrir o menu da linha: dirige-se à entidade pelo nome, que todas as linhas contêm, pelo que é oferecida numa linha quer o espaço de trabalho contenha um documento para ela quer não, onde quer que o compilador resolva um nome numa entidade desse tipo, e não altera nada.

    Validar a entidade, verificar as suas convenções de publicação e publicá-la recebem cada uma o caminho da entidade, pelo que só são oferecidas numa linha cuja entidade é declarada por um documento neste espaço de trabalho; uma linha resolvida a partir de um diretório de catálogo configurado não tem neste espaço de trabalho um caminho para lhes fornecer, e nela são omitidas em vez de oferecidas como controlos que só poderiam comunicar um argumento em falta. Destas três, verificar as convenções de publicação é oferecido em todas essas linhas. Validar é oferecido onde o compilador verifica por si só um documento desse tipo: um Aggregate, por exemplo, é verificado com o catálogo inteiro quando se encontra num diretório de catálogo, e com uma Release que o implanta, pelo que a sua linha não oferece validação. A validação verifica a entidade nos termos da Release selecionada, como aggrega validate <path> --release <Release> faz num terminal, de modo que aquilo a que a entidade se refere — o Component que uma Recipe implementa, uma biblioteca que o seu esquema compõe — é resolvido através dos diretórios de catálogo com que essa Release é compilada; sem Release selecionada, através dos do próprio espaço de trabalho. Publicar é oferecido onde um documento desse tipo é publicado por si só, o que deixa de fora um Plugin, cuja publicação também vincula o seu executável, e um Manifest ou uma Release, nenhum dos quais é publicado. Se o servidor de linguagem não indicar que operações aceitam o tipo de uma linha, as linhas continuam a ser listadas e uma linha com um documento oferece apenas a verificação de convenções; onde o pedido dessa resposta falha, o motivo é escrito no canal de saída do Aggrega.

    Publicar pede confirmação primeiro e indica até onde chega a alteração: a entidade é empacotada e enviada com a sua própria versão declarada, e quem obtiver essa versão desse registo resolve o que foi publicado. Publicar é também a única destas operações que altera algo para além desta máquina; as duas verificações e a inspeção não escrevem nada nem publicam nada. As quatro mostram o progresso e podem ser interrompidas.

  • Detalhe do painel Plugins — cada linha nomeia o plugin, o seu tipo e versão, e o seu estado de prontidão, onde o plugin o indicar. Um plugin que o compilador não conseguiu resolver ou descrever é assinalado e mantém a sua própria linha, com a mensagem do compilador na dica, pelo que nunca é confundido com um que funciona. A dica nomeia também a chave de configuração de onde provém um anexo, as suas capacidades, os seus tipos de entrada, o seu boundary e as suas exportações — mostrando apenas o que a listagem efetivamente indica.

    As operações que atuam sobre o conjunto inteiro são as duas primeiras linhas do painel — Add plugin, e Generate entities, que escreve entidades de catálogo Plugin —, e a barra de título do próprio painel contém apenas a atualização. Adicionar pergunta que tipo de plugin, como uma lista a partir da qual se escolhe, e depois a única resposta adicional que esse tipo exige: a capacidade que uma associação provider serve, ou o papel ao qual um anexo governance está vinculado, e por último o nome a procurar no registo configurado, que tem de se resolver em exatamente um plugin desse tipo; o anexo é escrito na configuração do espaço de trabalho deste projeto. Adicionar é a única operação aqui que acede à rede, uma vez que pesquisa no registo, pelo que mostra o progresso e pode ser interrompida. Onde uma versão publicada do plugin foi retirada, adicionar termina indicando-o em vez de deixar que seja descoberto mais tarde: as versões retiradas e não selecionadas, o motivo registado para cada uma, e de onde foram lidos os registos de retirada e quando foram atualizados pela última vez, mostrando apenas o que o compilador indica — e, onde esses registos não puderam de todo ser lidos, indica isso em vez disso, com o próprio motivo do compilador, o que é uma resposta diferente de nada ter sido retirado.

    Gerar entidades de catálogo pergunta se deve abranger cada plugin integrado no compilador ou um artefacto de plugin desta máquina, também como uma lista a partir da qual se escolhe, depois a sobreposição escrita à mão a fundir e o diretório sob o qual escrever, e pede confirmação antes de escrever: cada entidade é escrita num caminho derivado do tipo, do nome e da versão do seu plugin, pelo que uma entidade já existente para esse mesmo plugin e essa mesma versão é substituída.

    Remover um plugin está na linha desse plugin. Pede confirmação primeiro e indica que ficheiro de configuração escreve, porque isso depende do tipo do plugin — um plugin cli é removido da configuração global partilhada por todos os espaços de trabalho desta máquina, qualquer outro tipo da configuração própria deste projeto —, e opera apenas sobre o texto da configuração, pelo que nada mais nesta máquina é removido. A remoção só é oferecida num plugin configurado pelo qual o compilador respondeu: um plugin integrado no compilador não é de todo uma entrada de configuração, e um anexo que nada conseguiu resolver ou descrever chega sem tipo, que a remoção exige juntamente com a referência — por isso, nessas linhas, é omitida em vez de oferecida como um controlo que só poderia comunicar um argumento em falta. Adicionar um plugin cli não é oferecido no painel, porque instalá-lo confirma as suas capacidades declaradas num terminal e não existe nenhum por trás de um botão — execute-o num terminal e prima atualizar. Sincronizar os registos geridos pela máquina de uma entidade de plugin também não é oferecido: recebe o ficheiro da entidade e o artefacto .wasm como dois caminhos, e uma linha não nomeia nenhum dos dois.

  • Pesquisa no catálogo publicado — pesquisa entidades de catálogo nos registos configurados e copia uma referência para colar num Aggregate. A pesquisa é afinada a partir de uma única lista em que cada faceta mostra o seu valor atual: texto livre comparado com o nome e a descrição, um ou mais tipos de entidade, um seletor de labels (a categoria é um label), uma ou mais capacidades de plugin, um socket de plugin e um limite de quantos resultados são devolvidos. Uma faceta deixada como está não restringe nada. O que se define é mantido: a pesquisa seguinte abre com o filtro que a última deixou, quer tenha sido executada, não tenha encontrado nada ou tenha sido fechada após uma edição, pelo que afinar de novo é uma única edição em vez de introduzir todo o filtro outra vez. Reset search filter, a linha logo acima de Search, repõe cada faceta para não restringir nada e regressa à lista sem pesquisar; a sua descrição indica as facetas que limparia, ou diz que nada está definido. O filtro é mantido apenas enquanto a extensão é executada nessa janela e não é guardado em lado nenhum — não está em nenhuma definição, pelo que outra janela pesquisa a partir do seu próprio, e recarregar a janela, ou qualquer outra coisa que reinicie as extensões do editor, parte de um filtro vazio. A pesquisa lê o índice local escrito por aggrega registry update — Update index no painel Registries — e não contacta nenhuma rede, pelo que um registo cujo índice ainda não foi construído não é pesquisado. O canal de saída indica-o na linha própria desse registo, com Update index para construir o seu índice, e indica que um índice está desatualizado numa linha à parte, com Update index para o atualizar; uma pesquisa que não encontrou nada com um registo nessas condições configurado indica os registos que pesquisou e os que não pesquisou; e onde nenhum registo configurado tem índice, a pesquisa apresenta a própria mensagem do compilador que indica o passo a executar.