Uso de .NET

ServBay proporciona a los desarrolladores de .NET un entorno de desarrollo cómodo y eficiente en macOS. Gracias al sistema de gestión de paquetes de ServBay, puedes instalar, administrar y ejecutar fácilmente múltiples versiones del SDK de .NET, incluyendo el moderno .NET (es decir, .NET Core y posteriores) y el framework clásico Mono, para cubrir las distintas necesidades de tus proyectos.

Visión general

Historia de la plataforma .NET y soporte en macOS

.NET es una plataforma de desarrollo multifuncional creada por Microsoft. Su evolución histórica y de versiones es clave para entender el soporte actual en macOS:

1. .NET Framework (versión original): Lanzado en 2002, .NET Framework fue la principal plataforma de desarrollo de Microsoft, pero estaba diseñada principalmente para sistemas Windows. Incluía el entorno de ejecución Common Language Runtime (CLR) y una gran biblioteca de clases (FCL). Ejecutar aplicaciones .NET Framework directamente en macOS generalmente no es posible.

2. Mono (pionero multiplataforma): Para llevar aplicaciones .NET a sistemas no Windows como Linux y macOS, la comunidad (inicialmente dirigida por Ximian, luego apoyada por Novell y Xamarin/Microsoft) desarrolló Mono. Mono es una implementación de código abierto y multiplataforma de .NET Framework. Esto permitió a los desarrolladores ejecutar y crear apps originalmente escritas para .NET Framework (especialmente en C#) en macOS y Linux. Mono sigue siendo útil para ejecutar aplicaciones o bibliotecas heredadas de .NET Framework en macOS.

3. .NET Core / .NET 5+ (estándar moderno multiplataforma): Microsoft, reconociendo la importancia de la portabilidad, diseñó .NET Core desde cero. Es una implementación moderna, de alto rendimiento, de código abierto y completamente multiplataforma compatible con Windows, macOS y Linux. A partir de .NET Core 3.1, se le renombró simplemente a .NET (desde la versión 5, saltando la 4 para evitar confusiones con .NET Framework 4.x). Actualmente, cuando hablamos del SDK de .NET, normalmente nos referimos a esta versión moderna y multiplataforma (.NET 5, 6, 7, 8, 9, 10, etc.). Microsoft recomienda esta plataforma para todo nuevo desarrollo de aplicaciones, incluyendo las de macOS.

Soporte de .NET en ServBay

ServBay comprende la historia y las necesidades diversas de los desarrolladores .NET y por eso ofrece:

• Paquetes modernos de SDK de .NET: Incluyendo diferentes versiones de .NET (Core), como los SDK de .NET desde la versión 2.0 hasta la 10.0, que te permiten desarrollar en C#, F# y ASP.NET Core de manera multiplataforma y con los últimos avances.
• Paquetes de Mono: Incluye el runtime de Mono (por ejemplo, Mono 6) para soportar proyectos antiguos o librerías específicas basadas en .NET Framework que deban ejecutarse o desarrollarse en macOS, con soporte limitado para ASP.NET antiguo (Web Forms, System.Web MVC).
• Instalaciones en paralelo: Puedes instalar varias versiones del SDK de .NET y de Mono de forma simultánea.
• Control de versiones por proyecto: A través del archivo .servbay.config puedes definir, para cada proyecto, qué versión moderna del SDK de .NET debe emplearse.
• Gestión simplificada: Visualiza, instala y desinstala fácilmente diferentes versiones de SDK y Mono mediante la interfaz gráfica de ServBay.

Acceder a los paquetes .NET

1. Abre la aplicación ServBay.
2. En la barra lateral de la izquierda, haz clic en Paquetes (Packages).
3. En la página de Paquetes, desplázate hacia abajo o selecciona en la lista lateral la categoría Languages -> .NET.
4. A la derecha, verás el listado de todos los paquetes disponibles de SDK de .NET y Mono.

Instalación del SDK de .NET

La lista de paquetes muestra claramente el estado de cada versión de SDK de .NET:

• Nombre del paquete: Ejemplo: .NET SDK 8.0 o Mono 6.
• Versión: Número de versión del paquete.
• Estado: Indica si el paquete está Installed (instalado) o Not Installed (no instalado).
• Control: Botones para realizar acciones sobre el paquete.

Para instalar una versión de SDK de .NET que aún no esté instalada (por ejemplo, .NET SDK 10.0):

1. Localiza la versión deseada en la lista.
2. Confirma que su estado es Not Installed.
3. Haz clic en el icono de descarga/instalación (Download/Install) que aparece a la derecha (usualmente una flecha apuntando hacia abajo).
4. ServBay iniciará la descarga e instalación de la versión seleccionada. El proceso puede tardar varios minutos dependiendo de tu conexión y del tamaño del SDK.
5. Una vez instalado, el estado cambiará a Installed y el icono de control se convertirá en el de desinstalar (Uninstall) (basura).

Gestión de SDKs instalados

• Ver las versiones instaladas: El estado Installed en la lista muestra de forma clara todos los SDK de .NET y versiones de Mono que tienes actualmente en tu entorno.
• Desinstalar un SDK: Si ya no necesitas cierta versión instalada, haz clic en su icono de desinstalar (Uninstall) (basura) y confirma la acción para eliminarla del sistema.

Cómo usar el SDK de .NET instalado

Después de instalar un SDK de .NET, ServBay suele añadir la herramienta de línea de comandos correspondiente (dotnet) al PATH del sistema (cuando el entorno ServBay está activo). Así, podrás ejecutar el comando dotnet directamente desde la Terminal de macOS.

Ejemplos de comandos habituales:

1. Ver las versiones de SDK disponibles: Abre la Terminal y ejecuta:

   dotnet --list-sdks

   Esto mostrará todos los SDK de .NET instalados y gestionados por ServBay junto con sus rutas.

2. Comprobar la versión de SDK activa (por lo general la última instalada o la configurada globalmente):

   dotnet --version

3. Crear una nueva aplicación de consola (usando el SDK por defecto):

   # Crear un directorio de proyecto llamado MyConsoleApp
   mkdir MyConsoleApp
   cd MyConsoleApp
   
   # Crear un nuevo proyecto de consola con el SDK por defecto
   dotnet new console

4. Ejecutar la aplicación:

   dotnet run

5. Usar una versión específica del SDK (si es necesario): Si tu proyecto necesita una versión determinada del SDK, puedes especificarlo mediante el archivo global.json. En el directorio raíz del proyecto, crea un archivo global.json similar al siguiente:

   {
     "sdk": {
       "version": "8.0.408" // Especifica la versión instalada y requerida por tu proyecto
     }
   }

   Al ejecutar un comando dotnet dentro de ese directorio, se priorizará la versión definida en global.json.

Soporte para Mono

Además del SDK de .NET estándar, ServBay también permite instalar Mono. Mono es una implementación multiplataforma y de código abierto de .NET Framework. Si necesitas ejecutar o desarrollar aplicaciones que dependan de funcionalidades específicas de .NET Framework, puedes instalar y usar Mono directamente desde ServBay. El proceso de instalación y desinstalación de Mono es idéntico al del SDK de .NET.

Mono es especialmente útil para ejecutar programas compilados para .NET Framework (.exe) o herramientas que requieran el entorno Mono, incluyendo la ejecución de aplicaciones ASP.NET antiguas.

1. Verificar la versión de Mono:

   mono --version

2. Ejecutar archivos .exe de .NET Framework: Supón que tienes un LegacyApp.exe compilado para .NET Framework:

   mono LegacyApp.exe

3. Ejecutar aplicaciones ASP.NET antiguas (soporte limitado): Mono incluye un pequeño servidor web llamado xsp para ejecutar, en escenarios de desarrollo, aplicaciones antiguas de Web Forms o System.Web MVC. También es posible integrarlo con Nginx + FastCGI o Apache + mod_mono.

   Notas importantes:

   • Este enfoque ofrece compatibilidad limitada con proyectos ASP.NET Framework; no todos los proyectos funcionarán correctamente, especialmente aquellos que dependan de características específicas de Windows.
   • El rendimiento suele ser inferior al de Windows/IIS.
   • No recomendado para nuevos desarrollos web. Para nuevos proyectos, se aconseja usar ASP.NET Core.
   • ServBay ofrece documentación detallada: Cómo ejecutar sitios web ASP.NET Framework 4.x en macOS.

   Si realmente necesitas ejecutarlo (por ejemplo, para pruebas o mantenimiento), probablemente usarás comandos similares a los siguientes (la sintaxis puede variar según la app y configuración):

   # Ejemplo: arrancar el servidor xsp en un directorio específico
   # cd /Applications/ServBay/www/your_legacy_aspnet_app
   # xsp4 --port 8080 # (xsp4 es para .NET 4.x)

Integración con servidores web (ASP.NET Core)

Con el SDK de .NET instalado a través de ServBay puedes desarrollar aplicaciones web ASP.NET Core. A la hora de desplegarlas, puedes utilizar los servidores integrados de ServBay (como Nginx, Caddy o Apache):

1. Usa el comando dotnet publish para compilar tu aplicación ASP.NET Core.
2. En ServBay, añade un Sitio Web (Website) nuevo.
3. Configura el sitio para que actúe como proxy inverso y reenvíe las solicitudes al puerto donde tu app de ASP.NET Core (Kestrel) esté escuchando (ejemplo: http://localhost:5000). La configuración dependerá del servidor web que utilices (Nginx, Caddy o Apache).

Consulta la documentación de ServBay acerca de cómo añadir sitios y configurar el proxy inverso.

Resumen

ServBay simplifica enormemente la creación y administración del entorno de desarrollo .NET en macOS. Gracias a su interfaz intuitiva, los desarrolladores pueden instalar, cambiar y eliminar fácilmente varias versiones del SDK de .NET y de Mono, centrándose en lo más importante: el desarrollo y pruebas de aplicaciones en C#, F# y ASP.NET Core.