Windows Subsystem for Android™️

Windows Subsystem for Android™ permite que un dispositivo con Windows 11 ejecute aplicaciones de Android que están disponibles en Amazon Appstore. Android es una marca comercial de Google LLC. Si es desarrollador y le interesa apuntar a dispositivos de escritorio Windows y optimizar para el sistema operativo Windows, esta guía es para usted.

Para que la aplicación Android esté disponible en dispositivos Windows 11, debe:

Para obtener más información o soporte técnico:

Esta guía puede ayudarle a probar y depurar la aplicación Android en Windows:

Programa de vista previa

La versión preliminar del programa Windows Subsystem for Android™️ permite a los usuarios recibir compilaciones preliminares anticipadas de Windows Subsystem for Android™️ y Amazon Appstore en Windows. Para más información, visite la página de la versión preliminar del programa.

Configurado su entorno de desarrollo

Para probar la aplicación de Android en el entorno de escritorio de Windows, se requiere cierta configuración.

Prerrequisitos

Windows Subsystem para Android está disponible para la versión preliminar pública en Windows 11.

El dispositivo debe cumplir requisitos específicos: Requisitos del dispositivo.

Instalación de Amazon Appstore

Microsoft Store instalará automáticamente el Subsistema de Windows para Android de forma silenciosa en segundo plano cuando el usuario realice una de las dos acciones siguientes:

  1. Se instala Amazon Appstore desde Microsoft Store. Al seleccionar Obtener, comenzará la instalación de la aplicación.
  2. Se instala una aplicación de Android desde Microsoft Store por primera vez, lo que también instalará Amazon Appstore.

Amazon AppStore y la aplicación de configuración del Subsistema de Windows para Android aparecerán en el menú Inicio de Windows 11 y estarán disponibles en la búsqueda, lo que ofrece un catálogo de aplicaciones Android.

Captura de pantalla de la página Microsoft Store con el botón Obtener en Amazon Appstore

Nota:

Amazon AppStore en Windows (un requisito para ejecutar aplicaciones Android en Windows 11) solo está disponible actualmente en Estados Unidos.

Aplicación de configuración del Subsistema de Windows para Android™️

Para acceder a la aplicación Configuración del Subsistema de Windows para Android, vaya a: Inicio > Todas las aplicaciones > Configuración del Subsistema de Windows para Android™️. Más información sobre las características específicas de la aplicación de configuración: Administración de la configuración de aplicaciones móviles en Windows.

Captura de pantalla de la configuración de aplicaciones Latte

Consideraciones sobre la compatibilidad de entrada para dispositivos Windows

Hay algunos comportamientos de entrada únicos que se deben tener en cuenta y que probablemente exijan actualizaciones en el código de la aplicación de Android, diseñada para dispositivos portátiles, para que sea compatible cuando se ejecute en un dispositivo de escritorio Windows través de Amazon Appstore.

Entrada de teclado

En el caso de los campos de entrada de texto que controla un método de entrada de teclado virtual en pantalla (o IME), como EditText, las aplicaciones deben comportarse según lo previsto. (Clase EditText en la documentación de Android).

En el caso de las pulsaciones de teclas que el marco no pueda prever, las aplicaciones tendrán que controlar el comportamiento por sí mismas. Si esto ya se ha implementado en la aplicación, no se requiere ningún trabajo adicional.

Por ejemplo, es posible que algunos juegos ya admitan el movimiento facilitado mediante el teclado, a través de las teclas w, a, s, d, junto con la entrada táctil.

A continuación encontrará las entradas de teclado para las que los desarrolladores deben tener en cuenta las actualizaciones de código al compilar para dispositivos con Windows 11:

  • Tecla ENTRAR
  • Navegación con las teclas de flecha y la tecla de tabulación
  • Cambiar el color resaltado del elemento seleccionado
  • Métodos abreviados basados en CTRL

Consulte la documentación de Android para obtener más información sobre la optimización para estos escenarios de entrada del teclado en dispositivos de escritorio:

Entrada de mouse

Los desarrolladores deben considerar la posibilidad de actualizar el código de las siguientes entradas del mouse al compilar para dispositivos Windows:

  • Clic con el botón derecho
  • Información sobre herramientas/mantener el puntero sobre el texto
  • Efectos de mantener el puntero
  • Acción de la rueda de desplazamiento del mouse
  • Arrastrar y colocar

La entrada del mouse, de manera similar a la entrada del teclado, debe seguir las directrices oficiales para aplicaciones de Android. Esto significa usar la clase InputDevice emparejada con la constante SOURCE_MOUSE. Consulte la documentación de Android para obtener más información sobre la optimización para estos escenarios de entrada del mouse en dispositivos de escritorio:

Administración y redimensionamiento de ventanas

A diferencia de los factores de forma móviles tradicionales, las aplicaciones de Android que se ejecutan en Windows 11 se pueden redimensionar libremente, deben tener capacidad de respuesta en su cambio de tamaño, y se pueden ajustar mediante acciones o gestos de Windows.

Requisito mínimo de pantalla

Windows 11 aplica un requisito mínimo de pantalla con una resolución de 720p (1280×720) con una pantalla de más de >9".

Formatos letterbox y pillarbox

Cuando la relación de aspecto del tamaño de un ventana no se alinea entre los tamaños de pantalla del dispositivo en el que se muestra la ventana, el resultado puede ser el formato letterbox (la ventana es más ancha que alta, u horizontalmente más larga) o pillarbox (la ventana es más estrecha que el ancho, o verticalmente más larga). Como consecuencia, se colocan barras a los lados de la ventana para centrarla. Estas barras pueden ser de color claro u oscuro, en función de la configuración del sistema seleccionada. Esto solo tendrá lugar cuando la aplicación de Android se ajuste o maximice, lo que permite a las aplicaciones de Android aprovechar las características de ajuste enriquecidas en Windows e integrarlas en el modelo basado en ventanas.

Ejemplo de formatos letterbox y pillarbox que muestran barras en blanco que centran la ventana

Consideraciones adicionales sobre el redimensionamiento

También se debe tener en cuenta lo siguiente al actualizar una aplicación de Android para que se ejecute en un dispositivo con Windows 11 con respecto a la administración y el redimensionamiento de ventanas:

  • Tamaño de inicio original
  • Dimensiones de la ventana
    • Límites del contenido
    • Tamaño de forma libre
  • Orientación de la pantalla

Para obtener más información sobre la optimización para los escenarios de cambio de tamaño de las ventanas en dispositivos de escritorio, siga la guía de administración de ventanas en la documentación de Android.

Pruebas y depuración

Para probar y depurar la aplicación en un dispositivo con Windows 11 mediante Windows Subsystem for Android, se requieren los siguientes pasos de configuración.

Habilitación del modo de desarrollador en Configuración de Windows

Primero tiene que habilitar el modo de desarrollador en Configuración de Windows. Hay tres maneras de habilitar el modo de desarrollador:

Conexión a Windows Subsystem for Android para depuración

Para conectar el Subsistema de Windows para Android para la depuración:

  1. Para obtener la dirección IP, abra la aplicación Configuración del Subsistema de Windows para Android. (Use la búsqueda de Windows para seleccionar e iniciar).

  2. La dirección IP se mostrará en la sección Dirección IP. Si no se muestra ninguna dirección IP, inicie una aplicación de Android que se haya instalado mediante Amazon Appstore y, a continuación, seleccione Actualizar en el botón Dirección IP de la aplicación Configuración.

  3. Ahora que tiene la dirección IP para conectarse al Subsistema de Windows para la máquina virtual Android, en el terminal o Powershell, puede conectarse mediante adb connect (debe tener adb instalado):

    adb connect 172.22.137.166
    

Conexión a un dispositivo de prueba

Para conectarse a un dispositivo de prueba (con Windows Subsystem for Android instalado) en la misma red desde Windows/Mac:

  1. En el dispositivo de prueba (donde está instalado Windows Subsystem for Android), abra una ventana de PowerShell y ejecute el comando a continuación para identificar la dirección IP del dispositivo de prueba:

    ipconfig
    
  2. Mediante el terminal del dispositivo de depuración donde Android Studio y Android SDK están instalados (Mac/Windows), escriba el comando:

    adb connect <TEST DEVICE IP ADDRESS>:58526
    

<TEST DEVICE IP ADDRESS> se puede encontrar en la salida de "ipconfig" desde el dispositivo de prueba. También puede implementar y depurar aplicaciones desde Android Studio.

Para usar Android Debug Bridge (ADB) para conectar la estación de trabajo de desarrollo directamente al dispositivo Android para que pueda instalar paquetes y evaluar los cambios, consulte Android Debug Bridge en la documentación del Proyecto de código abierto de Android.

Depurar la aplicación

Aunque las aplicaciones deben instalarse mediante Amazon Appstore, la depuración de una aplicación Android en un dispositivo Windows es posible mediante un APK (paquete de aplicaciones Android) y adb (Android Debug Bridge).

Para depurar un APK mediante adb:

  1. Siga los pasos anteriores para conectarse a la VM de Windows Subsystem for Android.

  2. Instale el APK mediante el comando adb install: adb install app-debug .apk.

    Salida esperada:

    Performing Streamed Install
    Success
    
  3. Aparecerá una notificación con el mensaje "aplicación instalada" en el menú de notificaciones de Windows, y la aplicación se iniciará una vez que se seleccione.

Creación de APK universales

El subsistema de Windows para Android usa la tecnología de Intel Bridge para emular aplicaciones de ARM en procesadores basados en x86. Por supuesto, las aplicaciones de ARM se ejecutarán en procesadores basados en ARM de forma nativa. La capa de emulación provocará una sobrecarga de rendimiento: para obtener un rendimiento óptimo, envíe la aplicación para las arquitecturas x86-64 y ARM64.

Consideraciones sobre el ciclo de vida de las VM

Windows Subsystem for Android usa una máquina virtual (VM) que proporciona compatibilidad con el marco de AOSP y dispositivos como teclados, mouse, táctiles, lápices, etc.

Una VM que ejecuta aplicaciones con Windows Subsystem for Android puede tener tres estados posibles:

  1. En ejecución
  2. Lightweight Doze (Suspensión ligera): Se activa después de que no haya actividad de aplicación durante 3 minutos. Se desactiva con la actividad del usuario o una notificación de la aplicación.
  3. No en ejecución: Se activa después de que no haya actividad de aplicación durante 7 minutos.

La actividad del usuario desencadena las transiciones entre estos estados, como el inicio o la interacción con la aplicación de Android o una notificación de la aplicación. Las aplicaciones de Android se pausan y luego se detienen cuando se minimiza su ventana.

Gráfico del ciclo de vida de una VM, que muestra los estados de ejecución, suspensión ligera y no en ejecución

Propiedades de máquina virtual

A continuación se enumeran las propiedades de la VM de Windows Subsystem for Android. No se recomienda codificar estos valores de forma rígida, ya que podría provocar incompatibilidades futuras.

Propiedad Value
Build.MANUFACTURER Microsoft Corporation
Build.MODEL Subsystem for Android
Build.VERSION.SDK_INT 30
Build.BOARD Windows

Seguridad

Windows Subsystem for Android realiza un cifrado por archivo, basado en software.

Tanto los controladores Windows en modo kernel como las aplicaciones de Windows que se ejecutan en el nivel de integridad (IL) medio pueden inspeccionar contenedores arbitrarios de Android y la memoria de las aplicaciones de Android. No hay ningún plan para agregar detección de comportamientos sospechosos, macro, bots o engaños a corto plazo.

Los desarrolladores que consulten getSecurityLevel obtendrán SECURITY_LEVEL_SW_SECURE_CRYPTO. Obtenga más información sobre getSecurityLevel en la guía de referencia de API de Android.

Desinstalación de Windows Subsystem for Android

Puede desinstalar Windows Subsystem for Android, pero tenga en cuenta que también se desinstalarán todas las aplicaciones asociadas.

  • Si desinstala Amazon Appstore, se desinstalarán el Subsistema de Windows para Android y todas las demás aplicaciones de Android.
  • La desinstalación de una aplicación de Amazon Appstore solo desinstalará la aplicación (el mismo comportamiento que para las aplicaciones de Windows).
  • Si desinstala el Subsistema de Windows para Android, se desinstalarán Amazon Appstore y todas las aplicaciones de Android.

Solución de problemas

Si encuentra problemas específicos de Amazon Appstore en Windows, pruebe los siguientes pasos de solución de problemas:

  1. Seleccione la búsqueda de Windows en la barra de tareas de Windows.
  2. Busque "Amazon Appstore" y haga clic con el botón derecho en el icono de Amazon Appstore.
  3. Seleccione "Aplicación Configuración" en las opciones de la lista desplegable.
  4. Seleccione "Almacenamiento y caché" y haga clic en "Clear Storage" (Borrar almacenamiento) y "Borrar caché".
  5. Vuelva y seleccione "Force Stop" (Forzar detención).
  6. Cierre la ventana de Configuración de Amazon Appstore.
  7. Vuelva a iniciar Amazon Appstore.

Para obtener más pasos de solución de problemas relacionados con la aplicación Configuración del Subsistema de Windows para Android o para dejar comentarios desde el Centro de opiniones, consulte Solución de problemas y preguntas más frecuentes de aplicaciones móviles en Windows.

Para cualquier otra pregunta y soporte técnico para desarrolladores, use la etiqueta de Subsistema de Windows para Android en Microsoft Q&A.

Nota

Actualmente en Subsistema de Windows para Android, no se admite la funcionalidad Bluetooth, como el examen de dispositivos BLE.

Recursos adicionales