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 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 de ressources, à savoir res/.
  2. Toutes les définitions de cadrans se trouvent dans res/raw/, y compris res/raw/watchface.xml pour le cas simple et toutes les autres définitions XML qui représentent la prise en charge de 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 fournit une assistance pour l'éditeur Watch Face Format afin de 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 de code pour les balises et les attributs basée sur les 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 drawable, 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 sur 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 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 les ressources manquantes, et de valider le fichier XML.

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