Requisitos do SDK do repositório com dotnetup

Note

dotnetup está em versão prévia pública. Seus recursos e comportamento podem mudar antes da disponibilidade geral.

dotnetup usa global.json para associar um requisito de SDK a um repositório ou árvore de diretório. Ele pesquisa no diretório atual, percorrendo cada diretório pai, e lê o global.json existente mais próximo.

Instalar a partir de global.json

Execute um comando de instalação do SDK sem um canal:

dotnetup install

Se o mais próximo global.json tiver um sdk.version, dotnetup deriva uma especificação de instalação da versão e do valor de rollForward. Ele registra o caminho completo para o arquivo como a origem da especificação. Se não existir nenhum global.json no diretório atual ou em seus diretórios pai, o comando usará o canal latest. Se o arquivo mais próximo estiver malformado ou contiver comentários, a análise falhará. dotnetup não ignora esse arquivo para pesquisar diretórios pai nem usar o canal latest.

mapeamento rollForward

dotnetup mapeia políticas de seleção do SDK global.json para canais atualizáveis:

rollForward valor Requisito de dotnetup armazenado para SDK 10.0.103
Omitido ou latestPatch 10.0.1xx
latestFeature 10.0
latestMinor 10
latestMajor latest
disable, patch, feature, minor ou major 10.0.103

Os mapeamentos de versão exata são fixados e não são atualizados por uma atualização. A propriedade allowPrerelease não afeta o canal que deriva de dotnetup.

Caminho de instalação do global.json

Se sdk.paths contiver uma entrada, dotnetup usará o primeiro caminho. Um caminho relativo é resolvido a partir do diretório que contém global.json.

No build de visualização pública atual, dotnetup trata a primeira entrada como um caminho. Ele não interpreta $host$ como uma sentinela nem ignora entradas vazias.

A precedência de caminho de instalação é:

  1. --install-path.
  2. A primeira entrada sdk.paths no global.json mais próximo.
  3. A raiz de instalação .NET gerenciada por dotnetup padrão.

Manter os arquivos do repositório atualizados

Passe --update-global-json para substituir sdk.version pela versão específica do SDK que foi instalada ou atualizada:

dotnetup install --update-global-json
dotnetup sdk update --update-global-json

Somente as especificações de SDK provenientes de global.json são atualizadas pelo fluxo de trabalho de atualização. O modificador preserva as outras propriedades JSON, a formatação e a codificação de texto detectada.

Remover requisitos de repositório correspondentes

Uma especificação rastreada global.json é atualizada durante a coleta de lixo. Se o arquivo não existir mais ou não contiver mais uma versão do SDK, a especificação será removida.

Para remover as especificações por canal, selecione a origem globaljson. Esse comando remove todas as especificações correspondentes na raiz da instalação selecionada, e não apenas de um repositório:

dotnetup sdk uninstall 10.0.1xx --source globaljson

Use dotnetup list para localizar o canal armazenado, o caminho de origem e a raiz de instalação. Adicione --install-path para selecionar uma raiz personalizada.

Consulte também

  • Última atualização em