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 des informations rapides en un clin d'œil.
Audience
Notre nouveau format de cadran (WFF) permet de créer un cadran plus facilement que jamais. En partenariat avec Samsung, nous avons lancé Watch Face Studio, un outil de conception de cadran WYSIWYG qui vous permet de concevoir directement le cadran.
Si vous préférez gérer manuellement la configuration de votre montre, vous pouvez également définir des cadrans à l'aide de XML. Ces guides s'adressent aux développeurs qui utilisent le format XML ou qui créent des outils personnalisés pour créer des cadrans à l'aide du format de cadran. Android Studio permet également de créer et d'exécuter des cadrans qui utilisent le format de cadran.
Créé en partenariat avec Samsung, le format de cadran 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 pour afficher le cadran, le format de cadran 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.
Les cadrans créés avec ce nouveau 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 d'une meilleure efficacité énergétique, ni pour obtenir les dernières corrections de bugs.
À propos de ce format
Au cœur d'un cadran au format WFF (Watch Face Format) se trouve un document qui définit la mise en page et le comportement du cadran. Ce document est écrit 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 en affiche un cadran. D'autres ressources, telles que les images et les polices, sont extraites si nécessaire.
Cette approche vous permet de ne passer du temps qu'à décrire l'apparence du cadran, et Wear OS gère tout le code de dessin du cadran.
Pour déployer un cadran au format Watch Face sur un appareil, empaquetez 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
À mesure que le format WFF évolue, de nouvelles fonctionnalités sont ajoutées, représentées par de nouveaux éléments, attributs, sources de données, etc.
Par exemple, la version 2 de WFF a introduit 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 leur disponibilité en termes de 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 du fichier 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 format de cadran, consultez les guides suivants :
- Fonctionnalités disponibles: explorez les fonctionnalités de cadran compatibles avec chaque version du format de cadran.
- Consignes de conception: découvrez les bonnes pratiques concernant la mise en page du cadran et l'expérience utilisateur.
- Configuration: configurez un Android App Bundle qui accepte le format de cadran.
- Exemples GitHub: commencez par 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 de format de cadran. L'élément racine est toujours
WatchFace. Remarque: Pour afficher les fonctionnalités d'une version spécifique du format de cadran dans la référence XML, vérifiez 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 via le Play Store et d'autres méthodes.
- WFF et validateur de mémoire: utilisez ces outils Open Source pour rechercher des erreurs dans votre fichier de format de cadran et confirmer une utilisation acceptable de la mémoire avant de l'envoyer à Google Play.