Créer et déployer un cadran

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. Ils partagent donc de nombreux attributs communs avec les autres applications, comme la nécessité d'un fichier AndroidManifest.xml, mais ils ont une structure spécifique.

  1. Tout le contenu du cadran se trouve dans le dossier des ressources, à savoir res/.
  2. Toutes les définitions de cadrans se trouvent dans res/raw/, y compris res/raw/watchface.xml et toutes les autres définitions XML qui représentent la compatibilité avec différentes tailles d'appareils.
  3. Toutes les ressources nécessaires au cadran se trouvent dans le dossier de ressources approprié, comme pour les applications classiques. Par exemple :
    1. /res/font pour les polices
    2. /res/drawable pour les composants Image et Animation
    3. /res/values/strings.xml pour toutes les ressources de chaîne

Créer le cadran à l'aide d'Android Studio

Android Studio est compatible avec le format Watch Face pour vous aider à écrire et à déboguer vos définitions XML.

Prise en charge du format Watch Face dans Android Studio.

Voici quelques exemples de fonctionnalités :

  • Complétion automatique du 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.
  • L'association de ressources, qui permet d'accéder rapidement aux ressources dessinables, aux sources de données et à d'autres éléments référencés dans le fichier XML.
  • 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 découvrir comment utiliser Gradle pour créer le 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 avant l'envoi sur l'AAB de votre cadran avant de l'envoyer sur Play.

Play effectue des vérifications très similaires. Par conséquent, si vous réussissez ces vérifications avant l'envoi, vous gagnerez beaucoup de temps lors du processus d'envoi et d'examen.

Voici un exemple d'exécution des vérifications avant l'envoi :

Ces vérifications ne se limitent pas à inspecter la quantité de mémoire utilisée par le cadran, mais identifient également d'autres problèmes, tels que les ressources manquantes, et valident le fichier XML.

Pour savoir comment obtenir et compiler l'outil, consultez Évaluateur d'empreinte mémoire.