En este artículo se explica qué versiones de .NET son compatibles con macOS, cómo instalar .NET y cuál es la diferencia entre el SDK y el entorno de ejecución.
En la tabla siguiente se enumeran las versiones de .NET compatibles y en qué macOS son compatibles. Estas versiones siguen siendo compatibles hasta que la versión de .NET llegue al final del soporte técnico o que la versión de macOS ya no sea compatible.
Versión de macOS
.NET
macOS 15 "Sequoia"
9.0, 8.0
macOS 14 "Sonoma"
9.0, 8.0
macOS 13 "Ventura"
9.0, 8.0
Las versiones siguientes 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 entorno de ejecución se usa para ejecutar aplicaciones creadas con .NET. Cuando un autor publica una aplicación, puede incluir el entorno de ejecución. Si no lo hace, el usuario elige si quiere instalar el entorno de ejecución correcto.
Hay dos entornos de ejecución que puede instalar en macOS y ambos se incluyen con el SDK.
ASP.NET Core Runtime
Ejecuta aplicaciones de ASP.NET Core. Incluye el entorno de ejecución de .NET. No está disponible como instalador.
Runtime de .NET
Esto ejecuta aplicaciones .NET normales, pero no aplicaciones especializadas, como las aplicaciones compiladas en ASP.NET Core.
El SDK se usa para compilar y publicar aplicaciones y bibliotecas de .NET. El SDK más reciente admite la compilació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 entorno de ejecución estándar de .NET como el entorno de ejecución ASP.NET Core. Por ejemplo, si tiene instalado el SDK de .NET 9.0, se instalan .NET Runtime 9.0 y ASP.NET Core 9.0 Runtime. 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.
Cómo elegir la instalación de .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 un software que administra su propia versión de .NET, es posible que no esté habilitado 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 desee utilizar el paquete .NET Installer.
Instale la extensión kit de desarrollo de C# para Visual Studio Code para desarrollar aplicaciones .NET. La extensión puede usar un SDK ya instalado o instalar uno automáticamente.
Seleccione el vínculo a la versión de .NET que desea instalar, como .NET 8.0.
Este vínculo le dirige a la página con vínculos para descargar esa versión de .NET.
Si va a instalar el SDK, elija la versión de .NET más reciente. 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.
En esta página se presentan los vínculos de descarga para el SDK y el entorno de ejecución. Aquí puede descargar el SDK de .NET o el entorno de ejecución de .NET.
Hay dos secciones resaltadas en la imagen anterior. Si va a descargar el SDK, consulte la sección 1. Para el entorno de ejecución de .NET, 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 (Entorno 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 Entorno de ejecución de ASP.NET Core solo se proporciona en el SDK o a través de la instalación binaria.
Desplácese más abajo para encontrar el Entorno de ejecución de .NET estándar para descargarlo.
Si ejecuta un procesador de Apple, como M1 o M3 Pro, seleccione Arm64.
Si utiliza un procesador Intel, seleccione x64.
Una vez finalizada la descarga, ábrala.
Siga los pasos que se describen en el Instalador.
Instalar .NET manualmente
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 durante la automatización en una situación de integración continua. Normalmente, los desarrolladores y los usuarios quieren usar el instalador.
Sugerencia
Use el script install-dotnet.sh para realizar estos pasos automáticamente.
Seleccione el vínculo a la versión de .NET que desea instalar, como .NET 8.0.
Este vínculo le dirige a la página con vínculos para descargar esa versión de .NET.
Si va a instalar el SDK, elija la versión de .NET más reciente. 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.
Seleccione el vínculo al SDK o al entorno de ejecución que desee instalar. Busque la columna Binarios de la fila macOS.
Si ejecuta un procesador de Apple, como M1 o M3 Pro, seleccione Arm64.
Si utiliza un procesador Intel, seleccione x64.
Abra un terminal y navegue hasta el lugar donde se descargó el archivo binario .NET.
Extraiga el archivo tarball en el lugar del sistema donde desee instalar .NET. En el ejemplo siguiente se usa el directorio HOME~/Applications/.dotnet.
mkdir -p ~/Applications/.dotnet
tar -xf "dotnet-sdk-9.0.100-rc.2.24474.11-osx-arm64.tar" -C ~/Applications/.dotnet/
Compruebe que .NET funcione cambiando el directorio donde se instaló .NET y ejecute el comando dotnet --info:
El valor predeterminado del script es instalar la versión más reciente de soporte técnico a largo plazo (LTS), que actualmente es .NET 8. Puede elegir una versión concreta especificando el modificador channel. Incluya el modificador runtime para instalar un entorno de ejecución. De lo contrario, el script instala el SDK.
Sugerencia
Estos comandos se proporcionan en un fragmento de código de script al final de este procedimiento.
Abre un terminal.
Vaya a una carpeta donde quiera descargar el script, por ejemplo ~/Descargas.
Si no tiene el comando wget, instálelo con Brew
brew install wget
Ejecute el comando siguiente para descargar el script.
wget https://dot.net/v1/dotnet-install.sh
Conceda permisos de ejecución al script.
chmod +x dotnet-install.sh
Ejecute el script para instalar .NET.
El script tiene como valor predeterminado instalar el SDK más reciente en el directorio ~/.dotnet.
./dotnet-install.sh
Aquí están todos los comandos como un único script bash:
Para probar .NET, vaya a la carpeta ~/.dotnet y ejecute el comando dotnet --info:
chdir ~/.dotnet
./dotnet --info
Importante
Algunos programas pueden usar variables de entorno para buscar .NET en el sistema y es posible que el comando dotnet no funcione al abrir un nuevo terminal. Para obtener ayuda para resolver este problema, consulte la sección Hacer que .NET esté disponible en todo el sistema.
Instalar .NET para Visual Studio Code
Visual Studio Code es un editor de código fuente ligero y eficaz que se ejecuta en el escritorio. Visual Studio Code puede usar el SDK que ya está instalado en el sistema. Además, la extensión del Kit de desarrollo de C# 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 creado para macOS que se distribuye con un ID de desarrollador debe estar certificado ante notario, incluidas las aplicaciones creadas con .NET.
Si ejecuta una aplicación sin estar certificada ante notario, verá una ventana de error similar a la imagen siguiente:
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 sha512sum 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-8.0.100-linux-x64.tar.gz:
Compare la suma de comprobación con el valor proporcionado por el sitio de descarga.
Importante
Aunque se muestra un archivo linux en estos ejemplos, esta información se aplica igualmente a macOS.
Uso de un archivo de suma de comprobación para validar
Las notas de la versión de .NET contienen un vínculo a un archivo de suma de comprobación que puede usar para validar el archivo descargado. En los pasos siguientes se describe cómo descargar el archivo de suma de comprobación y validar un binario de instalación de .NET:
La página de notas de la versión de .NET 8 sobre GitHub en https://github.com/dotnet/core/tree/main/release-notes/8.0#releases contiene una sección denominada Versiones. La tabla de esa sección se vincula a las descargas y los archivos de suma de comprobación para cada versión de .NET 8:
Seleccione el vínculo de la versión de .NET que ha descargado.
En la sección anterior se usó el SDK de .NET 8.0.100, que se encuentra en la versión de .NET 8.0.0.
En la página de versión, puede ver la versión del runtime de .NET y del SDK de .NET y un vínculo al archivo de suma de comprobación:
Haga clic con el botón secundario en el vínculo Suma de comprobación y copie el vínculo en el Portapapeles.
Abre un terminal.
Use curl -O {link} para descargar el archivo de suma de comprobación.
Reemplace el vínculo del siguiente comando por el vínculo que ha copiado.
Con el archivo de suma de comprobación y el archivo de versión de .NET descargado en el mismo directorio, use el comando sha512sum -c {file} --ignore-missing para validar el archivo descargado.
Cuando se supera la validación, verá que el archivo se imprime con el estado Aceptado:
$ sha512sum -c 8.0.0-sha.txt --ignore-missing
dotnet-sdk-8.0.100-linux-x64.tar.gz: OK
Si ve el archivo marcado como Fallado, el archivo que descargó no es válido y no debe usarse.
$ sha512sum -c 8.0.0-sha.txt --ignore-missing
dotnet-sdk-8.0.100-linux-x64.tar.gz: FAILED
sha512sum: WARNING: 1 computed checksum did NOT match
sha512sum: 8.0.0-sha.txt: no file was verified
Equipos Mac basados en Arm
En las secciones siguientes se describen los aspectos que debe tener en cuenta al instalar .NET en un equipo Mac basado en Arm.
Diferencias de ruta de acceso
En un equipo Mac basado en Arm, todas las versiones Arm64 de .NET están instaladas en la carpeta /usr/local/share/dotnet/ habitual. Sin embargo, al instalar la versión x64 del SDK de .NET, se instala en la carpeta /usr/local/share/dotnet/x64/dotnet/.
Variables de ruta de acceso
Puede que sea necesario cambiar las variables de entorno que agregan .NET a la ruta de acceso del sistema, como la variable PATH, 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:
A veces, las aplicaciones del sistema, incluido el terminal, necesitan saber dónde está instalado .NET. El paquete del instalador de macOS de .NET debe configurar automáticamente el sistema. Sin embargo, si ha usado el método de instalación manual o el script de instalación de .NET, debe agregar el directorio donde se ha instalado .NET a la variable PATH.
Es posible que algunas aplicaciones busquen la variable DOTNET_ROOT al intentar determinar dónde se 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
Shell de Korn: ~/.kshrc or .profile
Shell de Z: ~/.zshrc or .zprofile
Establezca las dos variables de entorno siguientes en el perfil de shell:
DOTNET_ROOT
Esta variable se establece en la carpeta en la que se instaló .NET, como $HOME/.dotnet:
export DOTNET_ROOT=$HOME/.dotnet
PATH
Esta variable debe incluir la carpeta DOTNET_ROOT y la carpeta DOTNET_ROOT/tools:
export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools
System.Drawing.Common y libgdiplus
Las aplicaciones .NET que usan el ensamblado System.Drawing.Common necesitan que libgdiplus esté instalado.
Una manera fácil de obtener libgdiplus es usar el administrador de paquetes Homebrew ("brew") para macOS. Después de instalar brew, instale libgdiplus ejecutando los siguientes comandos en el terminal:
El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.
Comentarios de .NET
.NET es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios:
.NET es una plataforma de desarrollador de código abierto gratuita y multiplataforma para crear muchos tipos diferentes de aplicaciones. Con .NET, puede usar varios lenguajes, editores y bibliotecas para crear juegos y aplicaciones para la Web, dispositivos móviles y de escritorio, y el Internet de las cosas (IoT).