Requisitos do SDK de repositório com dotnetup

Note

dotnetup está em pré-visualização pública. As suas funcionalidades 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órios. Pesquisa a partir do 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 global.json mais próximo tiver um sdk.version, dotnetup deriva uma especificação de instalação a partir da versão e do valor de rollForward. Regista o caminho completo até ao ficheiro como fonte da especificação. Se não global.json existir no diretório atual ou nos seus diretórios pais, o comando usa o latest canal. Se o ficheiro mais próximo estiver mal formado ou contiver comentários, a análise falha. dotnetup não ignora esse ficheiro ao pesquisar nos diretórios pai nem utiliza o canal latest.

mapeamento rollForward

dotnetup mapeamento de global.json políticas de seleção do SDK 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, minorou major 10.0.103

Os mapeamentos das versões exatas estão fixados e não são atualizados por uma atualização. A propriedade allowPrerelease não afeta o canal que o dotnetup obtém.

Caminho de instalação a partir de global.json

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

Na versão de pré-visualização pública atual, dotnetup trata a primeira entrada como um caminho. Não interpreta $host$ como sentinela nem salta entradas vazias.

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

  1. --install-path.
  2. A primeira entrada em sdk.paths na global.json mais próxima.
  3. A raiz padrão de instalação .NET gerida por dotnetup.

Mantenha os ficheiros do repositório atualizados

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

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

Apenas as especificações SDK de origem global.jsonsã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 detetada.

Remova requisitos de repositórios correspondentes

Uma especificação controlada global.json é atualizada durante a recolha de lixo. Se o ficheiro já não existir ou já não contiver uma versão SDK, a especificação é removida.

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

dotnetup sdk uninstall 10.0.1xx --source globaljson

Utilize dotnetup list para encontrar o canal armazenado, o caminho de origem e a raiz da instalação. Adicionar --install-path para selecionar uma raiz personalizada.

Ver também

  • Última atualização a