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

Configurações

A engrenagem no canto superior direito do painel Commands as abre — é a própria página de configurações do editor, restrita a esta extensão, e é a única superfície de configurações que existe. Tudo abaixo também pode ser acessado pelo editor Settings comum e pelo seu arquivo de configurações.

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

Cada uma dessas configurações é sua, não do projeto. Cada uma descreve o seu próprio ambiente ou os seus próprios hábitos de leitura — onde está o seu binário, quanto esperar antes de revalidar, quantas reinicializações tolerar, se deve mostrar valores que poderiam ser lidos por cima do seu ombro, como você quer que um painel seja desenhado —, então cada uma fica restrita às suas configurações de usuário, e às suas configurações remotas quando você trabalha em um host remoto ou em contêiner. Esta última parte importa em especial para o caminho do binário: o compilador é executado no mesmo host que a extensão, então o caminho pode diferir entre o seu notebook e um contêiner, e cada host mantém o próprio valor.

A consequência é intencional: um repositório não pode fixar nenhuma destas configurações para quem o abrir. Gravar uma delas em um .vscode/settings.json do workspace não tem efeito — o editor a marca como não aplicável ali e continua usando o seu valor. Se você quer que uma escolha fique registrada no próprio workspace, os dois comandos de Release em Como selecionar uma Release são os que fazem isso, e gravam .aggrega/active-release ou .aggrega-config.yaml em vez de uma configuração do editor.

ConfiguraçãoPadrãoFinalidade
aggrega.getStarted.showtrueSe a página de boas-vindas abre na inicialização. Três superfícies alteram essa única configuração e permanecem em sincronia: a caixa de seleção no rodapé da própria página, Aggrega: Stop opening the welcome page on startup e Aggrega: Get started. Desativá-la impede que a página abra sem removê-la; 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 começa com ~/ (~\ no Windows) ou ${userHome} é lido da sua pasta pessoal no host em que a extensão é executada; qualquer outro caminho é usado como está escrito.
aggrega.server.debounceMs300Janela de debounce para a validação proativa ao alterar.
aggrega.server.respawnAttempts5Quantas vezes, dentro da janela abaixo, o servidor de linguagem é iniciado de novo depois de parar sem que isso tenha sido pedido, antes que a extensão o deixe parado e gere a notificação de que parou 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. Veja Ciclo de vida.
aggrega.server.respawnWindowSeconds180Janela deslizante, em segundos, na qual essas reinicializações são contadas.
aggrega.server.restartGraceSeconds5Janela de carência antes de a extensão reiniciar automaticamente o servidor de linguagem após uma alteração de binaryPath. A barra de status mostra uma contagem regressiva; o menu de ações rápidas oferece Restart now e Cancel restart.
aggrega.server.buildOnInspectfalseExecuta a etapa de renderização de artefatos ao inspecionar um grafo, para que os avisos que aggrega build emite durante a renderização também apareçam como problemas no editor. Não adiciona nenhuma das verificações em que um build é interrompido. Inspecionar custa mais quando ela é executada; nada é gravado em disco.
aggrega.graph.showSensitiveValuesfalseMostra no grafo de topologia os valores que uma Feature declara sensíveis, exibindo em texto claro uma credencial passada por valor; enquanto estiver ativada, a requisição do grafo os pede ao servidor de linguagem. Se ficar desativada, o servidor de linguagem os retém do grafo que envia, e eles são removidos de novo antes de o grafo ser desenhado.
aggrega.operations.layoutbuttonsComo o painel Commands desenha seus grupos — buttons coloca todas as operações em um único fluxo de botões com quebra de linha, sem nada desenhado entre um grupo e o seguinte, sections transforma cada grupo em uma seção que você abre sob o próprio título. Mesmos grupos, mesmas operações, mesma ordem em ambos os casos.
aggrega.notifications.toastDebounceModetimeCom que frequência o aviso de que uma Release não tem lockfile é mostrado de novo para um trabalho que você não pediu, como um grafo aberto redesenhado após salvar: time o mostra de novo depois que toastThrottleSeconds tiverem passado desde que o último foi fechado, session o mostra uma vez até o servidor de linguagem reiniciar. Um Build, uma Preview ou um grafo que você abre e que é recusado por falta de lockfile sempre mostra o aviso.
aggrega.notifications.toastThrottleSeconds300Segundos após o fechamento do aviso de lockfile ausente antes que ele seja mostrado de novo para um trabalho que você não pediu. Lido apenas quando toastDebounceMode é time.