Cómo actualizar a la versión más reciente de Wear OS

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Cómo actualizar desde Wear 2.0

En esta guía, se describe el proceso de actualización de Wear OS.

Cambios específicos en Android

Wear 2.0 abarca varias versiones de Android desde el nivel de API 25 hasta el 28.

Nota: No hay una versión de Wear OS para Android 10 (nivel de API 29).

Si tu app para Wear OS se orienta a Wear OS 2.0 (nivel de API 28), la mayor parte del trabajo para actualizar es controlar los cambios de plataforma de Android 9 (nivel de API 28) a Android 11 (nivel de API 30).

No hay una versión de Wear OS para Android 10 (nivel de API 29), por lo que debes controlar todos esos cambios a la vez cuando cambias los campos compileSdkVersion y targetSdkVersion de 28 a 30.

Nota: Incluso si no cambia el elemento compileSdkVersion o targetSdkVersion en la app, asegúrate de que esta sea compatible con el nivel de API 29.

Cambios específicos en Wear OS

En Wear OS 2.0, existen tarjetas, complicaciones, superposiciones, caras de reloj y muchas otras plataformas. Sin embargo, debes revisar tu interfaz de usuario para incorporar nuestros últimos lineamientos de diseño.

Si estás usando la API de cara de reloj actual (que no es de Jetpack), la API de LegacyWatchFaceOverlayStyle no funcionará en el nivel de API 30 de Wear OS.

El nivel de API 30 incluye la API de Ongoing Activity.

Una actividad en curso permite que aparezca una notificación en curso en plataformas adicionales dentro de la interfaz de usuario de Wear OS, lo que permite a los usuarios mantener una mayor participación con actividades prolongadas.

Nota: Algunas funciones de las nuevas APIs de caras de reloj en etapa alfa solo están disponibles en dispositivos con nivel de API 30 o superior.

Elige una versión para comenzar

Como se indica en la sección Cambios específicos de Android, la versión de Wear OS está vinculada a una versión de Android. Ten en cuenta qué dispositivos Wear OS son los más comunes cuando eliges una versión para comenzar.

La mayoría de los desarrolladores compilan una app sólida orientada al nivel de API 30, pero dejan la versión minSdkVersion lo suficientemente baja como para orientar su contenido a las versiones más comunes de Android. Por ejemplo, para permitir la compatibilidad con dispositivos Wear 2.0, establece minSdkVersion en 25.

Si tienes experiencia con el desarrollo de Android, gran parte de ese conocimiento se aplica a Wear OS. Para obtener información sobre las diferencias, consulta Diferencias entre el desarrollo para Wear OS y el desarrollo para dispositivos móviles.

Nota: Actualmente, la imagen del sistema emulador de Wear OS en el nivel de API 30 se encuentra en la Vista previa para desarrolladores. Consulta las notas de la versión para conocer las actualizaciones más recientes.

Bibliotecas de Jetpack para Wear OS

Las bibliotecas de Jetpack para Wear OS son cinco bibliotecas que contienen una funcionalidad similar a la de compatibilidad con dispositivos wearables y una mejor compatibilidad con Wear OS 3.

Las bibliotecas de Jetpack para Wear OS son reemplazos de las bibliotecas de compatibilidad con dispositivos wearable y no están diseñadas para usarse en conjunto. La Biblioteca de compatibilidad para wearables no funciona en Wear OS 3.

Para obtener más información, consulta Las bibliotecas de Wear OS Jetpack ahora son estables.