Comando settings (WinGet)

  • Artigo

O comando settings da ferramenta WinGet permite personalizar sua experiência de cliente do Gerenciador de Pacotes do Windows. É possível alterar os padrões e usar recursos experimentais habilitados para seu cliente.

O comando settings inicia o editor de texto padrão. Por padrão, o Windows inicia o Bloco de notas como uma opção. Recomendamos usar uma ferramenta como o Visual Studio Code.

Observação

É possível instalar com facilidade o Visual Studio Code digitando winget install Microsoft.VisualStudioCode

Aliases

Os aliases a seguir estão disponíveis para este comando:

  • config

Usar o comando de configurações de winget

Iniciar a ferramenta padrão de edição JSON: winget settings

Ao iniciar as configurações pela primeira vez, não haverá configurações específicas. Na parte superior do arquivo JSON, fornecemos um link em que é possível descobrir os recursos experimentais e as configurações mais recentes.

O snippet de código abaixo é um exemplo de como deve ser o arquivo de configurações se você quiser habilitar ou modificar alguns desses recursos e configurações experimentais.

{
    "$schema": "https://aka.ms/winget-settings.schema.json",

    // For documentation on these settings, see: https://aka.ms/winget-settings
    "experimentalFeatures": {
	  "dependencies": true,
	  "directMSI": false,
	  "zipInstall": false,
    },
    "visual": {
        "progressBar": "rainbow"
    },
    "source": {
        "autoUpdateIntervalInMinutes": 5
    },
}

Também definimos um esquema para executar o arquivo de configurações. Isso permite usar a tecla TAB para descobrir configurações e sintaxes caso o editor JSON seja compatível com esquemas JSON.

Observação

Os recursos experimentais só estão disponíveis em compilações de pré-visualização. Instruções para obter uma compilação de pré-visualização podem ser encontradas no repositório do GitHub.

Como atualizar as configurações

As configurações a seguir estão disponíveis no Gerenciador de Pacotes do Windows versão 1.0.

configurações de origem

As configurações de source incluem a configuração de origem do WinGet.

"source": {
    "autoUpdateIntervalInMinutes": 3
},

autoUpdateIntervalInMinutes

Um inteiro positivo representa o intervalo da atualização em minutos. A verificação de atualizações ocorre somente durante o uso de uma origem. Um zero vai desabilitar a verificação de atualizações em uma origem. Outros valores são inválidos.

  • Desabilitar: 0
  • Padrão: 5

Para atualizar a origem de modo manual, use winget source update.

configurações visuais

As configurações do visual incluem elementos visuais exibidos pelo WinGet

"visual": {
    "progressBar": "accent"
},

progressBar

A cor da barra de progresso que o WinGet exibe quando ela não é especificada por argumentos.

  • cor de destaque (padrão)
  • retrô
  • arco-íris

Configurações de installBehavior

As configurações de installBehavior afetam o comportamento padrão de instalação e atualização de pacotes (quando aplicável).

disableInstallNotes

O comportamento disableInstallNotes afeta se as notas de instalação são mostradas após uma instalação bem-sucedida. O padrão será false se o valor não for definido ou for inválido.

    "installBehavior": {
        "disableInstallNotes": true
    },

Configuração portablePackageUserRoot

A configuração portablePackageUserRoot afeta o diretório raiz padrão no qual os pacotes são instalados no escopo User. Essa configuração só se aplica a pacotes com o tipo de instalador portable. O padrão será %LOCALAPPDATA%/Microsoft/WinGet/Packages/ se o valor não for definido ou for inválido.

Observação: esse valor de configuração deve ser um caminho absoluto.

    "installBehavior": {
        "portablePackageUserRoot": "C:/Users/FooBar/Packages"
    },

Configuração portablePackageMachineRoot

A configuração portablePackageMachineRoot afeta o diretório raiz padrão no qual os pacotes são instalados no escopo Machine. Essa configuração só se aplica a pacotes com o tipo de instalador portable. O padrão será %PROGRAMFILES%/WinGet/Packages/ se o valor não for definido ou for inválido.

Observação: esse valor de configuração deve ser um caminho absoluto.

    "installBehavior": {
        "portablePackageMachineRoot": "C:/Program Files/Packages/Portable"
    },

configurações de preferências e requisitos

Algumas configurações estão duplicadas em preferences e requirements.

  • A configuração de preferences afeta de que modo que as diversas opções disponíveis são classificadas durante a escolha de uma delas. Por exemplo, o escopo padrão de instalação do pacote é voltado para o usuário atual. No entanto, caso essa não seja uma opção, um instalador de nível de computador será escolhido.
  • A configuração de requirements filtra as opções, resultando de maneira potencial em uma lista vazia e falha na instalação. No exemplo anterior, um requisito de escopo do usuário pode resultar em nenhum instalador aplicável, bem como em um erro.

Os argumentos passados na linha de comando substituirão de modo efetivo a configuração do requirement de correspondência durante esse comando.

scope

O comportamento do scope afeta a escolha entre instalar um pacote para o usuário atual ou para todo o computador. O parâmetro correspondente é --scope. Além disso, ele usa os mesmos valores (user ou machine). Confira problemas conhecidos relacionados ao escopo de instalação do pacote.

"installBehavior": {
    "preferences": {
        "scope": "user"
    }
},

localidade

O comportamento da locale afeta a escolha do instalador com base na localidade. O parâmetro correspondente é --locale. Além disso, ele usa a marca de idioma bcp47.

"installBehavior": {
    "preferences": {
        "locale": [ "en-US", "fr-FR" ]
    }
},

arquiteturas

O comportamento architectures afeta quais arquiteturas serão selecionadas ao instalar um pacote. O parâmetro correspondente é --architecture. Observe que somente arquiteturas compatíveis com seu sistema podem ser selecionadas.

    "installBehavior": {
        "preferences": {
            "architectures": ["x64", "arm64"]
        }
    },

installerTypes

O comportamento installerTypes afeta quais tipos de instalador serão selecionados ao instalar um pacote. O parâmetro correspondente é --installer-type.

    "installBehavior": {
        "preferences": {
            "installerTypes": ["msix", "msi"]
        }
    },

uninstallBehavior

As configurações de uninstallBehavior afetam o comportamento padrão de desinstalação de pacotes (quando aplicável).

purgePortablePackage

O comportamento purgePortablePackage afeta o comportamento padrão para desinstalar um pacote portátil. Se definido como true, a desinstalação removerá todos os arquivos e diretórios relevantes para o pacote portable. Essa configuração só se aplica a pacotes com o tipo de instalador portable. O padrão será false se o valor não for definido ou for inválido.

    "uninstallBehavior": {
        "purgePortablePackage": true
    },

downloadBehavior

As configurações downloadBehavior afetam o comportamento padrão de download de pacotes.

defaultDownloadDirectory

A configuração defaultDownloadDirectory afeta o diretório padrão para o qual os pacotes são baixados. O padrão será %USERPROFILE%/Downloads se o valor não for definido ou for inválido.

Observação: esse valor de configuração deve ser um caminho absoluto.

    "downloadBehavior": {
        "defaultDownloadDirectory": "C:/Users/FooBar/Downloads"
    },

configurações de telemetria

As configurações de telemetry controlam se o WinGet grava eventos ETW que poderão ser enviados à Microsoft em uma instalação padrão do Windows.

Confira detalhes sobre dados telemétricos e nossa principal política de privacidade.

disable

"telemetry": {
    "disable": true
},

Caso seja definido como true, a configuração telemetry.disable impedirá que eventos sejam gravados pelo programa.

configurações de rede

As configurações de network influenciam de que modo o WinGet usa a rede para recuperar pacotes e metadados.

downloader

A configuração do downloader controla qual código é usado durante o download de pacotes. O padrão é default, que pode ser uma das opções baseadas em nossa determinação.

O wininet usa APIs do wininet, enquanto o do usa o serviço de do.

"network": {
    "downloader": "do"
}

configurações de registro em log

As configurações logging controlam o nível de detalhes nos arquivos de log. --verbose-logs substituirá essa configuração e sempre criará um log detalhado.

"logging": {
    "level": "verbose"
}

nível

Os níveis de log a seguir estão disponíveis. O padrão será info se o valor não for definido ou for inválido.

  • verbose
  • informações
  • warning
  • error
  • Crítico

Como habilitar recursos experimentais

Para descobrir quais recursos experimentais estão disponíveis, acesse https://aka.ms/winget-settings. Nesse site, será possível conferir os recursos experimentais que estão disponíveis para você.