Wear OS 5.1

Explora la versión más reciente de Wear OS, disponible en el emulador oficial de Android Studio. Verifica que tu app se ejecute como se espera después de actualizar la versión de SDK de destino.

Wear OS 5.1 se basa en Android 15 (nivel de API 35), lo que requiere que pruebes tus apps que ya se orientan al nivel de API 34 para Wear OS 5.

Prepara el emulador para las pruebas

Para ejecutar Wear OS 5.1 en el emulador oficial, primero debes descargar e instalar la imagen del sistema que se ejecuta en el emulador. Luego, debes crear un dispositivo virtual que ejecute esta imagen del sistema.

Descarga e instala la imagen del sistema

Para descargar e instalar la imagen del sistema correcta, completa los siguientes pasos:

  1. Descarga e instala la versión más reciente de Android Studio Meerkat si aún no lo hiciste.
  2. En Android Studio, haz clic en Tools > SDK Manager.

  3. En la pestaña SDK Platforms, expande la sección Android 15.0 ("VanillaIceCream") y selecciona Wear OS 5.1 - Preview ARM 64 v8a System Image o Wear OS 5.1 - Preview Intel x86_64 Atom System Image:

    "Las imágenes de compilación del emulador aparecen dentro del grupo de imágenes de compilación para el nivel de API 35 de Android"

  4. Haz clic en OK. Cuando aparezca la ventana Confirmar cambio, haz clic en Aceptar nuevamente.

  5. Espera a que Android Studio descargue e instale la imagen del sistema y, luego, haz clic en Finish.

Crea un dispositivo virtual

Para crear un dispositivo virtual que ejecute esta imagen del sistema en el emulador oficial, completa estos pasos:

  1. En Android Studio, selecciona Tools > Device Manager para abrir el Administrador de dispositivos. Aparecerá el panel Administrador de dispositivos.
  2. En la barra de herramientas del panel Device Manager, haz clic en Add a new device > Create Virtual Device.
  3. En el panel Form Factor, selecciona Wear OS y elige un perfil de hardware. Haz clic en Next.
  4. Selecciona una imagen del sistema de Wear OS 5.1 para usar. La imagen del sistema debe tener un nivel de API de 35.
  5. Haz clic en Siguiente y, luego, en Finalizar.

Cómo probar tu app en el emulador

Para probar tu app en este dispositivo virtual que creaste, sigue estos pasos:

  1. Ve a la barra de herramientas de Android Studio y selecciona el dispositivo virtual.
  2. Haz clic en Run .
  3. Instala tu app en el dispositivo virtual y navega por los diferentes flujos de trabajo orientados al usuario que usa tu app.

Cambios que afectan a todas las apps

Cuando pruebes tu app en Wear OS 5.1, verifica cómo controla los cambios de comportamiento del sistema que afectan a todas las apps en Android 15, que usa el mismo nivel de API que Wear OS 5.1.

Varios cambios de comportamiento no se aplican en Wear OS 5.1:

Actualiza la versión de destino del SDK de tu app

Puedes mejorar la compatibilidad de tu app con Wear OS 5.1 si actualizas la versión del SDK de destino a nivel de API 35. (este es el mismo nivel de API que usa Android 15).

Para ello, abre el archivo build.gradle o build.gradle.kts a nivel del módulo y actualízalos con valores para Wear OS 5.1.

La manera en que formateas los valores en tu archivo de compilación depende de la versión del complemento de Android para Gradle (AGP) que usas.

AGP 7.0.0 o versiones posteriores

Si usas AGP 7.0.0 o una versión posterior, actualiza el archivo build.gradle o build.gradle.kts de tu app con los siguientes valores para Wear OS 5.1:

Groovy

android {
    compileSdk 35
    ...
    defaultConfig {
        targetSdk 35
    }
}

Kotlin

android {
    compileSdk = 35
    ...
    defaultConfig {
        targetSdk = 35
    }
}

AGP 4.2.0 o versiones anteriores

Si usas AGP 4.2.0 o versiones anteriores, actualiza el archivo build.gradle o build.gradle.kts de tu app con los siguientes valores para Wear OS 5.1:

Groovy

android {
    compileSdkVersion "35"
    ...
    defaultConfig {
        targetSdkVersion "35"
    }
}

Kotlin

android {
    compileSdkVersion = "35"
    ...
    defaultConfig {
        targetSdkVersion = "35"
    }
}

Cambios que solo afectan a las apps orientadas al nivel de API 35

Después de actualizar la versión del SDK de destino al nivel de API 35, controla los cambios para las apps que se orientan a Android 15, que usa el mismo nivel de API que Wear OS 5.1.

Explora las funciones nuevas

Wear OS 5.1 presenta varias funciones para ayudarte a mejorar la experiencia de tu app para Wear OS.

Entre las funciones destacadas que puedes explorar, se incluyen las siguientes:

  • Compatibilidad con el Administrador de credenciales: La API de Credential Manager proporciona una solución de autenticación unificada que admite flujos de acceso con contraseñas, llaves de acceso e identidad federada (como Acceder con Google). Las credenciales de un usuario se almacenan en un proveedor de credenciales, que sincroniza la información de la cuenta en todos los dispositivos.
  • Reproducción a través de la bocina del reloj: En los dispositivos que admiten la reproducción de contenido multimedia a través de la bocina del reloj, los usuarios pueden seleccionar esta bocina como su opción de salida de contenido multimedia preferida si tu app se integra con el Selector de salida de Wear.

Notas de la versión

La imagen del sistema que está disponible en el emulador de Wear OS 5.1 tiene las siguientes características:

  • Fecha de lanzamiento: 19 de noviembre de 2024
  • ID de compilación: AP4A.241205.004.F1

Problemas conocidos

La imagen del sistema que contiene Wear OS 5.1 tiene los siguientes problemas conocidos:

  • El emulador no siempre permite que el usuario agregue una cuenta durante el flujo de configuración después de un restablecimiento del dispositivo.
  • Cuando se presiona una notificación, la app que la envió no se abre hasta que el usuario se desplaza por la pantalla.
  • A veces, los Servicios de salud para Wear no pueden iniciar un ejercicio.