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

Escolha a Release em que você trabalha

Release selecionada — um indicador na barra de status e uma linha Release no topo do painel Commands, cada um indicando a única Release com a qual o editor está trabalhando. Tudo o que age sobre uma Release — validação, o grafo de topologia, build, build de pré-visualização e pull — age sobre essa. Um painel de grafo já aberto mantém a Release a partir da qual foi desenhado quando você seleciona outra, e mostrar o grafo novamente desenha a recém-selecionada. O grafo, o build, o build de pré-visualização e o pull leem os diretórios de catálogo com os quais essa Release é compilada: os dela própria, onde a configuração do seu workspace indica alguns para ela em workspace.releases, e caso contrário os do workspace — os mesmos que aggrega build --release lê em um terminal, de modo que uma única janela compila cada Release de um workspace com seu próprio catálogo, sem nenhum flag para passar. O painel Catalog, uma inspeção, a verificação da linha Catalog, o hover, o autocompletar, Go to Definition, Find References e Find Implementations também respondem nos termos da Release selecionada: onde a configuração do seu workspace indica diretórios de catálogo para cada Release, cada um lê os documentos que o workspace contém, exceto os de um diretório que só outra Release lê, e os diretórios de catálogo com os quais a Release selecionada é compilada — de modo que um nome declarado por várias variantes, uma por Release, é resolvido para a da Release selecionada. Sem nenhuma Release selecionada, eles respondem nos termos do próprio workspace. Veja Selecionando uma Release.

Como selecionar uma Release

A maior parte do que a extensão faz é restrita a uma Release: quais diretórios de catálogo são lidos, quais componentes são resolvidos, quais pins do lockfile se aplicam e quais achados um documento recebe. Por isso a extensão trabalha com uma Release selecionada por vez, e mostra qual é na barra de status, ao lado de um ícone de foguete.

A Release que você escolhe é lembrada por aquela janela do editor. Quando o servidor de linguagem se conecta, uma escolha lembrada é comparada com o que o workspace ainda oferece e restaurada se ainda estiver lá; se tiver sumido, o editor avisa você e recorre ao que o seu workspace implica, que é onde a seleção começa quando você não escolheu nada nesta janela. Essa resposta vem de, em ordem de precedência:

  1. build.authoring_release em .aggrega-config.yaml, a configuração versionada que uma equipe inteira compartilha.
  2. .aggrega/active-release, um arquivo marcador local que não é versionado.
  3. A única Release no workspace, quando há exatamente uma.

Clique em qualquer um dos indicadores para selecionar outra Release (ou execute Aggrega: Select Release… na Command Palette). A mudança tem efeito imediato — nada é reiniciado, cada arquivo YAML aberto é verificado de novo em relação à Release que você acabou de escolher, e o painel Catalog lê sua lista de novo para ela; o mesmo acontece quando uma Release é adotada ao conectar o servidor de linguagem. A memorização é local à janela do editor: escolher não grava nada no seu workspace. Se o foco estava no painel Commands quando o seletor abriu — na linha Release dele ou em qualquer um de seus controles —, ele volta para esse controle quando o seletor fecha, quer você tenha escolhido uma Release ou o tenha descartado; aberto de qualquer outro lugar, o seletor deixa o painel sem o foco.

O seletor de Release listando as quatro Releases de um espaço de trabalho por seus caminhos, enquanto a linha Release e a barra de status indicam que nenhuma está selecionada.

As Releases oferecidas são as que estão dentro da pasta à qual o servidor de linguagem se ancorou, nomeadas em relação a ela, porque essa é a forma que ele aceita. Onde uma Release não pode ser oferecida, o editor diz quantas são e onde estão, em vez de omiti-las em silêncio. O servidor de linguagem não lê nenhuma Release por meio de um link que saia dessa pasta, então uma Release que a árvore de arquivos do seu editor mostra por meio de um link que sai dela — um link para um diretório externo, ou para um arquivo de Release externo — não é oferecida. A única exceção é um link para um arquivo de Release que a configuração do workspace nomeia, como build.authoring_release ou como chave de workspace.releases: essa Release é lida por meio do seu link e oferecida. Ao abrir, o seletor avisa isso em uma notificação própria, nomeando pelo caminho relativo a essa pasta cada link desse tipo que esteja onde o servidor de linguagem leria de outra forma: primeiro os links para diretórios, depois os links para arquivos. Um link cujo nome termina em .yaml ou .yml é nomeado seja qual for o conteúdo do arquivo para o qual leva, porque esse arquivo não é lido para descobrir.

Quando você quer que uma escolha fique registrada no próprio workspace — para que um checkout novo comece nela —, dois comandos fazem isso, e nenhum deles muda aquilo em que você está trabalhando agora:

  • Aggrega: Set the selected Release as this workspace’s default faz o servidor de linguagem gravar a Release selecionada no momento em .aggrega/active-release. Esse arquivo é local ao seu checkout, então é o lugar certo para um padrão pessoal. Onde .aggrega ou o marcador é um link que leva para fora do workspace Aggrega, nada é gravado, e a notificação traz as próprias palavras do compilador sobre o motivo.
  • Aggrega: Set authoring_release in .aggrega-config.yaml… abre o arquivo de configuração para que você possa definir build.authoring_release. Essa configuração é versionada e compartilhada, e tem precedência sobre o arquivo marcador. Onde o servidor de linguagem informa que o arquivo de configuração é um link que leva para fora do workspace Aggrega, o arquivo não é aberto, e um erro diz que ele leva para fora do workspace, portanto o Aggrega não o usa; o controle da página de boas-vindas que cria uma configuração de workspace faz o mesmo com um arquivo que já encontra lá.

Se o workspace não oferece nenhuma Release — nenhuma configurada, nenhum marcador e não exatamente um arquivo em que se apoiar —, o indicador diz isso, e diz qual de duas coisas é verdadeira. Ele mostra Release: none selected onde há Releases entre as quais escolher e você não está em nenhuma delas, e Release: none available onde o workspace Aggrega não ofereceu nenhuma. O segundo não é um estado que você possa resolver escolhendo, então o tooltip dele nomeia as saídas — trabalhar em outro workspace Aggrega, ou criar uma Release — em vez de mandar você para uma lista que só pode voltar vazia. Onde nada leu o workspace ainda, o tooltip diz isso em vez de relatar uma contagem que ninguém fez. Cada uma dessas indicações traz o que foi procurado, e o relato completo é escrito no canal de saída do Aggrega. A validação continua sendo executada nesse estado: você recebe os achados que um documento responde por si só — se ele é analisado e se sua própria forma é admissível — e as verificações que precisam de uma Release são ignoradas até você selecionar uma.