Leer en inglés

Compartir a través de


Instalación de .NET en macOS

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.

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

Versiones compatibles

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.

Desarrolladores

  • Visual Studio Code: kit de desarrollo de C#

    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.

Usuarios y desarrolladores

  • Instalador de .NET

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

  • Instalar .NET con un script

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

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

Instalación de .NET

Existen paquetes de instalador para macOS, una forma sencilla de instalar .NET.

  1. Abra un explorador y vaya a https://dotnet.microsoft.com/download/dotnet.

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

    Sitio web de descargas de .NET. Se enumeran las versiones 6.0 a 9.0. Un recuadro rojo resalta los vínculos de descarga.

    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.

  3. 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.

    Sitio web de descargas de .NET que muestra los vínculos de descarga de SDK y del entorno de ejecución. Los encabezados SDK y Runtime están resaltados con un recuadro rojo. Cada recuadro tiene una flecha que apunta a la sección macOS.

    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.

      Captura de pantalla que muestra solo la tabla de descarga del entorno de ejecución de .NET desde el sitio web de descarga de .NET. La fila macOS está resaltada con un recuadro 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, ábrala.

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

    Captura de pantalla que muestra solo el instalador de .NET que se utiliza en macOS.

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.

  1. Abra un explorador y vaya a https://dotnet.microsoft.com/download/dotnet.

  2. 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.

    Sitio web de descargas de .NET. Se enumeran las versiones 6.0 a 9.0. Un recuadro rojo resalta los vínculos de descarga.

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

    El sitio web de descargas de .NET que muestra los vínculos de descarga del SDK. El encabezado del SDK está resaltado con un recuadro rojo. El recuadro tiene una flecha que apunta a la sección 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 navegue hasta el lugar donde se descargó el archivo binario .NET.

  5. Extraiga el archivo tarball en el lugar del sistema donde desee instalar .NET. En el ejemplo siguiente se usa el directorio HOME~/Applications/.dotnet.

    Bash
    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:

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

Instalar .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 https://dot.net/v1/dotnet-install.sh.

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.

  1. Abre un terminal.

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

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

    Bash
    brew install wget
    
  4. Ejecute el comando siguiente para descargar el script.

    Bash
    wget https://dot.net/v1/dotnet-install.sh
    
  5. Conceda permisos de ejecución al script.

    Bash
    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.

    Bash
    ./dotnet-install.sh
    

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

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:

Bash
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:

Alerta de certificación de macOS Catalina

Para obtener más información sobre cómo afecta la certificación forzada a .NET (y a las aplicaciones de .NET), vea Trabajo con la certificación de macOS Catalina.

Validation

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.

La página de descarga de .NET con suma de comprobación

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:

Bash
$ sha512sum dotnet-sdk-8.0.100-linux-x64.tar.gz
13905ea20191e70baeba50b0e9bbe5f752a7c34587878ee104744f9fb453bfe439994d38969722bdae7f60ee047d75dda8636f3ab62659450e9cd4024f38b2a5  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:

  1. 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:

    La tabla de notas de la versión de GitHub para .NET

  2. 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.

  3. 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:

    La tabla de descargas con sumas de comprobación para .NET

  4. Haga clic con el botón secundario en el vínculo Suma de comprobación y copie el vínculo en el Portapapeles.

  5. Abre un terminal.

  6. 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.

    Bash
    curl -O https://dotnetcli.blob.core.windows.net/dotnet/checksums/8.0.0-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 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:

    Bash
    $ 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.

    Bash
    $ 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:

Hacer que .NET esté disponible en todo el sistema

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:

    Bash
    export DOTNET_ROOT=$HOME/.dotnet
    
  • PATH

    Esta variable debe incluir la carpeta DOTNET_ROOT y la carpeta DOTNET_ROOT/tools:

    Bash
    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:

Consola
brew update
brew install mono-libgdiplus