Windows Subsystem for Android™️

Artículo
03/05/2024

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.

Importante

Microsoft está finalizando la compatibilidad con el subsistema de Windows para Android™️ (WSA). Por lo tanto, Amazon Appstore en Windows y todas las aplicaciones y juegos dependientes de WSA dejarán de recibir soporte a partir del 5 de marzo de 2025. Hasta entonces, el soporte técnico seguirá estando disponible para los clientes.
Los clientes que hayan instalado las aplicaciones de Amazon Appstore o Android antes del 5 de marzo de 2024 seguirán teniendo acceso a dichas aplicaciones hasta la fecha de desuso del 5 de marzo de 2025. Si tiene más preguntas, póngase en contacto con nuestro equipo de soporte técnico en support.microsoft.com. Agradecemos el apoyo de nuestra comunidad de desarrolladores y seguimos comprometidos a escuchar sus comentarios a medida que evolucionamos las experiencias.

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

Enviar la aplicación a Amazon AppStore.

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

Regístrese para obtener actualizaciones en Amazon AppStore en el programa de Windows.
Visite el portal de soporte técnico para desarrolladores de Amazon, donde puede encontrar artículos, foros, preguntas más frecuentes o ponerse en contacto con el soporte técnico directo a través de la página "Póngase en contacto con nosotros" de Appstore una vez que haya configurado una cuenta de desarrollador de Amazon.

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

Configurar el entorno de desarrollo, incluidos los requisitos previos, la instalación de Amazon Appstore y el uso de la Configuración.
Probar y depurar una aplicación en un dispositivo con Windows 11.
Controlar las consideraciones de compatibilidad de dispositivos Windows, por ejemplo: la entrada de teclado, la entrada del mouse y la administración y redimensionamiento de ventanas.
Solucionar problemas y encontrar respuestas.

GitHub para desarrolladores

¿Quiere obtener más información sobre el subsistema de Windows para Android™️ hoja de ruta, analice los problemas de desarrollador y los errores de archivo o las solicitudes de características con el equipo del subsistema? Visite el Subsistema de Windows para Android™️ Desarrolladores de GitHub.

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.

Requisitos previos

Subsistema de Windows para Android™️ está disponible en Windows 11. El dispositivo debe cumplir requisitos específicos: Requisitos del dispositivo.

Instalación de Amazon Appstore

Microsoft Store instalará automáticamente subsistema de Windows para Android™️ en segundo plano cuando se realicen cualquiera de las dos acciones de usuario siguientes:

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

A continuación, la aplicación Amazon Appstore aparecerá en el menú Inicio de Windows 11 y estará disponible en la búsqueda, lo que ofrece un catálogo de aplicaciones de Android. La subsistema de Windows para Android™️ aplicación, que permite controlar la configuración y las características de la aplicación móvil, también aparecerá en el menú Inicio.

Screenshot of Microsoft Store page featuring the Get button on the Amazon App Store

Nota:

Amazon AppStore en Windows (un requisito para ejecutar aplicaciones Android en Windows 11) está disponible en regiones seleccionadas.

Configuración del Subsistema de Windows para Android™️

Para modificar el Subsistema de Windows para Android™️ configuración, vaya a: Iniciar > Todas las aplicaciones > 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.

Screenshot of Latte app settings

Pruebas y depuración

Para probar y depurar la aplicación en un dispositivo Windows 11 mediante el Subsistema de Windows para 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. Abra la configuración del Subsistema de Windows para Android™️. Una vez abierto, habilite el modo desarrollador en Configuración avanzada.

Conectarse al Subsistema de Windows para Android™️ para la depuración

Para conectarse al subsistema de Windows para Android️™máquina virtual para la depuración:

Inicie una aplicación Android que se instaló con Amazon Appstore.
Puede conectarse mediante adb connect con el siguiente comando (debe tener instalado adb):
```
adb connect 127.0.0.1:58526
```

Conexión a un dispositivo de prueba

Para conectarse a un dispositivo de prueba (con subsistema de Windows para Android™️ instalado) en la misma red desde Windows/Mac:

En el dispositivo de prueba (donde está instalado el Subsistema de Windows para Android️™) abra una ventana de PowerShell e identifique la dirección IP del dispositivo de prueba ejecutando el comando :
```
ipconfig
```
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:

Siga los pasos para conectarse al subsistema de Windows para Android™️ máquina virtual anterior.
Instale el APK mediante el comando adb install: adb install app-debug.apk.

Salida esperada:
```
Performing Streamed Install
Success
```
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

Subsistema de Windows para Android™️ utiliza la tecnología Intel Bridge para habilitar aplicaciones 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 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.

Letterboxing and Pillarboxing example showing blank bars that center the window

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.

Eventos del ciclo de vida de aplicaciones

El desarrollo de aplicaciones Android en entornos de varias ventanas afecta a los eventos de ciclo del vida que decida usar en la aplicación. Aunque la invalidación del evento onPause puede lograr los resultados deseados en un teléfono o tableta, es normalmente el evento incorrecto que se usará si cambia la experiencia de usuario de la aplicación.

Consulte la documentación de Android para ver una descripción de los eventos del ciclo de vida. La mayoría de las veces, le interesará usar el evento onStop y no los eventos onPause o onUserLeaveHint. De hecho, muchas implementaciones de Android de varias ventanas no entregan la notificación de onUserLeaveHint y, por tanto, cualquier lógica crítica para la empresa que pueda estar en ese controlador de eventos no se llamará en estas plataformas, incluido el Subsistema de Windows para Android™️.

Consideraciones sobre el ciclo de vida de las VM

Subsistema de Windows para Android™️ utiliza una máquina virtual (VM) que proporciona compatibilidad con el marco de AOSP de y dispositivos como teclados, ratones, toques, lápiz, etc.

Hay tres estados posibles para la máquina virtual que ejecuta aplicaciones con subsistema de Windows para Android™️:

En ejecución
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.
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.

VM lifecycle graph showing the running, lightweight doze, and not running

Propiedades de máquina virtual

Las propiedades del Subsistema Windows para Android™️ VM se enumeran a continuación. 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(TM)
Build.VERSION.SDK_INT	33
Build.BOARD	windows

Redireccionamiento a aplicaciones de Windows

Subsistema de Windows para Android™️ redirige automáticamente las intenciones de archivos y esquemas URI comunes al controlador de protocolo o archivo predeterminado de Windows correspondiente (si coinciden varios filtros de intención, los usuarios ven una opción "Aplicación predeterminada de Windows" en el cuadro de diálogo del selector). Las intenciones de archivo admitidas incluyen ACTION_VIEW, ACTION_EDIT, ACTION_SENDy ACTION_SEND_MULTIPLE, que copian el archivo en la carpeta Descargas de Windows antes de abrirlo. Las intenciones de URI admitidas incluyen ACTION_VIEW para los esquemas http/https y ACTION_VIEW y ACTION_SENDTO para el esquema mailto.

Las aplicaciones android también pueden redirigir manualmente a las aplicaciones de Windows mediante esquemas de URI personalizados. Establezca la acción de intención en com.microsoft.windows.LAUNCH_URI y agregue una cadena adicional a la intención denominada com.microsoft.windows.EXTRA_URI con el URI personalizado como valor. Por ejemplo, para iniciar la aplicación Calculadora de Windows desde una aplicación Android (Java):

Intent intent = new Intent("com.microsoft.windows.LAUNCH_URI");
intent.putExtra("com.microsoft.windows.EXTRA_URI", "ms-calculator:");
 
try {
    startActivity(intent);
} catch (ActivityNotFoundException e) {
    // Not running in Windows Subsystem for Android™️ (or running on an older build that did not contain this feature).
}

Seguridad

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 del subsistema de Windows para Android™️

Puede desinstalar el Subsistema de Windows para Android™️, pero tenga en cuenta que también se desinstalarán todas las aplicaciones asociadas.

Al desinstalar Amazon Appstore, se desinstalará 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).
Al desinstalar 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:

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

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

Para cualquier otra pregunta y soporte técnico para desarrolladores, usa la etiqueta Subsistema de Windows para Android™️ en Microsoft QA.