Instalación de .NET en macOS

En este artículo se explica qué versiones de .NET se admiten en macOS, cómo instalar .NET y cuál es la diferencia entre el SDK y el entorno de ejecución.

La versión más reciente de .NET es 10.

Versiones compatibles

En la tabla siguiente se enumeran las versiones de .NET admitidas y en qué macOS se admiten. Estas versiones siguen siendo compatibles hasta que la versión de .NET llega al final del soporte técnico o la versión de macOS ya no se admite.

Las siguientes versiones de .NET ya no se admiten ❌:

• .NET 7
• .NET 6
• .NET 5
• .NET Core 3.1
• .NET Core 3.0
• .NET Core 2.2
• .NET Core 2.1
• .NET Core 2.0

Entorno de ejecución o SDK

El runtime se usa para ejecutar aplicaciones creadas con .NET. Cuando un autor publica una aplicación, puede incluir el entorno de ejecución. Si no incluyen el entorno de ejecución, depende del usuario instalar el entorno de ejecución adecuado.

Hay dos entornos de ejecución que puede instalar en macOS y ambos se incluyen con el SDK.

• ASP.NET Core Runtime
  Ejecuta aplicaciones ASP.NET Core. Incluye el entorno de ejecución de .NET. No está disponible como instalador.

• .NET Runtime
  Esto ejecuta aplicaciones de .NET normales, pero no aplicaciones especializadas, como aplicaciones basadas en ASP.NET Core.

El SDK se usa para compilar y publicar aplicaciones y bibliotecas de .NET. El SDK más reciente admite la creación de aplicaciones para versiones anteriores de .NET. En circunstancias normales, solo necesitaría tener instalado el último SDK.

La instalación del SDK incluye tanto el runtime de .NET estándar como el entorno de ejecución de ASP.NET Core. Por ejemplo, si tiene instalado .NET SDK 9.0, .NET Runtime 9.0 y ASP.NET Core 9.0 Runtime están instalados. Sin embargo, cualquier otra versión del entorno de ejecución no se instalaría con el SDK y sería necesario instalarla por separado.

Elija cómo instalar .NET

Hay diferentes maneras de instalar .NET y algunos productos pueden administrar su propia versión de .NET. Si instala .NET a través de software que administra su propia versión de .NET, es posible que no esté habilitada en todo el sistema. Asegúrese de comprender las implicaciones de instalar .NET a través de otro software.

Si no está seguro de qué método debe elegir después de revisar las listas de las secciones siguientes, es probable que quiera usar el paquete del instalador de .NET.

Desarrolladores

• Visual Studio Code - Kit de desarrollo de C#

  Instale la extensión C# Dev Kit para Visual Studio Code para desarrollar aplicaciones .NET. La extensión puede usar un SDK ya instalado o instalar uno automáticamente.

Usuarios y desarrolladores

• Instalador de .NET

  Use el instalador independiente para instalar .NET. Este método es la manera habitual de instalar .NET en el equipo de desarrollador o usuario.

• Install .NET con un script

  Un script bash que puede automatizar la instalación del SDK o el entorno de ejecución. Puede elegir qué versión de .NET instalar.

• Install .NET manualmente

  Use este método de instalación cuando necesite instalar .NET en una carpeta específica y ejecútelo aparte de otras copias de .NET.

Instalar .NET

Los paquetes de instalador están disponibles para macOS, una manera sencilla de instalar .NET.

1. Abra un explorador y vaya a .

2. Seleccione el vínculo a la versión de .NET que desea instalar, como .NET 10.0.

   

   Este vínculo le lleva a la página con vínculos para descargar esa versión de .NET

   Si va a instalar el SDK, elija la versión más reciente .NET. El SDK admite la compilación de aplicaciones para versiones anteriores de .NET.

   Sugerencia

   Si no está seguro de qué versión descargar, elija la versión marcada como más reciente.

3. En esta página se presentan los vínculos de descarga para el SDK y el entorno de ejecución. Aquí descargará el SDK de .NET o .NET Runtime.

   

   Hay dos secciones resaltadas en la imagen anterior. Si va a descargar el SDK, consulte la sección 1. Para la .NET Runtime, consulte la sección 2.

   • Sección 1 (SDK)

     Esta sección es el área de descarga del SDK. En la columna Instaladores de la fila macOS, se muestran dos arquitecturas: Arm64 y x64.

     • Si ejecuta un procesador de Apple, como M1 o M3 Pro, seleccione Arm64.
     • Si utiliza un procesador Intel, seleccione x64.

   • Sección 2 (Tiempo de ejecución)

     Esta sección contiene las descargas del entorno de ejecución. Observe que los vínculos de la columna Instaladores de la fila macOS están vacíos. Esta sección está vacía porque el ASP.NET Core Runtime, solo se proporciona en el SDK o a través de la instalación binary.

     Desplácese más hacia abajo para encontrar el .NET Runtime estándar para su descarga.

     Una captura de pantalla que muestra solo la tabla de descarga de .NET Runtime desde el sitio web de .NET. La fila de macOS está resaltada con un cuadro rojo.

     • Si ejecuta un procesador de Apple, como M1 o M3 Pro, seleccione Arm64.
     • Si utiliza un procesador Intel, seleccione x64.

4. Una vez finalizada la descarga, abrirlo.

5. Siga los pasos que se describen en el Instalador.

   Una captura de pantalla que muestra solo el instalador de .NET en ejecución en macOS.

Instalación manual de .NET

Como alternativa a los instaladores de macOS, puede descargar e instalar manualmente el SDK y el entorno de ejecución. La instalación manual se suele llevar a cabo como parte de la automatización en un escenario de integración continua. Normalmente, los desarrolladores y los usuarios quieren usar el instalador.

1. Abra un explorador y vaya a .

2. Seleccione el vínculo a la versión de .NET que desea instalar, como .NET 8.0.

   Este vínculo le lleva a la página con vínculos para descargar esa versión de .NET

   Si va a instalar el SDK, elija la versión más reciente .NET. El SDK admite la compilación de aplicaciones para versiones anteriores de .NET.

   Sugerencia

   Si no está seguro de qué versión descargar, elija la versión marcada como más reciente.

   

3. Seleccione el vínculo al SDK o al entorno de ejecución que desee instalar. Busque la columna Binarios en la fila de macOS.

   

   • Si ejecuta un procesador de Apple, como M1 o M3 Pro, seleccione Arm64.
   • Si utiliza un procesador Intel, seleccione x64.

4. Abra un terminal y vaya a donde se descargó el archivo binario .NET.

5. Extraiga el tarball al directorio donde desea instalar .NET en su sistema. En el ejemplo siguiente se usa el directorio HOME.

   mkdir -p ~/Applications/.dotnet
   tar -xf "dotnet-sdk-9.0.100-rc.2.24474.11-osx-arm64.tar" -C ~/Applications/.dotnet/
   

Pruebe que .NET funciona cambiando el directorio a donde se instaló .NET y ejecute el comando dotnet --info:

chdir ~/Applications/.dotnet/
./dotnet --info

Instalación de .NET con un script

Los scripts dotnet-install se usan para la automatización y las instalaciones no elevadas del entorno de ejecución. Puede descargar el script de .

El script tiene como valor predeterminado instalar la versión más reciente de soporte a largo plazo (LTS), que es .NET 8. Puede elegir una versión específica especificando el interruptor. Incluya el conmutador para instalar un entorno de ejecución. De lo contrario, el script instala el SDK.

1. Abre un terminal.

2. Vaya a una carpeta donde quiera descargar el script, por ejemplo ~/Descargas.

3. Si no tiene el comando , instálelo con Brew

   brew install wget
   

4. Ejecute el comando siguiente para descargar el script.

   wget https://dot.net/v1/dotnet-install.sh
   

5. Conceda permisos de ejecución al script.

   chmod +x dotnet-install.sh
   

6. Ejecute el script para instalar .NET.

   El script tiene como valor predeterminado instalar el SDK más reciente en el directorio .

   ./dotnet-install.sh
   

Aquí están todos los comandos como un único script bash:

chdir ~/Downloads
brew install wget
wget https://dot.net/v1/dotnet-install.sh
chmod +x dotnet-install.sh
./dotnet-install.sh

Para probar .NET, vaya a la carpeta ~/.dotnet y ejecute el comando dotnet --info:

chdir ~/.dotnet
./dotnet --info

Instalación de .NET para Visual Studio Code

Visual Studio Code es un editor de código fuente eficaz y ligero que se ejecuta en el escritorio. Visual Studio Code puede usar el SDK ya instalado en el sistema. Además, la extensión C# Dev Kit instalará .NET automáticamente si aún no está instalado.

Para obtener instrucciones sobre cómo instalar .NET a través de Visual Studio Code, consulte Introducción a C# en VS Code.

Autenticación bajo notario

El software desarrollado para macOS que se distribuye con un ID de Desarrollador debe estar notarizado, incluidas las aplicaciones realizadas con .NET.

Si ejecuta una aplicación sin estar certificada ante notario, verá una ventana de error similar a la imagen siguiente:

Alerta de certificación de macOS Catalina

Para obtener más información sobre cómo afecta la notarización aplicada a .NET (y a sus aplicaciones .NET), consulte Trabajando con la Notarización de macOS Catalina.

Validación

Después de descargar un instalador o una versión binaria, compruébelo para asegurarse de que el archivo no se ha modificado ni dañado. Puede verificar la suma de comprobación en el equipo y, a continuación, compararla con lo notificado en el sitio web de descarga.

Al descargar un archivo desde una página de descarga oficial, la suma de comprobación del archivo se muestra en un cuadro de texto. Seleccione el botón Copiar para copiar el valor de la suma de comprobación al portapapeles.

Use el comando para imprimir la suma de comprobación del archivo que ha descargado. Por ejemplo, el siguiente comando notifica la suma de comprobación del archivo dotnet-sdk-9.0.306-osx-x64.tar.gz :

$ shasum -a 512 dotnet-sdk-9.0.306-osx-x64.tar.gz
a9700f98e5aa4f70b2a08ddba2b1c6085106b0d17828bd719fdcef460b06c890b32d752fbff8e4659cd1ca4174b4b211b301fe682439ea9a24b6521ca5a64c69  dotnet-sdk-9.0.306-osx-x64.tar.gz

Compare la suma de comprobación con el valor proporcionado por el sitio de descarga.

Utiliza un archivo de suma de comprobación para validar

Las notas de la versión de .NET incluyen un enlace a un archivo de suma de verificación que puede usar para validar el archivo que ha descargado. En los pasos siguientes se describe cómo descargar el archivo de suma de comprobación y validar un archivo binario de instalación de .NET:

1. La página de notas de la versión de .NET 9 en GitHub en https://github.com/dotnet/core/tree/main/release-notes/9.0#releases contiene una sección denominada Releases. La tabla de esa sección se vincula a los archivos de descargas y suma de comprobación de cada versión de .NET 9. En la imagen siguiente se muestra la tabla de versión .NET 8 como referencia:

   La tabla de versiones de las notas de lanzamientos de GitHub para .NET

2. Seleccione el vínculo de la versión de .NET que descargó.

   En la sección anterior se usó .NET SDK 9.0.306, que se encuentra en la versión de .NET 9.0.10.

3. En la página de versión, puede ver la versión de .NET Runtime y .NET SDK y un vínculo al archivo de suma de comprobación. En la imagen siguiente se muestra la tabla de versión .NET 8 como referencia:

   

4. Haga clic con el botón derecho en el vínculo Suma de comprobación y cópielo al portapapeles.

5. Abre un terminal.

6. Use para descargar el archivo de suma de comprobación.

   Reemplace el vínculo del siguiente comando por el vínculo que ha copiado.

   curl -O https://builds.dotnet.microsoft.com/dotnet/checksums/9.0.10-sha.txt
   

7. Con el archivo de suma de comprobación y el archivo de versión de .NET descargado en el mismo directorio, use el comando shasum -a 512 -c {file} para validar el archivo descargado.

   Cuando se supera la validación, verá que el archivo se imprime con el estado Aceptado:

   $ shasum -a 512 -c 9.0.10-sha.txt
   dotnet-sdk-9.0.306-osx-x64.tar.gz: OK
   

   Si ve el archivo marcado como Fallado, el archivo que descargó no es válido y no debe usarse.

   $ shasum -a 512 -c 9.0.10-sha.txt
   dotnet-sdk-9.0.306-osx-x64.tar.gz: FAILED
   shasum: WARNING: 1 computed checksum did NOT match
   

Macs con arquitectura Arm

En las secciones siguientes se describen las cosas que debe tener en cuenta al instalar .NET en un equipo Mac basado en Arm.

Diferencias de ruta

En un Equipo Mac basado en Arm, todas las versiones de Arm64 de .NET se instalan en la carpeta normal /usr/local/share/do tnet/. Sin embargo, al instalar la versión x64 del SDK de .NET, se instala en la carpeta /usr/local/share/do tnet/x64/do tnet/.

Variables de ruta

Las variables de entorno que agregan .NET a la ruta de acceso del sistema, como la variable PATH, pueden tener que cambiarse si tiene instaladas las versiones x64 y Arm64 del SDK de .NET. Además, algunas herramientas se basan en la variable de entorno DOTNET_ROOT, que también tendría que actualizarse para que apunte a la carpeta de instalación del SDK de .NET adecuada.

Solución de problemas

Las secciones siguientes están disponibles para ayudar a solucionar problemas:

• Equipos Mac basados en Arm
• Make .NET disponible en todo el sistema

Hacer que .NET estén disponibles en todo el sistema

A veces, las aplicaciones del sistema, incluido el terminal, deben encontrar dónde está instalado .NET. El paquete del instalador de .NET macOS debe configurar automáticamente el sistema. Sin embargo, si usó el método de instalación manual o el script de instalación de .NET, debe agregar el directorio donde se instaló .NET a la variable PATH.

Es posible que algunas aplicaciones busquen la variable DOTNET_ROOT al intentar determinar dónde está instalado .NET.

Hay muchos shells diferentes disponibles para MacOS y cada uno tiene un perfil diferente. Por ejemplo:

• Shell de Bash: ~/.profile, /etc/profile
• Korn Shell: ~/.kshrc o .profile
• Shell de Z: ~/.zshrc o .zprofile

Establezca las dos variables de entorno siguientes en el perfil de shell:

• DOTNET_ROOT

  Esta variable se establece en la carpeta donde se instaló .NET, como $HOME/.dotnet:

  export DOTNET_ROOT=$HOME/.dotnet
  

• PATH

  Esta variable debe incluir la carpeta y la carpeta :

  export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
  

Contenido relacionado

• Cómo comprobar si .NET ya está instalado.
• Trabajo con la certificación de macOS Catalina.
• Tutorial: cree una aplicación de consola de .NET.
• Tutorial: contenedorice una aplicación de .NET.