Formato quadrante

Un quadrante è la prima cosa che un utente vede quando guarda il proprio orologio, pertanto è la piattaforma più utilizzata di Wear OS. Gli utenti si affidano ai quadranti per personalizzare i propri smartwatch in base al proprio stile e per visualizzare rapidamente informazioni importanti.

Pubblico

Il nostro nuovo formato del quadrante (WFF) semplifica la creazione di un quadrante. In collaborazione con Samsung, abbiamo rilasciato Watch Face Studio, uno strumento che ti consente di progettare direttamente il quadrante in un'ottica di "quello che vedi è quello che ricevi".

Se preferisci gestire la configurazione dello smartwatch manualmente, puoi anche definire i quadranti utilizzando il linguaggio XML. Queste guide sono rivolte agli sviluppatori che utilizzano XML o che creano strumenti personalizzati per creare quadranti utilizzando il formato Watch Face. Android Studio include inoltre il supporto per la creazione e l'esecuzione di quadranti che utilizzano il formato Watch Face.

Creato in collaborazione con Samsung, Watch Face Format è un formato XML dichiarativo per configurare l'aspetto e il comportamento dei quadranti. A differenza di altre API per i quadranti, in cui l'APK deve includere il codice per il rendering del quadrante, il formato Watch Face richiede solo risorse e istruzioni dichiarative. La piattaforma Wear OS gestisce la logica necessaria per il rendering del quadrante, in modo da poterti concentrare sulle tue idee creative anziché sulle ottimizzazioni del codice o sulle prestazioni della batteria.

I quadranti creati con questo nuovo formato richiedono meno manutenzione e meno aggiornamenti rispetto a quelli creati utilizzando le librerie Jetpack Watch Face precedenti. Ad esempio, non è necessario aggiornare il quadrante per usufruire dei miglioramenti delle prestazioni o del consumo della batteria o per ricevere le correzioni di bug più recenti.

Informazioni sul formato

Al centro di un quadrante in formato WFF (Watch Face Format) c'è un documento che definisce il layout e il comportamento del quadrante. Questo documento è scritto in XML e conforme alla specifica WFF.

Il sistema Wear OS include un componente di rendering del quadrante. Questo componente analizza il documento XML WFF e ne esegue il rendering di un quadrante. Altre risorse, come immagini e caratteri, vengono importate in base alle necessità.

Con questo approccio, devi solo dedicare del tempo a descrivere l'aspetto del quadrante, mentre Wear OS gestisce tutto il codice per disegnarlo.

Per implementare un quadrante in formato Watch Face su un dispositivo, impacchetta il documento XML in un pacchetto APK o AAB standard.

Il seguente diagramma mostra una panoramica dell'approccio:

In che modo il sistema Wear OS esegue il rendering di un quadrante da un
         documento XML Watch Face Format.

Controllo delle versioni in WFF

Con l'evoluzione del WFF, vengono aggiunte nuove funzionalità, rappresentate da nuovi elementi, attributi, origini dati e così via nel formato.

Ad esempio, la versione 2 di WFF ha introdotto il supporto del meteo come origine dati, che non è disponibile nella versione 1 di WFF.

Quando progetti il quadrante, tieni presente le funzionalità che vuoi utilizzare e la disponibilità delle relative versioni. La guida di riferimento indica la disponibilità di tutte le funzionalità.

Ogni versione di WFF è in linea con una release di Wear OS:

Versione WFF Versione minima di Wear OS Livello API minimo
1 4 33
2 5 34
3 5.1 35
4 6 36

Consulta queste indicazioni per configurare il file di compilazione AndroidManifest.xml e Gradle in modo appropriato.

Scopri di più

Scopri di più su Watch Face Format in queste guide:

  • Funzionalità disponibili: scopri le funzionalità del quadrante supportate da ogni versione di Watch Face Format.
  • Linee guida per il design: scopri le best practice per il layout e l'esperienza utente del quadrante.
  • Configurazione: configura un app bundle per Android che supporti il formato del quadrante.
  • Esempi GitHub: inizia creando quadranti di esempio e implementandoli nell'emulatore Wear OS o sul tuo dispositivo fisico.
  • Ottimizza l'utilizzo della memoria: scopri come configurare il quadrante in modo che il sistema consumi il minor quantitativo di memoria possibile durante il rendering.
  • Riferimento XML: esplora i singoli elementi che fanno parte di un file Watch Face Format. L'elemento principale è sempre WatchFace. Nota: per visualizzare le funzionalità di una versione specifica di Watch Face Format nel riferimento XML, verifica che il pulsante della versione appropriata sia selezionato nella parte superiore della pagina della documentazione.
  • Guida alla pubblicazione: scopri come pubblicare e monetizzare il tuo quadrante tramite il Play Store e metodi alternativi.
  • Strumento di convalida WFF e della memoria: utilizza questi strumenti open source per verificare la presenza di errori nel file in formato per quadranti e confermare un utilizzo accettabile della memoria prima di inviare il quadrante a Google Play.