Instale um SDK para um repositório com dotnetup

Quando não indica um canal SDK, dotnetup sdk install pesquisa a partir do diretório atual em direção à raiz do sistema de ficheiros. Utiliza o ficheiro existente global.json mais próximo. Se esse ficheiro estiver malformado, o comando falha em vez de procurar um diretório pai. Se não existir ficheiro, utiliza latest.

Instalar a dependência do repositório

A partir do diretório do repositório, execute:

dotnetup sdk install

Para este global.json ficheiro, o dotnetup acompanha a 10.0.1xx banda de características:

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

O caminho global.json é a origem do requisito armazenado. Pode ver a versão fonte e instalada com:

dotnetup list

Compreender o mapeamento de roll-forward

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

Um requisito exato é afixado e não é alterado por dotnetup update. A propriedade allowPrerelease não afeta o canal que o dotnetup obtém.

Utilize sdk.paths

Se global.json contém sdk.paths, o dotnetup usa o primeiro caminho quando a opção --install-path não está presente. Resolve-se 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 predefinida da instalação .NET gerida pelo dotnetup

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

A versão de pré-visualização pública atual trata a primeira sdk.paths entrada como um caminho. Não interpreta $host$ como sentinela nem salta entradas vazias. Para usar a raiz de instalação predefinida dotnetup-managed, omitir sdk.paths ou definir --install-path explicitamente.

Atualização global.json

Depois de alterar sdk.version ou rollForward, execute dotnetup sdk install a partir do diretório do repositório para aplicar o novo requisito. Antes de a recolha de lixo atualizar as fontes alteradas global.json, dotnetup sdk update armazenou os requisitos, pelo que a sua primeira passagem pode ainda usar o requisito anterior.

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

dotnetup sdk install --update-global-json

Mais tarde, atualize todos os requisitos dos repositórios rastreados e os seus ficheiros com:

dotnetup sdk update --update-global-json

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

Remover os requisitos de repositório correspondentes

O comando de desinstalação remove todas as especificações globaljson correspondentes na raiz de instalação selecionada. Não tem como alvo um único repositório. Para remover requisitos de correspondência 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 os ficheiros apenas quando nenhum requisito restante precisar deles.

Ver também

• Integração de repositório e global.json
• dotnetup sdk install
• Atualizar as instalações monitorizadas