Nota : il Watch Face Format è obbligatorio per l'installazione dei quadranti sui dispositivi con Wear OS 5 o versioni successive preinstallate e per tutti i nuovi quadranti pubblicati su Google Play.
A partire da gennaio 2026, il Watch Face Format sarà obbligatorio per l'installazione dei quadranti su tutti i dispositivi Wear OS.
Scopri di più sulle modifiche visibili agli utenti in questo articolo del Centro assistenza.
Il quadrante è la prima cosa che un utente vede quando guarda il suo smartwatch, il che lo rende la superficie di Wear OS più utilizzata. Gli utenti si affidano ai quadranti per personalizzare i propri smartwatch in base al loro stile e per visualizzare rapidamente le informazioni a colpo d'occhio.
Opzioni per la creazione di quadranti
Il formato quadrante (WFF) rende la creazione di un quadrante più semplice che mai. 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 quadranti, in cui l'APK deve includere il codice per il rendering del quadrante, il Watch Face Format richiede solo risorse e istruzioni dichiarative. La piattaforma Wear OS gestisce la logica necessaria per il rendering del quadrante, in modo che tu possa concentrarti sulle tue idee creative, anziché sulle ottimizzazioni del codice o sulle prestazioni della batteria.
Offriamo diversi modi per creare un quadrante:
- Se preferisci uno strumento in stile WYSIWYG che ti consenta di progettare il quadrante direttamente, utilizza Watch Face Studio, che supportiamo in collaborazione con Samsung.
- Se ti trovi a tuo agio con Figma come designer o se vuoi accelerare i primi passaggi della creazione di un quadrante come sviluppatore, utilizza Watch Face Designer, a cui puoi accedere tramite un plug-in in Figma.
Se preferisci gestire manualmente la configurazione dell'orologio e pubblicare i quadranti nel tuo store, puoi definirli utilizzando XML e pubblicarli con Watch Face Push.
Android Studio include anche il supporto per la creazione e l'esecuzione di quadranti che utilizzano Watch Face Format.
I quadranti creati con questo formato richiedono meno manutenzione e meno aggiornamenti rispetto a quelli creati utilizzando le librerie Jetpack Watch Face legacy. Ad esempio, non è necessario aggiornare il quadrante per usufruire dei miglioramenti delle prestazioni o del consumo della batteria o per ottenere le ultime correzioni di bug.
Informazioni sul formato
Al centro di un quadrante Watch Face Format (WFF) c'è un documento che definisce il layout e il comportamento del quadrante. Questo documento è scritto in XML, in conformità con la 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 inserite in base alle necessità.
Con questo approccio, devi solo descrivere l'aspetto del quadrante, mentre Wear OS gestisce tutto il codice per il disegno del quadrante.
Per eseguire il deployment di un quadrante Watch Face Format su un dispositivo, impacchetta il documento XML in un pacchetto AAB o APK standard.
Il seguente diagramma mostra una panoramica dell'approccio:
Controllo delle versioni in WFF
Con l'evoluzione di WFF, vengono aggiunte funzionalità aggiuntive, rappresentate da più elementi, attributi e origini dati che utilizzano tutti il formato quadrante.
Ad esempio, la versione 2 di WFF ha introdotto il supporto 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 versioni. La guida di riferimento indica tutte le funzionalità con la relativa disponibilità.
Ogni versione di WFF è allineata a 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 linee guida per configurare correttamente il file di build AndroidManifest.xml e Gradle.
Scopri di più
Scopri di più su Watch Face Format in queste guide:
- Funzionalità disponibili: esplora le funzionalità del quadrante supportate da ogni versione di Watch Face Format.
- Linee guida per la progettazione: scopri le best practice per il layout e l'esperienza utente del tuo quadrante.
- Watch Face Designer: scopri come utilizzare il plug-in Figma per creare il tuo quadrante.
- Configurazione: configura un Android App Bundle che supporti il formato del quadrante.
- Esempi su GitHub: inizia creando quadranti di esempio e implementandoli nell'emulatore Wear OS o sul tuo dispositivo fisico.
- Ottimizzare l'utilizzo della memoria: scopri come configurare il quadrante in modo che il sistema consumi la minor quantità possibile di memoria durante il rendering del quadrante.
- 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, assicurati che il pulsante della versione appropriata sia selezionato nella parte superiore della pagina di 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 controllare la presenza di errori nel file di formato del quadrante e confermare l'utilizzo accettabile della memoria prima dell'invio a Google Play.