Creare ed eseguire il deployment di un quadrante

Questa pagina descrive la struttura dei quadranti che utilizzano Watch Face Format, nonché come crearli ed eseguirli.

La struttura dei quadranti 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 di altre app, come la necessità di un file AndroidManifest.xml, ma hanno una struttura specifica.

1. Tutti i contenuti del quadrante si trovano nella cartella delle risorse, ovvero res/
2. Tutte le definizioni dei quadranti sono in res/raw/, inclusi res/raw/watchface.xml e qualsiasi altra definizione XML che rappresenti il supporto di diverse dimensioni del dispositivo.
3. Tutte le risorse necessarie al quadrante si trovano nella cartella delle risorse appropriata, proprio come per le applicazioni normali, ad esempio:
   1. /res/font per i caratteri
   2. /res/drawable per gli asset immagine e animazione
   3. /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 e a eseguire il debug delle definizioni XML.

Le funzionalità specifiche includono:

• Completamento del codice per tag e attributi in base agli schemi di formato ufficiali di Watch Face.
• Convalida in tempo reale per identificare attributi mancanti ed errori di sintassi simili.
• Il collegamento delle risorse, che consente di passare rapidamente alle risorse disegnabili, alle origini dati e ad 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.

Controllare 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.

Un 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.