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.

dotnetupes 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

• 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 su 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.

Ejecuta la configuración inicial

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 Channel	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 menor	10.0	SDK más reciente para la versión principal y secundaria especificada
Cinta de funciones	10.0.1xx	SDK más reciente de la banda de funcionalidades 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 dotnetup channels and versions.

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 una nueva terminal después de que la instalación cambie su 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.