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

Ejecutar en un dispositivo móvil

Puede decidir implementar en una o varias de las plataformas en función del entorno de desarrollo. Acaba de ejecutar e implementar la aplicación en Windows. Ahora, vamos a configurar un dispositivo o emulador Android.

Activar Hyper-V

En la barra de Windows Search, escriba características de Windows y seleccione Activar o desactivar las características de Windows.

Activar o desactivar las características de Windows

Asegúrese de que la casilla de Hyper-V esté activada y seleccione Aceptar.

Casilla Características de Windows con Hyper-v activada

Deberá reiniciar el equipo en este momento para que el cambio surta efecto.

instalación de Android SDK

Abra Visual Studio y su solución de MyFirstMauiApp. En el menú desplegable del destino de depuración, seleccione net8.0-android en Framework.

Seleccionar Android como implementación de destino

Se requieren versiones específicas del Android SDK para compilar proyectos. Si no ha aceptado la licencia de Android SDK, verá el siguiente mensaje de error en la ventana Lista de errores.

Mensaje de error en la ventana Lista de errores que muestra que no se ha aceptado la licencia de Android SDK.

Haga doble clic en el mensaje para iniciar el proceso de aceptación de la licencia. Haga clic en Aceptar para cada una de las licencias presentes y se iniciará la instalación automática.

Mensaje de Android SDK que solicita al usuario instalar una versión de Android SDK específica para compilar el proyecto.

Configuración del emulador de Android

Si no tiene un dispositivo Android en el que realizar la implementación, puede seguir estos pasos para configurar un emulador de Android. Si ya lo ha hecho o desea usar su propio dispositivo Android, puede omitir este paso.

Si es la primera vez que compila una aplicación de .NET MAUI, verá Android Emulator seleccionado en el menú desplegable de destino de depuración. Haga clic en él para iniciar el proceso de creación. Si aparece un cuadro de diálogo de aceptación de licencia, seleccione Accept.

El menú de la barra de herramientas de Visual Studio 2022 muestra

Se abrirá la ventana Nuevo dispositivo. Seleccione el botón Crear para crear un emulador con la configuración predeterminada. Esto descargará las imágenes del emulador y finalizará la creación del emulador para usarlo en Visual Studio. Este paso puede tardar unos minutos.

No se preocupe si el nivel de API que ve es diferente de las imágenes. Debe tener 33 años o más.

Cuadro de diálogo para crear un nuevo emulador de Android con la configuración predeterminada rellenada.

Una vez creado el emulador, verá un botón que dice Iniciar. Haga clic en él.

Administrador del emulador de Android que muestra que el emulador se ha creado y está listo para ejecutarse.

Es posible que reciba un mensaje para habilitar la plataforma de hipervisor de Windows. Siga ladocumentación para habilitar la aceleración para mejorar el rendimiento (necesario para permitir el funcionamiento del emulador). Seleccione Ejecutar de todos modos.

Preguntar si se habilita la plataforma del hipervisor de Windows

El emulador de Android se iniciará y finalizará por completo cuando vea la opción de Detener en el Administrador de dispositivos Android. Esto puede tardar algún tiempo.

Menú de la barra de herramientas de Visual Studio 2022 que muestra el emulador de Android recién creado como objetivo de depuración.

Una vez que haya finalizado, se mostrará en el menú de depuración Visual Studio.

Menú de la barra de herramientas de Visual Studio 2022 que muestra el emulador de Android recién creado como objetivo de depuración.

Ahora se ha creado el emulador de Android y está listo para usarse. La próxima vez que ejecute Visual Studio, el emulador aparecerá directamente en la ventana de destino de depuración y se iniciará cuando lo seleccione. Si ha tenido algún problema o tiene problemas de rendimiento con el emulador, lea la documentación de configuración completa.

Configurar dispositivo Android

Para desarrollar con su dispositivo Android, es necesario habilitar la depuración USB. Siga estos pasos en el dispositivo para conectarlo a Visual Studio. Si no tiene un dispositivo Android, puede omitir esta sección.

Habilitar el modo de desarrollador

  1. Vaya a la pantalla Configuración.
  2. Busque Número de compilación mediante la búsqueda en la parte superior de la pantalla de configuración o búsquelo en Acerca del teléfono.
  3. Pulse Número de compilación 7-10 veces hasta que aparezca "Ahora es un desarrollador".

Pantalla de configuración del dispositivo Android en la pantalla Acerca del teléfono que muestra el número de compilación.

Comprobación del estado de depuración USB

  1. Vaya a la pantalla Configuración.
  2. Encuentra Depuración de USB mediante la búsqueda en la parte superior de la pantalla de configuración o encuéntrala en Opciones de desarrollador.
  3. Habilite la depuración USB si aún no está habilitada.

Pantalla de configuración del dispositivo Android en la pantalla acerca de la configuración del desarrollador que muestra la opción de depuración USB que está activada.

Dispositivo de confianza

  1. Conecte el dispositivo al equipo.
  2. Se le pedirá Permitir depuración USB.
  3. ComprobarPermitir siempre desde este equipo.
  4. Haga clic en Permitir.

Solicitud de dispositivo Android para permitir la depuración USB en el dispositivo desde el equipo.

El dispositivo ya está configurado y se mostrará en Visual Studio como un destino de implementación.

¿Tiene problemas? Consulte la documentación.

El emulador o el dispositivo ahora deben configurarse para la implementación.

Ejecutar en Android

Asegúrese de que el dispositivo o emulador está seleccionado como destino de depuración.

Emulador de Android Pixel 5 establecido como destino de depuración.

En el menú, seleccione Depurar > Iniciar depuración (o presione F5). Si esta opción está deshabilitada, asegúrese de que está seleccionado un emulador o un dispositivo.

La aplicación se compilará, implementará en el dispositivo o emulador Android seleccionado y se ejecutará.

Emulador de Android que ejecuta la aplicación .NET MAUI. Se muestra el mensaje “Hola .NET MAUI”.

Puede implementar en una o varias de las plataformas en función del entorno de desarrollo. Acaba de ejecutar e implementar la aplicación en macOS. Ahora, vamos a realizar la implementación en iOS.

Cierre la aplicación .NET MAUI que tenía en ejecución y vuelva a VS Code.

Haga clic en las llaves en la parte inferior derecha de la ventana de VS Code en la barra de estado y seleccione Destino de depuración.

Mi Mac seleccionado como implementación de destino de forma predeterminada

Desplácese hacia abajo y seleccione iPhone 15.

Lista de destinos de depuración con iPhone 15 resaltado

Ahora debería ver iOS: iPhone 15 como nuevo destino de depuración.

Destino de depuración actualizado para mostrar iPhone 15

Para ejecutar la aplicación, haga clic en el icono Ejecutar y depurar de la barra de actividades de VS Code. Después haga clic en Ejecutar y depurar.

Panel de depuración y ejecución de VS Code

La aplicación se compilará e implementará en el simulador de iPhone. Tenga en cuenta que esto puede tardar un minuto, está encendiendo un iPhone virtualmente.

Aplicación .NET MAUI ejecutándose en el simulador de iOS

Continuar