Questa pagina descrive la struttura dei quadranti che utilizzano Watch Face Format, nonché come crearli e distribuirli.
La struttura dei quadranti orologio WFF
I quadranti orologio in formato Watch Face vengono inviati al Play Store come AAB o APK proprio come qualsiasi altra app. Pertanto, condividono molti degli attributi comuni delle altre app, come la necessità di un file AndroidManifest.xml
, ma hanno una struttura specifica.
- Tutti i contenuti del quadrante si trovano nella cartella delle risorse, ovvero
res/
- Tutte le definizioni dei quadranti sono in
res/raw/
, inclusires/raw/watchface.xml
per il caso semplice e qualsiasi altra definizione XML che rappresenti il supporto per diverse dimensioni del dispositivo. - Tutte le risorse necessarie al quadrante si trovano nella cartella delle risorse appropriata, proprio come per le applicazioni normali, ad esempio:
/res/font
per i caratteri/res/drawable
per gli asset immagine e animazione/res/values/strings.xml
per qualsiasi risorsa stringa
Crea il quadrante utilizzando Android Studio
Android Studio fornisce il supporto dell'editor per Watch Face Format per aiutarti a scrivere ed eseguire il debug delle definizioni XML.

Le funzionalità specifiche includono:
- Completamento del codice per tag e attributi in base agli schemi ufficiali del formato quadrante.
- Convalida in tempo reale per identificare attributi mancanti ed errori di sintassi simili.
- Il collegamento delle risorse, che consente di navigare rapidamente tra le risorse disegnabili, le origini dati e altri elementi a cui viene fatto riferimento nel file XML.
- Una configurazione di esecuzione che ti consente di vedere il quadrante orologio su un dispositivo.
Crea il quadrante utilizzando Gradle
Il modo più semplice per vedere la procedura di utilizzo di Gradle per creare il quadrante è dare un'occhiata agli esempi su GitHub.
Oltre a creare il quadrante, gli script Gradle in questi progetti controllano la validità dell'XML del quadrante utilizzando gli strumenti di convalida.
Controlla il quadrante prima dell'invio a Google Play
Dopo aver creato il quadrante e aver familiarizzato con la procedura di build, esegui i controlli pre-invio sul file AAB del quadrante prima di inviarlo a Google Play.
Play esegue controlli molto simili, quindi assicurarsi di superare questi controlli pre-invio consente di risparmiare molto tempo nella procedura di invio e revisione.
Esempio di esecuzione dei controlli pre-invio:
Questi controlli non solo esaminano la quantità di memoria utilizzata dal quadrante, ma identificano anche altri problemi, come le risorse mancanti, e convalidano l'XML.
Per informazioni dettagliate su come ottenere e creare lo strumento, consulta la pagina Memory Footprint Evaluator.