Instalación de un SDK para un repositorio con dotnetup

Note

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

Cuando no se proporciona un canal del SDK, dotnetup sdk install busca desde el directorio actual hacia la raíz del sistema de archivos. Usa el archivo existente global.json más cercano. Si ese archivo tiene un formato incorrecto, se produce un error en el comando en lugar de buscar en un directorio padre. Si no existe ningún archivo, usa latest.

Instale la dependencia del repositorio

En el directorio del repositorio, ejecute:

dotnetup sdk install

Para este archivo global.json, dotnetup realiza un seguimiento del grupo de características 10.0.1xx:

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

La global.json ruta de acceso es el origen del requisito almacenado. Puede ver la versión de origen e instalada con:

dotnetup list

Comprender el mapeo de avance

Para una versión del SDK como 10.0.103, dotnetup asigna rollForward de la siguiente manera:

rollForward valor Canal almacenado de dotnetup
Omitido o latestPatch 10.0.1xx
latestFeature 10.0
latestMinor 10
latestMajor latest
disable, patch, feature, minor o major Versión exacta 10.0.103

Un requisito exacto está anclado y dotnetup update no lo cambia. La propiedad allowPrerelease no afecta al canal del que deriva dotnetup.

Utilice sdk.paths

Si global.json contiene sdk.paths, dotnetup usa la primera ruta de acceso cuando no hay ninguna --install-path opción presente. Resuelve un valor relativo a partir del directorio que contiene global.json.

La prioridad de install-path es:

  1. --install-path
  2. Primera sdk.paths entrada
  3. Raíz de instalación de .NET administrada por dotnetup predeterminada

Limitaciones de la versión preliminar

La compilación de versión preliminar pública actual trata la primera sdk.paths entrada como una ruta de acceso. No interpreta $host$ como centinela ni omite entradas vacías. Para usar la raíz de instalación administrada por dotnetup predeterminada, omita sdk.paths o establezca --install-path explícitamente.

Actualización global.json

Después de cambiar sdk.version o rollForward, ejecute dotnetup sdk install desde el directorio del repositorio para aplicar el nuevo requisito. Antes de que la recolección de elementos no utilizados actualice los orígenes modificados global.json , dotnetup sdk update procesa los requisitos almacenados, por lo que su primer paso podría seguir usando el requisito anterior.

Para instalar la versión más reciente en el canal derivado y volver a escribir esa versión en global.json, ejecute:

dotnetup sdk install --update-global-json

Más adelante, actualice todos los requisitos de los repositorios rastreados y sus archivos con:

dotnetup sdk update --update-global-json

La actualización solo cambia sdk.version. Conserva el formato existente, otras propiedades y la codificación de texto detectada.

Eliminar los requisitos del repositorio coincidente

El comando uninstall quita todas las especificaciones globaljson coincidentes de la raíz de instalación seleccionada. No apunta a un repositorio. Para quitar los requisitos coincidentes de la raíz predeterminada, ejecute:

dotnetup sdk uninstall 10.0.1xx --source globaljson

Para seleccionar una raíz de instalación personalizada, agregue --install-path:

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

dotnetup quita los archivos solo cuando no los necesita ningún requisito restante.

Consulte también

  • Se actualizó por última vez el