Requisitos del SDK del repositorio con dotnetup

Note

dotnetup está en versión preliminar pública. Sus características y comportamiento pueden cambiar antes de la disponibilidad general.

dotnetup usa global.json para asociar un requisito del SDK a un repositorio o árbol de directorios. Busca desde el directorio actual a través de cada directorio padre y lee el global.json existente más cercano.

Instalar desde global.json

Ejecute un comando de instalación del SDK sin un canal:

dotnetup install

Si el global.json más cercano tiene un sdk.version, dotnetup deriva una especificación de instalación de la versión y del valor de rollForward. Registra la ruta de acceso completa al archivo como origen de la especificación. Si no existe global.json en el directorio actual ni en sus directorios superiores, el comando usa el canal latest. Si el archivo más cercano tiene un formato incorrecto o contiene comentarios, se produce un error en el análisis. dotnetup no omite ese archivo para buscar directorios superiores ni usar el canal latest.

Asignación de rollForward

dotnetup asigna directivas global.json de selección del SDK con canales actualizables:

rollForward valor Se almacenó el requisito de dotnetup para el SDK 10.0.103
Omitido o latestPatch 10.0.1xx
latestFeature 10.0
latestMinor 10
latestMajor latest
disable, patch, feature, minor o major 10.0.103

Las correspondencias de versión exacta están ancladas y no se actualizan con una actualización. La propiedad allowPrerelease no afecta al canal del que deriva dotnetup.

Ruta de acceso de instalación desde global.json

Si sdk.paths contiene una entrada, dotnetup usa la primera ruta de acceso. Una ruta de acceso relativa se resuelve desde el directorio que contiene global.json.

En la compilación de versión preliminar pública actual, dotnetup trata la primera entrada como una ruta de acceso. No interpreta $host$ como centinela ni omite entradas vacías.

La prioridad de la ruta de instalación es:

  1. --install-path.
  2. La primera sdk.paths entrada en el global.json más cercano.
  3. Raíz de instalación de .NET administrada por dotnetup-managed predeterminada.

Mantener los archivos del repositorio actualizados

Pase --update-global-json para sustituir sdk.version por la versión concreta del SDK que se instaló o actualizó:

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

Solo las especificaciones del SDK procedentes de global.json se actualizan mediante el flujo de trabajo de actualización. El modificador conserva las demás propiedades JSON, formato y codificación de texto detectada.

Eliminar los requisitos del repositorio coincidente

Se actualiza una especificación rastreada global.json durante la recolección de elementos no utilizados. Si el archivo ya no existe o ya no contiene una versión del SDK, se quita la especificación.

Para quitar especificaciones por canal, seleccione la fuente globaljson. Este comando quita todas las especificaciones coincidentes en la raíz de instalación seleccionada, no solo las de un repositorio:

dotnetup sdk uninstall 10.0.1xx --source globaljson

Usa dotnetup list para buscar el canal almacenado, la ruta de acceso de origen y la raíz de instalación. Agregue --install-path para seleccionar una raíz personalizada.

Consulte también

  • Darrera actualització el