Instalar um SDK para um repositório com dotnetup

Note

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

Quando você não fornece um canal do SDK, dotnetup sdk install procura a partir do diretório atual até a raiz do sistema de arquivos. Ele usa o arquivo existente global.json mais próximo. Se esse arquivo estiver malformado, o comando falhará em vez de pesquisar um diretório pai. Se nenhum arquivo existir, ele usará latest.

Instalar a dependência do repositório

No diretório do repositório, execute:

dotnetup sdk install

Para este arquivo global.json, o dotnetup acompanha a faixa de recurso 10.0.1xx:

{
  "sdk": {
    "version": "10.0.103",
    "rollForward": "latestPatch"
  }
}

O global.json caminho é a origem do requisito armazenado. Você pode ver a origem e a versão instalada com:

dotnetup list

Entender o mapeamento roll-forward

Para uma versão do SDK, como 10.0.103, o dotnetup mapeia rollForward da seguinte maneira:

rollForward valor Canal dotnetup salvo
Omitido ou latestPatch 10.0.1xx
latestFeature 10.0
latestMinor 10
latestMajor latest
disable, patch, feature, minor ou major Versão exata 10.0.103

Um requisito exato é fixado e não é alterado por dotnetup update. A propriedade allowPrerelease não afeta o canal que o dotnetup deriva.

Utilize sdk.paths

Se global.json contiver sdk.paths, o dotnetup usará o primeiro caminho quando nenhuma --install-path opção estiver presente. Resolve um valor relativo do diretório que contém global.json.

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

  1. --install-path
  2. A primeira sdk.paths entrada
  3. A raiz padrão da instalação do .NET gerenciada pelo dotnetup

Limitações de pré-visualização

O build de visualização pública atual trata a primeira sdk.paths entrada como um caminho. Ele não interpreta $host$ como uma sentinela nem ignora entradas vazias. Para usar a raiz de instalação gerenciada por dotnetup padrão, omita sdk.paths ou defina --install-path explicitamente.

Atualização global.json

Depois de alterar sdk.version ou rollForward, executar dotnetup sdk install no diretório do repositório para aplicar o novo requisito. Antes que a coleta de lixo atualize as fontes global.json alteradas, dotnetup sdk update os processos armazenaram os requisitos, portanto, sua primeira passagem ainda pode usar o requisito anterior.

Para instalar a versão mais recente no canal derivado e gravar essa versão de volta em global.json, execute:

dotnetup sdk install --update-global-json

Posteriormente, atualize todos os requisitos rastreados do repositório e seus arquivos com:

dotnetup sdk update --update-global-json

A atualização muda apenas sdk.version. Ele preserva a formatação existente, outras propriedades e a codificação de texto detectada.

Remover requisitos de repositório correspondentes

O comando de desinstalação remove toda especificação correspondente globaljson na raiz de instalação selecionada. Ele não visa um repositório. Para remover os requisitos correspondentes da raiz padrão, execute:

dotnetup sdk uninstall 10.0.1xx --source globaljson

Para selecionar uma raiz de instalação personalizada, adicione --install-path:

dotnetup sdk uninstall 10.0.1xx --source globaljson --install-path <INSTALL_PATH>

dotnetup remove arquivos somente quando nenhum requisito restante precisa deles.

Consulte também

  • Última atualização em