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.

Visual Studio

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:

   

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.

   

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:

   

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:

   

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

   

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

   

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

   

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

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

   

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

   

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

    

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

    

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

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

    

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

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

    

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

    

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

15. Cierra la ventana Administrador de dispositivos Android.

    

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

    

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

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

    

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.

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

   

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

   

   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:

   

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

   

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

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

   

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.

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

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

   

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

   

   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.

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

   

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.

Visual Studio Code

Requisitos previos

• Visual Studio Code, con la extensión de .NET MAUI instalada. Para más información, consulte Instalación.

Creación de una aplicación

Para crear una aplicación .NET MAUI:

1. Inicie Visual Studio Code. En el Explorador, haga clic en Crear proyecto de .NET en el Explorador. Como alternativa, seleccione CTRL/CMD+SHIFT+P.NET: Nuevo proyecto....
2. Selecciona Aplicación .NET MAUI o .NET MAUI Blazor App.
3. Selecciona una carpeta vacía. Si el explorador de archivos se abre de nuevo, la carpeta no está vacía.
4. Dé nombre al proyecto.
5. Asegúrate de que el proyecto se carga correctamente en el Explorador de soluciones y luego abre un archivo C# o XAML.

Nota:

También puede abrir un proyecto de .NET MAUI existente en Visual Studio Code a través del menú Archivo > Abrir....

Ahora deberías ver la aplicación en el Explorador de soluciones del kit de desarrollo #C de Visual Studio Code. Puesto que la extensión de .NET MAUI depende del kit de desarrollo de C#, puedes usar todas sus características junto con la extensión.

Elegir el dispositivo de destino

Para elegir el dispositivo de destino, haga clic en el símbolo de llaves { } en la esquina inferior derecha de Visual Studio Code. Puede usar este símbolo para cambiar el proyecto de inicio, cambiar el destino de depuración a cualquier elemento válido en la máquina de desarrollo y anclar cualquiera de las opciones a la barra de estado de Visual Studio Code:

También puede establecer el proyecto de inicio y el destino de la depuración en la paleta de comandos, mediante CTRL/CMD+MAYÚS+P y buscando ".NET MAUI".

Puede realizar la implementación en la máquina de desarrollo local (escritorio de Windows o macOS con Xcode) sin pasos adicionales.

Android como destino

Si quiere usar emuladores de Android, siga estos pasos para instalar y crear un emulador:

1. Ve en el terminal a <YOUR_ANDROID_SDK_DIRECTORY>/cmdline-tools/11.0/bin/.

2. Use sdkmanager para instalar el emulador.

   En Windows, ejecute los siguientes comandos en el terminal:

   sdkmanager --install emulator
   sdkmanager --install "system-images;android-33;google_apis;x86_64"
   

   En macOS, ejecute los siguientes comandos en el terminal:

   ./sdkmanager --install emulator
   ./sdkmanager --install "system-images;android-33;google_apis;x86_64"
   

   Nota:

   Las comillas alrededor de la sdkmanager argumentos de la línea de comandos son importantes.

3. Luego puedes crear un nuevo emulador en la línea de comandos con avdmanager de Android.

   En Windows, ejecute los siguientes comandos en el terminal:

   avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64"
   

   En macOS, ejecute los siguientes comandos en el terminal:

   ./avdmanager create avd -n MyAndroidVirtualDevice-API33 -k "system-images;android-33;google_apis;x86_64"
   

   Nota:

   Las comillas alrededor de la avdmanager argumentos de la línea de comandos son importantes.

También puedes depurar en dispositivos Android físicos.

iOS como destino

Los simuladores de iOS están integrados en Xcode. Para descargar los simuladores, asegúrese de que la opción esté seleccionada para instalarlos cuando Xcode se inicie por primera vez, o vaya a Xcode > Configuración > Plataformas y elija un runtime del simulador para instalarlo.

Para depurar con un dispositivo iOS, siga estos pasos antes de intentar depurar:

1. Especifique el id. de Apple en Xcode > Configuración > Cuenta.
2. Registre el dispositivo con su equipo si pertenece al Programa para desarrolladores de Apple.
3. Habilite el modo para desarrolladores en el dispositivo, como se describe en Habilitación del modo para desarrolladores en un dispositivo. La primera vez que ejecute la aplicación, puede recibir un elemento emergente en el dispositivo; asegúrese de seleccionar Permitir.

Depurar la aplicación

Para depurar la aplicación, vaya al menú Ejecutar y depurar de Visual Studio Code y seleccione el botón Ejecutar y depurar . Como alternativa, puede usar F5 para iniciar una sesión de depuración. Si Visual Studio Code le pide que seleccione un depurador, asegúrese de seleccionar C#.

Nota:

En versiones preliminares de la extensión, el depurador aparece como .NET MAUI. En la versión estable, esta configuración se ha reemplazado por C#.

El depurador elegirá automáticamente el destino de la depuración y el proyecto de inicio que estableció en el menú de llaves { }. Si no ha seleccionado nada, se le pedirá que elija un destino de depuración.

Una vez que la aplicación inicie la depuración, puedes usar las herramientas de depuración integradas de Visual Studio Code para establecer puntos de interrupción, recorrer paso a paso el código y mucho más.

Saber más

Si tiene algún problema con la extensión, puede seguir los pasos de solución de problemas, ver los problemas conocidos o proporcionar comentarios.

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.