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

Definições

A roda dentada no canto superior direito do painel Commands abre-as — é a própria página de definições do editor, restrita a esta extensão, e é a única superfície de definições que existe. Tudo o que se segue também está acessível a partir do editor Settings habitual e do ficheiro de definições.

A página de definições do próprio editor, filtrada para as definições da extensão Aggrega, cada uma sob o seu próprio título.

Cada uma destas definições pertence ao utilizador, não ao projeto. Cada uma descreve o ambiente ou os hábitos de leitura do próprio utilizador — onde está o binário, quanto esperar antes de revalidar, quantos reinícios tolerar, se devem ser mostrados valores que poderiam ser lidos por cima do ombro, como deve ser desenhado um painel —, pelo que cada uma está confinada às definições de utilizador, e às definições remotas quando se trabalha num anfitrião remoto ou em contentor. Esta última parte importa em particular para o caminho do binário: o compilador é executado no mesmo anfitrião que a extensão, pelo que o caminho pode diferir entre o portátil e um contentor, e cada anfitrião mantém o seu próprio valor.

A consequência é deliberada: um repositório não pode fixar nenhuma destas definições para quem o abrir. Escrever uma delas num .vscode/settings.json do workspace não tem efeito — o editor marca-a como não aplicável ali e continua a usar o valor do utilizador. Para que uma escolha fique registada no próprio workspace, os dois comandos de Release descritos em Selecionar uma Release são os que o fazem, e escrevem .aggrega/active-release ou .aggrega-config.yaml em vez de uma definição do editor.

DefiniçãoPredefiniçãoFinalidade
aggrega.getStarted.showtrueSe a página de boas-vindas abre no arranque. Três superfícies alteram esta única definição e mantêm-se sincronizadas: a caixa de verificação no rodapé da própria página, Aggrega: Stop opening the welcome page on startup e Aggrega: Get started. Desativá-la impede a página de abrir sem a remover; reativá-la com Aggrega: Get started também a abre.
aggrega.server.binaryPathaggregaCaminho para o binário aggrega. Um nome simples é procurado no PATH; um caminho que comece por ~/ (~\ no Windows) ou ${userHome} é lido a partir da pasta pessoal no anfitrião em que a extensão é executada; qualquer outro caminho é usado tal como está escrito.
aggrega.server.debounceMs300Janela de debounce para a validação proativa na alteração.
aggrega.server.respawnAttempts5Quantas vezes, dentro da janela abaixo, o servidor de linguagem é iniciado de novo depois de parar sem que tal lhe tenha sido pedido, antes de a extensão o deixar parado e gerar a notificação de que deixou de responder. Um servidor iniciado de novo que para antes de ter respondido conta da mesma forma que um que para durante a execução. Ver Ciclo de vida.
aggrega.server.respawnWindowSeconds180Janela deslizante, em segundos, durante a qual esses reinícios são contados.
aggrega.server.restartGraceSeconds5Janela de tolerância antes de a extensão reiniciar automaticamente o servidor de linguagem após uma alteração de binaryPath. A barra de estado mostra uma contagem decrescente; o menu de ações rápidas oferece Restart now e Cancel restart.
aggrega.server.buildOnInspectfalseExecuta a etapa de renderização de artefactos ao inspecionar um grafo, para que os avisos que aggrega build emite durante a renderização apareçam também como problemas no editor. Não acrescenta nenhuma das verificações em que um build é interrompido. Inspecionar custa mais quando é executada; nada é escrito em disco.
aggrega.graph.showSensitiveValuesfalseMostra no grafo de topologia os valores que uma Feature declara sensíveis, apresentando em claro uma credencial passada por valor; enquanto estiver ativada, o pedido do grafo solicita-os ao servidor de linguagem. Se ficar desativada, o servidor de linguagem retém-nos do grafo que envia, e são removidos de novo antes de o grafo ser desenhado.
aggrega.operations.layoutbuttonsComo o painel Commands desenha os seus grupos — buttons coloca todas as operações num único fluxo de botões com quebra de linha, sem nada desenhado entre um grupo e o seguinte, sections faz de cada grupo uma secção que se abre sob o seu próprio título. Os mesmos grupos, as mesmas operações, a mesma ordem em ambos os casos.
aggrega.notifications.toastDebounceModetimeCom que frequência o aviso de que uma Release não tem lockfile volta a ser mostrado para trabalho não pedido, como um grafo aberto redesenhado após guardar: time volta a mostrá-lo depois de passarem toastThrottleSeconds desde que o último foi fechado, session mostra-o uma vez até o servidor de linguagem reiniciar. Um Build, uma Preview ou um grafo aberto pelo utilizador que é recusado por falta de lockfile mostra sempre o aviso.
aggrega.notifications.toastThrottleSeconds300Segundos após o fecho do aviso de lockfile em falta antes de voltar a ser mostrado para trabalho não pedido. Lido apenas quando toastDebounceMode é time.