Remarque : Le Watch Face Format est obligatoire pour que les cadrans puissent être installés sur les appareils avec Wear OS 5 ou version ultérieure préinstallée, et pour tous les nouveaux cadrans publiés sur Google Play.
À partir de janvier 2026, le Watch Face Format sera obligatoire pour que les cadrans puissent être installés sur tous les appareils Wear OS.
Pour en savoir plus sur les modifications visibles par les utilisateurs, consultez cet article du Centre d'aide.
Le cadran est la première chose que voit un utilisateur lorsqu'il regarde sa montre, ce qui en fait la surface la plus utilisée sur Wear OS. Les utilisateurs y ont recours pour personnaliser leur montre en fonction de leur style et obtenir rapidement des informations en un clin d'œil.
Options de création de cadrans
Le format Watch Face (WFF) permet de créer des cadrans plus facilement que jamais. Créé en partenariat avec Samsung, le Watch Face Format est un format XML déclaratif permettant de configurer l'apparence et le comportement des cadrans. Contrairement aux autres API de cadran, où votre APK doit inclure le code permettant d'afficher le cadran, le Watch Face Format ne nécessite que des ressources et des instructions déclaratives. La plate-forme Wear OS gère la logique nécessaire à l'affichage du cadran. Vous pouvez ainsi vous concentrer sur vos idées de création plutôt que sur l'optimisation du code ou les performances de la batterie.
Nous proposons plusieurs façons de créer un cadran :
- Si vous préférez un outil WYSIWYG (What-You-See-Is-What-You-Get) qui vous permet de concevoir directement le cadran, utilisez Watch Face Studio, que nous prenons en charge en partenariat avec Samsung.
- Si vous êtes à l'aise avec Figma en tant que concepteur ou si vous souhaitez accélérer les premières étapes de la création d'un cadran en tant que développeur, utilisez Watch Face Designer, auquel vous accédez à l'aide d'un plug-in dans Figma.
Si vous préférez gérer manuellement la configuration de votre montre et publier sur votre propre plate-forme de téléchargement d'applications, vous pouvez définir des cadrans à l'aide d'XML, puis les publier à l'aide de Watch Face Push.
Android Studio permet également de compiler et d'exécuter des cadrans qui utilisent le Watch Face Format.
Les cadrans créés avec ce format nécessitent moins de maintenance et moins de mises à jour que ceux créés à l'aide des anciennes bibliothèques Jetpack Watch Face. Par exemple, vous n'avez pas besoin de mettre à jour votre cadran pour bénéficier des améliorations des performances ou de l'utilisation de la batterie, ni pour obtenir les dernières corrections de bugs.
À propos de ce format
Au cœur d'un cadran au format Watch Face Format (WFF) se trouve un document qui définit la mise en page et le comportement du cadran. Ce document est rédigé en XML, conformément à la spécification WFF.
Le système Wear OS inclut un composant de rendu de cadran. Ce composant analyse votre document XML WFF et affiche un cadran à partir de celui-ci. D'autres ressources, telles que les images et les polices, sont extraites si nécessaire.
Cette approche signifie que vous n'avez qu'à décrire l'apparence du cadran, et Wear OS gère tout le code pour dessiner le cadran.
Pour déployer un cadran au format Watch Face Format sur un appareil, packagez le document XML dans un package AAB ou APK standard.
Le schéma suivant présente une vue d'ensemble de cette approche :
Gestion des versions dans WFF
Au fur et à mesure que le WFF évolue, des fonctionnalités supplémentaires sont ajoutées, représentées par davantage d'éléments, d'attributs et de sources de données qui utilisent tous le Watch Face Format.
Par exemple, la version 2 de WFF a introduit la prise en charge de la météo en tant que source de données, ce qui n'est pas disponible dans la version 1 de WFF.
Lorsque vous concevez votre cadran, tenez compte des fonctionnalités que vous souhaitez utiliser et de la disponibilité de leur version. Le guide de référence indique la disponibilité de toutes les fonctionnalités.
Chaque version de WFF correspond à une version de Wear OS :
| Version WFF | Version minimale de Wear OS | Niveau d'API minimal |
|---|---|---|
| 1 | 4 | 33 |
| 2 | 5 | 34 |
| 3 | 5.1 | 35 |
| 4 | 6 | 36 |
Consultez ces conseils pour configurer correctement votre fichier de compilation AndroidManifest.xml et Gradle.
En savoir plus
Pour en savoir plus sur le Watch Face Format, consultez les guides suivants :
- Fonctionnalités disponibles : découvrez les fonctionnalités de clock face compatibles avec chaque version du Watch Face Format.
- Consignes de conception : découvrez les bonnes pratiques concernant la mise en page du cadran et l'expérience utilisateur.
- Watch Face Designer : découvrez comment utiliser le plug-in Figma pour créer votre cadran.
- Configuration : configurez un Android App Bundle qui prend en charge le Watch Face Format.
- Exemples GitHub : commencez à créer des exemples de cadrans et à les déployer sur l'émulateur Wear OS ou sur votre appareil physique.
- Optimisez l'utilisation de la mémoire : découvrez comment configurer votre cadran pour que le système consomme le moins de mémoire possible lors de son affichage.
- Référence XML : explorez les éléments individuels qui font partie d'un fichier Watch Face Format. L'élément racine est toujours
WatchFace. Remarque : Pour afficher les fonctionnalités d'une version spécifique de Watch Face Format dans la référence XML, assurez-vous que le bouton de la version appropriée est sélectionné en haut de la page de documentation. - Guide de publication : découvrez comment publier et monétiser votre cadran sur le Play Store et par d'autres méthodes.
- Validateur de format de cadran et de mémoire : utilisez ces outils Open Source pour vérifier que votre fichier au format de cadran ne contient pas d'erreurs et pour confirmer que l'utilisation de la mémoire est acceptable avant de l'envoyer à Google Play.