Tutorial de .NET MAUI: Compilación de la primera aplicación multiplataforma en C#

Windows macOS

Descargar e instalar

Descargar e instalar Visual Studio 2022.

Descargar Visual Studio 2022

Durante la instalación, se debe seleccionar la carga de trabajo Desarrollo de.NET Multi-Platform App UI. El uso del vínculo anterior debe preseleccionar todos los requisitos previos correctamente, como se muestra en la siguiente imagen:

Instalador de Visual Studio con la carga de trabajo Desarrollo móvil con .NET seleccionada

¿Ya tiene Visual Studio 2022?

Este tutorial está optimizado para la versión más reciente de Visual Studio. Si ya tiene Visual Studio 2022, asegúrese de que esté actualizado y de que tiene instalada la carga de trabajo necesaria:

  • Busque el Instalador Visual Studio en su equipo.

    En el menú Inicio de Windows, busque "installer" y, luego, seleccione Instalador Visual Studio en los resultados.

  • Si se le solicita, permita que el instalador se actualice a sí mismo.
  • En caso de haber actualizaciones disponibles de Visual Studio 2022, se mostrará el botón Actualizar. Selecciónelo para actualizar antes de modificar la instalación. Este tutorial solo es válido para Visual Studio 2022 17.12 y versiones posteriores.
  • Busque la instalación de Visual Studio 2022 y seleccione Modificar.
  • Seleccione Desarrollo de .NET Multi-Platform App UI.
  • Seleccione el botón Modificar.

  1. Descarga e instalación del SDK de .NET. Una vez completada la descarga, inicie la descarga para comenzar la instalación.

    Descarga del SDK x64 de .NET 9 (Intel)
    Descarga del SDK Arm64 de .NET 9 (Apple Silicon)

    Si está en un equipo Mac con un chip M1 o M2 de Apple, debe instalar la versión Arm64 del SDK.

  2. Descargar e instalar VS Code:

    Descargue VS Code

  3. Abra VS Code y seleccione el botón Extensiones en la barra de actividades de VS Code, a la izquierda. Escriba MAUI en la barra de búsqueda, seleccione .NET MAUI, y después seleccione el botón Instalar en la página de extensión de .NET MAUI.

    Extensión MAUI de VS Code

    Esta extensión incluye el Kit de desarrollo de C# y las extensiones de C#, que son necesarias para que se ejecute la extensión .NET MAUI.

    Dependencias de la extensión MAUI de VS Code

  4. Abra un nuevo terminal e instale la carga de trabajo .NET MAUI mediante la ejecución del siguiente comando:

    Terminal
    sudo dotnet workload install maui

    Si la instalación se realizó correctamente, debería ver una salida similar a la siguiente:

    Terminal
    Successfully installed workload maui

Comprobar que todo está instalado correctamente

Una vez que haya configurado el entorno, abra un nuevo terminal de VS Code. En la barra de herramientas, seleccione Terminal y, a continuación, Nuevo terminal.

Nuevo terminal de VS Code

En el terminal, ejecute el siguiente comando para comprobar la instalación.

Terminal
dotnet workload list

Ejecute el comando de lista de carga de trabajo dotnet en el terminal de VS Code

Si la instalación se realizó correctamente, debería ver una salida similar a la siguiente:

Terminal
Installed Workload Id      Manifest Version      Installation Source
--------------------------------------------------------------------
maui                       8.0.82/8.0.100        SDK 8.0.400

Use `dotnet workload search` to find additional workloads to install.

¿Tiene un error?

Si recibe un error 'dotnet' no se reconoce como un comando interno o externo, asegúrese de que ha abierto un nuevo terminal de VS Code. Si reiniciar VS Code o reiniciar su máquina no resuelve el problema, use el botón He encontrado un problema al final de la página para obtener ayuda para solucionar el problema.

Instalar Xcode

Para compilar las aplicaciones .NET MAUI, también necesitarás:

  1. Versión más reciente de Xcode

    Para encontrar la versión más reciente de Xcode que sea compatible con .NET MAUI, revise esta referencia de versiones de lanzamiento. Vaya a la columna Herramientas de Apple para encontrar la versión de Xcode compatible más reciente.

  2. Un id. de Apple

    Si aún no tiene un id. de Apple, puede crear uno nuevo en https://appleid.apple.com. Se requiere un id. de Apple para instalar e iniciar sesión en Xcode.

  3. Tras instalar Xcode, debe abrir Xcode y aceptar los contratos de licencia e instalar los componentes opcionales, si se le solicita.

  4. Cuando se le pregunte para qué plataformas le gustaría desarrollar, seleccione las plataformas macOS e iOS y después Descargar e instalar.

    Solicitud de Xcode para instalar plataformas macOS e iOS

  5. Abra un nuevo terminal e instale las herramientas de desarrollo de la línea de comandos de Xcode mediante la ejecución del siguiente comando:

    Terminal
    xcode-select --install

    Cuando se le pida que instale las herramientas de desarrollo de la línea de comandos de Xcode, seleccione Instalar. Por último, acepte el contrato de licencia.

    Solicitud de Xcode para instalar las herramientas de desarrollo de línea de comandos

Si todo parece correcto, seleccione el botón Continuar de abajo para ir al siguiente paso.