Compartir vía


Compilación de la primera aplicación

En este tutorial, obtendrá información sobre cómo crear y ejecutar su primera aplicación de .NET Multi-Platform App UI (.NET MAUI) en Visual Studio 2022 en Windows o Visual Studio Code en Windows, macOS o Linux. Esto te ayudará a asegurarte de que el entorno de desarrollo está configurado correctamente.

Requisitos previos

  • Visual Studio 2022 17.8 o posterior, con la carga de trabajo .NET MAUI Multi-platform App UI instalada. Para más información, consulte Instalación.

Creación de una aplicación

En este tutorial, crearás la primera aplicación .NET MAUI en Visual Studio 2022 y la ejecutarás en un emulador de Android:

El desarrollo de aplicaciones .NET MAUI para iOS en Windows requiere un host de compilación de Mac. Si no necesitas tener específicamente el destino iOS y no tienes un equipo Mac, considera la posibilidad de empezar a usar Android o Windows en su lugar.

En este tutorial, crearás la primera aplicación .NET MAUI en Visual Studio y la ejecutarás en un simulador de iOS:

En este tutorial, crearás la primera aplicación .NET MAUI en Visual Studio 2022 y la ejecutarás en Windows:

  1. Inicie Visual Studio 2022. En la ventana de inicio, haz clic en Create a new project para crear un proyecto nuevo:

    Nueva solución.

  2. En la ventana Crear un nuevo proyecto, selecciona MAUI en la lista desplegable Todos los tipos de proyecto, selecciona la plantilla .NET MAUI App y luego el botón Siguiente.

    Elegir una plantilla.

  3. En la ventana Configurar el nuevo proyecto, dale un nombre al proyecto, elige una ubicación adecuada para él y selecciona el botón Siguiente:

    Configure el proyecto.

  4. En la ventana Información adicional, elige la versión de .NET a la que te quieres dirigirte y haz clic en el botón Crear:

    Información adicional.

  5. Espera a que se creen los proyectos y se restauren sus dependencias.

    Dependencias restauradas.

  1. En la barra de herramientas de Visual Studio, usa la lista desplegable Destino de depuración para seleccionar Emuladores de Android y después la entrada Emulador de Android:

    Seleccione el destino de depuración de Android Emulator para .NET MAUI.

  2. En la barra de herramientas de Visual Studio, selecciona el botón Emulador de Android:

    Botón del emulador de Android.

    Visual Studio comenzará a instalar el Android SDK predeterminado y Android Emulator.

  3. En la ventana Contrato de licencia de Android SDK, selecciona el botón Aceptar:

    Primera ventana del Contrato de licencia de Android SDK.

  4. En la ventana Contrato de licencia de Android SDK, selecciona el botón Aceptar:

    Segunda ventana del Contrato de licencia de Android SDK.

  5. En el cuadro de diálogo Control de cuentas de usuario, presiona el botón :

    Cuadro de diálogo de control de cuentas de usuario de licencia de Android SDK.

  6. En la ventana Aceptación de licencia, presiona el botón Aceptar.

    Ventana de licencia del dispositivo Android.

    Espere a que Visual Studio descargue Android SDK y Android Emulator.

  7. En la barra de herramientas de Visual Studio, selecciona el botón Emulador de Android:

    Botón del emulador de Android.

    Visual Studio comenzará a crear un emulador de Android predeterminado.

  8. En el cuadro de diálogo Control de cuentas de usuario, presiona el botón :

    Cuadro de diálogo de control de cuentas de usuario de Administrador de dispositivos Android.

  9. En la ventana Dispositivo nuevo, presiona el botón Crear:

    Ventana Nuevo dispositivo Android.

    Espera a que Visual Studio se descargue, se descomprima y crea una instancia del Emulador de Android.

  10. Cierra la ventana Administrador de dispositivos Android.

    Ventana administrador de dispositivos Android.

  11. En la barra de herramientas de Visual Studio, presiona el botón Pixel 5 - API 34 (Android 14.0 - API 33) para compilar y ejecutar la aplicación:

    Botón del emulador de API 34 de Pixel 5.

    Visual Studio inicia Android Emulator, compila e implementa la aplicación en el Emulator.

    Advertencia

    La aceleración de hardware debe estar habilitada para maximizar el rendimiento del emulador de Android. Si no se hace esto, el emulador se ejecuta muy lentamente. Para más información, consulte Cómo habilitar la aceleración de hardware con emuladores de Android (Hyper-V y AEHD).

  12. En la aplicación en ejecución en el Emulador de Android, presiona el botón Hacer clic aquí varias veces y observa que se incrementa el recuento del número de clics de botón.

    Aplicación que se ejecuta en emulador de Android.

Solución de problemas

Si la aplicación no se puede compilar, revisa Solución de problemas conocidos, que puede tener una solución a tu problema. Si el problema está relacionado con el Android Emulator, consulta Solución de problemas de Android Emulator.

  1. En la barra de herramientas de Visual Studio, use la lista desplegable Depurar destino para seleccionar Framework y, a continuación, la entrada net8.0-windows:

    Seleccione el destino de depuración de máquinas Windows para .NET MAUI.

  2. En la barra de herramientas de Visual Studio, presiona el botón Equipo Windows para compilar y ejecutar la aplicación:

    Ejecute la aplicación .NET MAUI en el botón de Visual Studio.

    Si no has habilitado el modo de desarrollador, Visual Studio te pedirá que lo habilites. En el cuadro de diálogo Habilitar el modo de desarrollador en Windows, haz clic en configuración para desarrolladores para abrir la aplicación Configuración:

    Cuadro de diálogo habilitar el modo de desarrollador de Windows.

    En la aplicación Configuración, activa el Modo de desarrollador y acepta la declinación de responsabilidades:

    Alternar modo de desarrollador en la aplicación de configuración de Windows 11.

    Cierra la aplicación Configuración y después cierra el cuadro de diálogo Habilitar el modo de desarrollador en Windows.

  3. En la aplicación en ejecución, presiona el botón Hacer clic varias veces y observa que el recuento del número de clics de botón se incrementa:

    Aplicación MAUI de .NET que se ejecuta en Windows.

Solución de problemas

Si la aplicación no se puede compilar, revisa Solución de problemas conocidos, que puede tener una solución a tu problema.

  1. En Visual Studio, empareja IDE con un host de compilación de Mac. Para obtener más información, consulta Emparejar con Mac para el desarrollo de iOS.

  2. En la barra de herramientas de Visual Studio, usa la lista desplegable Destino de depuración para seleccionar Simuladores de SO de iOS y después un simulador de iOS específico:

    Los simuladores de iOS de Visual Studio describen los destinos de depuración.

  3. En la barra de herramientas de Visual Studio, presiona el botón de iniciar del simulador de iOS elegido para compilar y ejecutar la aplicación:

    Opción de destino de depuración del simulador de iOS de Visual Studio.

    Visual Studio compilará la aplicación, iniciará el simulador remoto de iOS para Windows e implementará la aplicación en el simulador remoto. Para obtener más información sobre el Simulador remoto de iOS para Windows, consulta Simulador remoto de iOS para Windows.

  4. En la aplicación en ejecución, presiona el botón Hacer clic varias veces y observa que se incrementa el recuento del número de clics de botón.

    Aplicación .NET MAUI que se ejecuta en el simulador de iOS en un equipo Mac.

Solución de problemas

Si la aplicación no se puede compilar, revisa Solución de problemas conocidos, que puede tener una solución a tu problema.

Las aplicaciones .NET MAUI destinadas a Mac Catalyst solo se pueden iniciar y depurar con Visual Studio 2022 para Mac.

Pasos siguientes

En este tutorial, aprendiste a crear y ejecutar la primera aplicación de interfaz de usuario de aplicación multiplataforma de .NET (.NET MAUI).

Para obtener información sobre los aspectos básicos de la creación de una aplicación con .NET MAUI, consulta Creación de una aplicación .NET MAUI. Como alternativa, para obtener un curso completo de aprendizaje de .NET MAUI, consulta Creación de aplicaciones móviles y de escritorio con .NET MAUI.