Cette page décrit la structure des cadrans qui utilisent le Watch Face Format, ainsi que la façon de les créer et de les déployer.
Structure des cadrans WFF
Les cadrans au format Watch Face Format sont envoyés au Play Store sous forme d'AAB ou d'APK, comme n'importe quelle autre application. Bien qu'ils partagent de nombreux attributs communs avec d'autres applications, comme la nécessité d'un fichier AndroidManifest.xml, ils ont une structure spécifique.
- Tout le contenu du cadran se trouve dans le dossier de ressources, à savoir
res/. - Toutes les définitions de cadran se trouvent dans
res/raw/, y comprisres/raw/watchface.xmlet toutes les autres définitions XML qui représentent la compatibilité avec différentes tailles d'appareils. - Toutes les ressources nécessaires au cadran se trouvent dans le dossier de ressources approprié, comme pour les applications standards, par exemple :
/res/fontpour les polices/res/drawablepour les assets d'image et d'animation/res/values/strings.xmlpour toutes les ressources de chaîne
Créer le cadran à l'aide d'Android Studio
Android Studio fournit une assistance pour l'éditeur Watch Face Format afin de vous aider à écrire et à déboguer vos définitions XML.
Voici quelques-unes de ces fonctionnalités :
- Complétion de code pour les balises et les attributs en fonction des schémas officiels du format de cadran.
- Validation en direct pour identifier les attributs manquants et les erreurs de syntaxe similaires.
- Liaison de ressources, qui permet d'accéder rapidement aux ressources drawables, aux sources de données et aux autres éléments référencés dans le fichier XML.
- Une configuration d'exécution qui vous permet de voir votre cadran sur un appareil.
Créer le cadran à l'aide de Gradle
Le moyen le plus simple de comprendre comment utiliser Gradle pour créer un cadran est de consulter les exemples sur GitHub.
En plus de créer le cadran, les scripts Gradle de ces projets vérifient la validité du code XML du cadran à l'aide des outils de validation.
Vérifier le cadran avant de l'envoyer à Google Play
Une fois que vous avez créé votre cadran et que vous vous êtes familiarisé avec le processus de compilation, effectuez des vérifications préalables sur l'AAB de votre cadran avant de l'envoyer à Play.
Play effectue des vérifications très similaires. En vous assurant de réussir ces vérifications préalables, vous gagnerez un temps considérable lors du processus d'envoi et d'examen.
Exemple d'exécution des vérifications préalables à l'envoi :
Ces vérifications permettent non seulement d'inspecter la quantité de mémoire utilisée par le cadran, mais aussi d'identifier d'autres problèmes, tels que des ressources manquantes, et de valider le code XML.
Pour savoir comment obtenir et créer l'outil, consultez Memory Footprint Evaluator.