Primeros pasos con dotnetup

Note

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

dotnetup es un gestor de cadenas de herramientas multiplataforma para instalaciones de .NET de nivel de usuario. Instala, actualiza y quita .NET SDK y entornos de ejecución sin usar un administrador de paquetes del sistema.

Prerequisites

• Uno de los siguientes sistemas operativos y arquitecturas:

  Sistema operativo	Architectures
  Windows	x64, Arm64
  macOS	x64, Arm64
  Linux (glibc)	x64, Arm64
  Linux (musl), como Alpine Linux	x64, Arm64

• Un terminal.

• Bash en macOS o Linux, o PowerShell en Windows, para ejecutar el script de descarga.

• En macOS o Linux, curl o wget para descargar archivos, y sha512sum o shasum para comprobarlos.

dotnetuptiene los mismos requisitos del sistema operativo que el entorno de ejecución de .NET. Para conocer los requisitos específicos del sistema operativo, consulte Instalación de .NET en Windows, Instalación de .NET en macOS o Instalación de .NET en Linux.

Importante

En Windows, la configuración predeterminada usa el everywhere modo de acceso. Este modo:

• Requiere elevación para actualizar el sistema PATH.
• Hace que la instalación administrada por dotnetup tenga prioridad sobre las instalaciones de .NET de toda la máquina, como las que Visual Studio instala. Los proyectos y aplicaciones que necesitan un SDK o un entorno de ejecución para toda la máquina que no esté también instalado por dotnetup no se pueden compilar ni ejecutar.
• Cambia el sistema PATH, que se aplica a todos los usuarios. Los procesos elevados que otros usuarios inician pueden resolver .NET desde el perfil de usuario.

Para evitar estos efectos, elija el modo de acceso shell o none durante la instalación. Si elige everywhere, migre las instalaciones existentes cuando el programa de instalación lo ofrezca. Para obtener más información, consulte Consideraciones sobre el modo En todas partes.

Descargar dotnetup

Los scripts de descarga instalan la compilación más reciente preview de forma predeterminada. Comprueban el archivo ejecutable descargado con su suma de comprobación SHA-512 e instalan en ~/.dotnetup.

En macOS o Linux, ejecute:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh | bash

En Windows, ejecute:

irm https://aka.ms/dotnetup/get-dotnetup.ps1 | iex

Para instalar la compilación más reciente daily en macOS o Linux, ejecute:

curl -fsSL https://aka.ms/dotnetup/get-dotnetup.sh |
  bash -s -- --quality daily

Para instalar la compilación más reciente daily en Windows, ejecute:

iex "& { $(irm https://aka.ms/dotnetup/get-dotnetup.ps1) } -Quality daily"

Importante

Las compilaciones diarias no han completado la validación de la versión y no están firmadas digitalmente. Utilice compilaciones diarias solo para pruebas de corta duración.

Los scripts imprimen instrucciones para agregar dotnetup a PATH. Abra un nuevo terminal después de aplicar las instrucciones.

Ejecutar la configuración por primera vez

Ejecute la configuración interactiva:

> dotnetup init
Welcome to dotnetup!

SDK Channel: latest
Mode: <recommended-mode> (Suggested)

<recommended-mode> modifies <configuration-target> to set PATH and DOTNET_ROOT to prefer <install-path>.

Would you like to install .NET with the recommended settings?
> Yes, proceed with defaults and install

Installing SDK <resolved-version> to <install-path>...
<download and installation progress>
Installed at <install-path>:
  SDK <resolved-version>
<mode-specific environment guidance>
Setup complete!

Las rutas de acceso, la visualización del progreso y la guía del entorno dependen del sistema y del modo seleccionado.

El modo de acceso recomendado es everywhere en Windows. En macOS y Linux, es shell cuando dotnetup detecta un shell compatible y none de lo contrario.

Seleccione No, personalice la configuración para elegir el canal del SDK, el modo de acceso y las opciones de migración.

Elige un canal del SDK

Un canal del SDK indica dotnetup qué SDK se va a instalar y cómo actualizarlo.

Formulario de canal	Example	Result
Última versión estable	latest	SDK estable activo más reciente
LTS más reciente	lts	SDK de LTS estable activa más reciente
Vista previa más reciente	preview	SDK de versión preliminar más reciente
Último diario	daily	SDK diario más reciente disponible
Mayor	10	SDK más reciente para la versión principal especificada
Principal y secundario	10.0	SDK más reciente para la versión principal y secundaria especificada
Banda de opciones	10.0.1xx	SDK más reciente de la banda de funciones especificada
Versión exacta	10.0.103	Solo la versión del SDK especificada
Sin SDK inicial	none	Omitir la instalación durante la configuración

Las versiones exactas no avanzan durante las actualizaciones. Para todos los formatos aceptados, consulte canales y versiones de dotnetup.

Elegir cómo acceder a .NET

El modo de acceso controla cómo los terminales y las aplicaciones encuentran la instalación de .NET administrada por dotnetup.

Modo de acceso	Behavior
none	No modifica estas variables de entorno. Ejecute .NET con dotnetup dotnet.
shell	Modifica el perfil de shell para establecer estas variables de entorno. Los procesos iniciados desde ese shell usan los SDK y los entornos de ejecución de .NET instalados por dotnetup.
everywhere	Modifica el sistema PATH y establece la variable de entorno DOTNET_ROOT de nivel de usuario. Solo está disponible en Windows.

Para obtener más detalles y consideraciones del modo everywhere, consulte configuración del entorno dotnetup.

Migrar instalaciones existentes

El programa de instalación puede ofrecer la migración de instalaciones existentes de .NET SDK y runtime en toda la máquina a la instalación administrada por dotnetup. Consulte Consideraciones sobre el modo En cualquier lugar para saber por qué la migración es especialmente importante con el modo everywhere.

Comprobación de la configuración

Abra un nuevo terminal después de que la instalación cambie el entorno.

Para el modo shell o everywhere, ejecute:

dotnet --version
dotnetup list

Para el modo none, ejecute:

dotnetup dotnet -- --version
dotnetup list

Vuelva a ejecutar dotnetup init para cambiar la configuración.

Mantén dotnetup actualizado

Para actualizar la propia herramienta, ejecute dotnetup self update. Para compilaciones diarias, use dotnetup self update --channel daily. Estos comandos no actualizan los SDK administrados por el sistema ni los entornos de ejecución. Para ver las opciones y la recuperación de versiones anteriores, consulte Actualizar o quitar dotnetup.