Nota: El Formato de Caras de Relojes es obligatorio para que las caras de reloj se instalen en dispositivos con Wear OS 5 o versiones posteriores preinstaladas y para todas las caras de reloj nuevas que se publiquen en Google Play.
A partir de enero de 2026, el Formato de Caras de Relojes será obligatorio para que las caras de reloj se puedan instalar en todos los dispositivos Wear OS.
Obtén más información sobre los cambios para los usuarios en este artículo del Centro de ayuda.
Una cara de reloj es lo primero que ve un usuario cuando mira su reloj, lo que la convierte en la plataforma de Wear OS más usada. Los usuarios dependen de las caras de reloj para personalizar sus relojes según su estilo y obtener información rápida de un vistazo.
Opciones para crear caras de reloj
El formato de cara de reloj (WFF) hace que crear una cara de reloj sea más fácil que nunca. El Formato de Caras de Relojes se creó en asociación con Samsung; es un formato XML declarativo que permite configurar la apariencia y el comportamiento de las caras de reloj. A diferencia de otras APIs de caras de reloj, en las que tu APK debe incluir el código para renderizar la cara de reloj, el Formato de Caras de Relojes solo requiere recursos e instrucciones declarativas. La plataforma de Wear OS se encarga de la lógica necesaria para renderizar la cara de reloj y que puedas enfocarte en tus ideas creativas, en lugar de hacerlo en la optimización del código o el rendimiento de la batería.
Proporcionamos varias formas de crear una cara de reloj:
- Si prefieres una herramienta de estilo WYSIWYG que te permita diseñar la cara de reloj directamente, usa Watch Face Studio, que admitimos en asociación con Samsung.
- Si te sientes cómodo usando Figma como diseñador o si quieres acelerar los primeros pasos para crear una cara de reloj como desarrollador, usa Watch Face Designer, al que puedes acceder con un complemento dentro de Figma.
Si prefieres administrar la configuración del reloj de forma manual y publicar en tu propia tienda de aplicaciones, puedes definir caras de reloj con XML y, luego, publicarlas con Watch Face Push.
Android Studio también incluye compatibilidad para compilar y ejecutar caras de reloj que usan el Formato de Caras de Relojes.
Las caras de reloj creadas con este formato requieren menos mantenimiento y menos actualizaciones que las que se compilan con las bibliotecas heredadas de caras de reloj de Jetpack. Por ejemplo, no es necesario que actualices la cara de reloj para aprovechar las mejoras en el rendimiento o el consumo de batería, ni para obtener las correcciones de errores más recientes.
Información acerca del formato
En el centro de una cara de reloj con el Formato de Caras de Relojes (WFF) se encuentra un documento que define el diseño y el comportamiento de la cara de reloj. Este documento está escrito en XML, de conformidad con la especificación de WFF.
El sistema Wear OS incluye un componente de renderización de caras de reloj. Este componente analiza tu documento XML de WFF y renderiza una cara de reloj a partir de él. Otros recursos, como imágenes y fuentes, se incorporan según sea necesario.
Con este enfoque, solo necesitas dedicar tiempo a describir cómo debería verse la cara de reloj, y Wear OS se encarga de todo el código para dibujarla.
Para implementar una cara de reloj con el Formato de Caras de Relojes en un dispositivo, empaqueta el documento XML en un paquete AAB o APK estándar.
En el siguiente diagrama, se muestra una descripción general del enfoque:
Control de versiones en WFF
A medida que evoluciona el WFF, se agregan funciones adicionales, representadas por más elementos, atributos y fuentes de datos que usan el Formato de Caras de Relojes.
Por ejemplo, la versión 2 de WFF introdujo la compatibilidad con el clima como fuente de datos, que no está disponible en la versión 1 de WFF.
Cuando diseñes tu cara de reloj, ten en cuenta qué funciones quieres usar y la disponibilidad de sus versiones. La guía de referencia marca todas las funciones con su disponibilidad.
Cada versión de WFF se alinea con una versión de Wear OS:
| Versión de WFF | Versión mínima de Wear OS | Nivel mínimo de API |
|---|---|---|
| 1 | 4 | 33 |
| 2 | 5 | 34 |
| 3 | 5.1 | 35 |
| 4 | 6 | 36 |
Consulta esta guía para configurar correctamente tu archivo de compilación de AndroidManifest.xml y Gradle.
Más información
Obtén más información sobre el Formato de Caras de Relojes en estas guías:
- Funciones disponibles: Explora las capacidades de las caras de reloj que admite cada versión del Formato de Caras de Relojes.
- Lineamientos de diseño: Descubre prácticas recomendadas para el diseño y la experiencia del usuario de tu cara de reloj.
- Watch Face Designer: Aprende a usar el complemento de Figma para crear tu cara de reloj.
- Configuración: Configura un Android App Bundle que admita el Formato de Caras de Relojes.
- Muestras de GitHub: Comienza a crear caras de reloj de ejemplo y, luego, impleméntalas en el emulador de Wear OS o en tu dispositivo físico.
- Optimiza el uso de memoria: Obtén más información para configurar la cara de reloj de modo que el sistema consuma la menor cantidad de memoria posible durante la renderización.
- Referencia de XML: Explora los elementos individuales que forman parte de un archivo de Formato de Caras de Relojes. El elemento raíz siempre es
WatchFace. Nota: Para ver las funciones de una versión específica del formato de caras de relojes en la referencia XML, verifica que el botón de la versión correspondiente esté seleccionado en la parte superior de la página de documentación. - Guía de publicación: Aprende a publicar y monetizar tu cara de reloj a través de Play Store y otros métodos.
- Validador de WFF y memoria: Usa estas herramientas de código abierto para verificar si hay errores en tu archivo de formato de cara de reloj y confirmar el uso aceptable de la memoria antes de enviarlo a Google Play.