Compilación de la primera 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 iniciará el proceso de instalación de Android SDK predeterminado y Android Emulator.

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

   

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

   

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

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

    

11. En el cuadro de diálogo Plataforma android SDK falta , presione el botón Instalar :

    

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

    

    Espere a que Visual Studio instale los componentes de Android SDK.

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

14. Cierra la ventana Administrador de dispositivos Android.

    

15. En la barra de herramientas de Visual Studio, presione el botón Pixel 7 - API 35 (Android 15.0 - API 35):

    

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

    

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

    

    Espere a que Visual Studio se instale para descargar Android SDK.

18. En la barra de herramientas de Visual Studio, presione el botón Pixel 7 - API 35 (Android 15.0 - API 35) 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).

19. 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, presiona el botón Equipo Windows para compilar y ejecutar la aplicación:

   

7. 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 mediante Visual Studio Code.

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

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

En este tutorial, creará la primera aplicación MAUI de .NET en Visual Studio Code en un equipo Mac y la ejecutará en macOS:

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

7. En Visual Studio Code, compruebe que el entorno android está configurado correctamente presionando CTRL+MAYÚS+P en Windows o CMD+MAYÚS+P en macOS y, después, seleccionando .NET MAUI: Configurar Android, seguido de Actualizar entorno android. Se deben solucionar los errores detectados.

8. En la barra de estado en la parte inferior de Visual Studio Code, presione el símbolo de llaves { } y asegúrese de que el Destino de Depuración esté configurado en un emulador de Android específico:

   

   También puede configurar el objetivo de depuración presionando CTRL+MAYÚS+P en Windows o CMD+MAYÚS+P en macOS y seleccionando .NET MAUI: Pick Android Device en la paleta de comandos.

9. Compile y ejecute la aplicación en Android presionando F5 o presionando el botón Ejecutar en la esquina superior derecha de Visual Studio Code:

   

   Si se le pide que seleccione un depurador en la paleta de comandos, seleccione C# y, a continuación, la configuración de inicio del proyecto.

10. En la aplicación en ejecución en el emulador de Android elegido, presione el botón Haga clic en mí varias veces y observe que el recuento de clics se incrementa.

    

Depura la aplicación en un dispositivo Android

Para depurar la aplicación en un dispositivo Android:

1. Asegúrese de que el dispositivo está configurado para la implementación. Para obtener más información, consulte Configuración de un dispositivo para la implementación.
2. Conecte el dispositivo a la máquina y selecciónelo como destino de depuración en Visual Studio Code.
3. Ejecute la aplicación.

7. En Visual Studio Code, compruebe que el entorno de Apple está configurado correctamente presionando CMD+MAYÚS+P y seleccionando .NET MAUI: Configurar Apple, seguido de Actualizar entorno de Apple. Se deben solucionar los errores detectados.

8. En la barra de estado en la parte inferior de Visual Studio Code, presiona el símbolo de llaves { } y asegúrate de que el destino de depuración esté establecido en un simulador de iOS específico.

   

   También puede establecer el destino de depuración presionando CMD+MAYÚS+P y eligiendo .NET MAUI: Elegir dispositivo iOS en la paleta de comandos.

9. Compile y ejecute la aplicación en iOS presionando F5 o el botón Ejecutar en la esquina superior derecha de Visual Studio Code.

   

   Si se le pide que seleccione un depurador en la paleta de comandos, seleccione C# y, a continuación, la configuración de inicio del proyecto.

10. En la aplicación abierta en el simulador de iOS elegido, presiona el botón Haga clic en mí varias veces y observa que el recuento de clics en el botón aumenta.

    

Depura la aplicación en un dispositivo iOS

Para depurar la aplicación en un dispositivo iOS:

1. Asegúrese de que ha agregado el identificador de Apple a Xcode en Xcode > Configuración > Cuentas.
2. Asegúrese de que el dispositivo se ha registrado con su equipo, si pertenece al Programa para desarrolladores de Apple.
3. Habilite el modo de desarrollador en el dispositivo. La primera vez que ejecute la aplicación, puede recibir un elemento emergente en el dispositivo; asegúrese de seleccionar Permitir. Para obtener más información sobre el modo de desarrollador, consulte Habilitación del modo de desarrollador en un dispositivo en developer.apple.com.
4. Conecte el dispositivo a la máquina y selecciónelo como destino de depuración en Visual Studio Code.
5. Ejecute la aplicación.

7. En Visual Studio Code, compruebe que el entorno de Apple está configurado correctamente presionando CMD+MAYÚS+P y seleccionando .NET MAUI: Configurar Apple, seguido de Actualizar entorno de Apple. Se deben solucionar los errores detectados.

8. En la barra de estado de la parte inferior de Visual Studio Code, presiona el símbolo de llaves { } y asegúrate de que el destino de depuración esté establecido en tu Mac:

   

   También puede establecer el destino de depuración presionando CMD+MAYÚS+P y eligiendo .NET MAUI: Elegir dispositivo macOS en la paleta de comandos.

9. Compile y ejecute la aplicación en macOS presionando F5 o presionando el botón Ejecutar en la esquina superior derecha de Visual Studio Code:

   

   Si se le pide que seleccione un depurador en la paleta de comandos, seleccione C# y, a continuación, la configuración de inicio del proyecto.

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

    

7. En la barra de estado en la parte inferior de Visual Studio Code, presione el símbolo de llaves { } y asegúrese de que el Destino de Depuración esté establecido en Windows:

   

   También puede configurar el objetivo de depuración presionando CTRL+MAYÚS+P y seleccionando .NET MAUI: Elegir dispositivo Windows en la paleta de comandos.

8. Compile y ejecute la aplicación en Windows presionando F5 o presionando el botón Ejecutar de en la esquina superior derecha de Visual Studio Code:

   

   Si se le pide que seleccione un depurador en la paleta de comandos, seleccione C# y, a continuación, la configuración de inicio del proyecto.

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