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

Escolher a Release em que se trabalha

Release selecionada — um indicador na barra de estado e uma linha Release no topo do painel Commands, cada um a indicar a única Release com que o editor está a trabalhar. Tudo o que age sobre uma Release — a validação, o grafo de topologia, a compilação, a compilação de pré-visualização e a obtenção — age sobre essa. Um painel de grafo já aberto mantém a Release a partir da qual foi desenhado quando se seleciona outra, e mostrar novamente o grafo desenha a recém-selecionada. O grafo, a compilação, a compilação de pré-visualização e a obtenção leem os diretórios de catálogo com que essa Release é compilada: os seus próprios, onde a configuração do workspace indica alguns para ela em workspace.releases, e caso contrário os do workspace — os mesmos que aggrega build --release lê num terminal, pelo que uma única janela compila cada Release de um workspace com o seu próprio catálogo, sem nenhum flag a passar. O painel Catalog, uma inspeção, a verificação da linha Catalog, o hover, a conclusão automática, Go to Definition, Find References e Find Implementations respondem também nos termos da Release selecionada: onde a configuração do 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 que a Release selecionada é compilada — pelo que um nome declarado por várias variantes, uma por Release, é resolvido para a da Release selecionada. Sem nenhuma Release selecionada, respondem nos termos do próprio workspace. Consulte Selecionar uma Release.

Selecionar uma Release

A maior parte do que a extensão faz está circunscrita a uma Release: que diretórios de catálogo são lidos, que componentes são resolvidos, que pins do lockfile se aplicam e que constatações um documento recebe. Por isso, a extensão trabalha com uma Release selecionada de cada vez, e mostra qual na barra de estado, ao lado de um ícone de foguetão.

A Release escolhida fica memorizada nessa janela do editor. Quando o servidor de linguagem se liga, uma escolha memorizada é comparada com o que o workspace ainda oferece e reposta se ainda lá estiver; se tiver desaparecido, o editor informa disso e recorre ao que o workspace implica, que é onde a seleção começa quando nada foi escolhido nesta janela. Essa resposta provém de, por ordem de precedência:

  1. build.authoring_release em .aggrega-config.yaml, a definição versionada que toda uma equipa partilha.
  2. .aggrega/active-release, um ficheiro marcador local que não é versionado.
  3. A única Release no workspace, quando existe exatamente uma.

Clique em qualquer um dos indicadores para selecionar outra Release (ou execute Aggrega: Select Release… a partir da Command Palette). A alteração produz efeito imediatamente — nada é reiniciado, cada ficheiro YAML aberto é verificado de novo face à Release acabada de escolher, e o painel Catalog volta a ler a sua lista para ela; o mesmo acontece quando uma Release é adotada ao ligar-se o servidor de linguagem. A memorização é local à janela do editor: escolher não escreve nada no workspace. Se o foco estava no painel Commands quando o seletor abriu — na sua linha Release ou em qualquer um dos seus controlos —, regressa a esse controlo quando o seletor fecha, quer se tenha escolhido uma Release, quer se tenha descartado o seletor; aberto a partir de qualquer outro sítio, o seletor deixa o painel sem o foco.

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

As Releases oferecidas são as que se encontram dentro da pasta à qual o servidor de linguagem se ancorou, designadas relativamente a ela, porque é essa a forma que aceita. Onde uma Release não pode ser oferecida, o editor indica quantas são e onde se encontram, em vez de as omitir em silêncio. O servidor de linguagem não lê nenhuma Release através de uma ligação que saia dessa pasta, pelo que uma Release que a árvore de ficheiros do editor mostra através de uma ligação que sai dela — uma ligação para um diretório exterior, ou para um ficheiro de Release exterior — não é oferecida. A única exceção é uma ligação para um ficheiro de Release que a configuração do workspace indica, como build.authoring_release ou como chave de workspace.releases: essa Release é lida através da sua ligação e oferecida. Ao abrir, o seletor indica-o numa notificação própria, designando pelo seu caminho relativo a essa pasta cada ligação desse tipo que se encontre onde o servidor de linguagem de outro modo leria: primeiro as ligações para diretórios, depois as ligações para ficheiros. Uma ligação cujo nome termina em .yaml ou .yml é indicada seja qual for o conteúdo do ficheiro para onde leva, porque esse ficheiro não é lido para o descobrir.

Quando se pretende que uma escolha fique registada no próprio workspace — para que um checkout novo comece nela —, há dois comandos que o fazem, e nenhum deles altera aquilo em que se está a trabalhar neste momento:

  • Aggrega: Set the selected Release as this workspace’s default faz com que o servidor de linguagem escreva a Release atualmente selecionada em .aggrega/active-release. Esse ficheiro é local ao checkout, pelo que é o sítio certo para uma predefinição pessoal. Onde .aggrega ou o marcador é uma ligação que leva para fora do workspace Aggrega, nada é escrito, e a notificação traz as próprias palavras do compilador sobre o motivo.
  • Aggrega: Set authoring_release in .aggrega-config.yaml… abre o ficheiro de configuração para que se possa definir build.authoring_release. Essa definição é versionada e partilhada, e tem precedência sobre o ficheiro marcador. Onde o servidor de linguagem indica que o ficheiro de configuração é uma ligação que leva para fora do workspace Aggrega, o ficheiro não é aberto, e um erro indica que leva para fora do workspace, pelo que o Aggrega não o utiliza; o controlo da página de boas-vindas que cria uma configuração de workspace faz o mesmo com um ficheiro que já lá encontra.

Se o workspace não oferece nenhuma Release — nenhuma configurada, nenhum marcador e não exatamente um ficheiro a que recorrer —, o indicador di-lo, e diz qual de duas situações se verifica. Mostra Release: none selected onde há Releases entre as quais escolher e nenhuma está selecionada, e Release: none available onde o workspace Aggrega não ofereceu nenhuma. A segunda não é um estado que se resolva escolhendo, pelo que a sua dica indica as saídas — trabalhar noutro workspace Aggrega, ou criar uma Release — em vez de remeter para uma lista que só pode voltar vazia. Onde nada leu ainda o workspace, a dica di-lo em vez de apresentar uma contagem que ninguém fez. Cada uma dessas indicações refere o que foi procurado, e o relato completo é escrito no canal de saída do Aggrega. A validação continua a ser executada nesse estado: obtêm-se as constatações a que um documento responde por si só — se é analisado e se a sua própria forma é admissível — e as verificações que precisam de uma Release são ignoradas até que se selecione uma.