Praticare la gratitudine può ridurre i sintomi di depressione e ansia e migliorare la salute mentale e la soddisfazione nella vita¹. Una pratica costante della gratitudine può portare a miglioramenti duraturi per mesi². L'app di mindfulness Gratitude incoraggia la costanza attraverso micro-diari giornalieri, affermazioni e vision board. L'app ha oltre 6 milioni di download, 150.000 valutazioni a 5 stelle e 100 milioni di voci di diario registrate.

Gli sviluppatori Divij Gupta e Narendra Aanjna hanno sviluppato widget per ciascuno dei percorsi utente principali della loro app. Il loro obiettivo era raggiungere gli utenti nei momenti della vita quotidiana senza richiedere l'overhead di una sessione completa dell'app.

Mostrando prompt interattivi per il diario, affermazioni, immagini della bacheca dei sogni e metriche direttamente nella schermata Home dell'utente, il team ha ridotto la barriera all'ingresso per la riflessione quotidiana e ha registrato un aumento del 25% della fidelizzazione per gli utenti dei widget e circa 1000 voci di diario settimanali dai widget. Questo aumento della fedeltà degli utenti si traduce in risultati tangibili per la loro salute: la formazione di abitudini coerenti che supportano il benessere mentale a lungo termine.

"I widget ci hanno aiutato a rendere l'app più presente nelle routine quotidiane degli utenti fornendo ispirazione, promemoria e riflessioni rapide direttamente nella schermata Home. Questo ha aumentato il coinvolgimento e ha reso più facile per gli utenti mantenere la coerenza con le loro pratiche di mindfulness". – Divij Gupta

La sfida: modernizzare senza ridurre la conservazione

Sebbene l'impatto dei widget fosse chiaro, l'implementazione originale di RemoteViews basata su XML di Gratitude ha creato un debito tecnico. Man mano che il sistema di progettazione dell'app si è evoluto verso Material 3, è diventato sempre più difficile allineare i widget legacy alla UI moderna. Ogni aggiornamento visivo richiedeva un overhead XML manuale e soluzioni alternative fragili, rallentando la velocità degli sviluppatori.

Soluzione parte 1: migrazione da XML a Jetpack Glance

Per modernizzare i widget, il team ha scelto Jetpack Glance.

Hanno prima consultato la pagina di progettazione dei widget su Android e i layout dei widget canonici per comprendere le best practice per la visualizzazione delle informazioni in uno spazio limitato.

Poi, hanno eseguito la migrazione della suite di widget a Jetpack Glance. Questo framework dichiarativo ha consentito agli sviluppatori di passare dalla pianificazione alla spedizione in meno di un mese, risparmiando circa il 50% del tempo di sviluppo e ha portato a due ulteriori vantaggi:

• La sostituzione dei layout XML restrittivi con codice dichiarativo ha reso la base di codice più facile da leggere e gestire e ha ridotto l'impegno degli sviluppatori.
• Jetpack Glance ha consentito al team di implementare più facilmente colori dinamici, ridimensionamento flessibile e opzioni di configurazione ampliate. Queste funzionalità garantiscono che i widget si armonizzino con il layout unico della schermata Home di un utente.

La seguente GIF mostra due widget Gratitudine e il ridimensionamento adattivo:

Sebbene Glance abbia semplificato la UI, il team ha notato che anche i test su vari launcher OEM erano essenziali per garantire la coerenza del layout su tutti i dispositivi.

Il team ha anche implementato le anteprime dei widget generati, in modo che gli utenti possano visualizzare anteprime personalizzate. Hanno notato che il test delle anteprime generate potrebbe essere lento, in quanto le anteprime sono limitate per preservare la batteria. Per ignorare la limitazione della frequenza per i test, utilizza il comando adb:

adb shell device_config put systemui generated_preview_api_reset_interval_ms 0

Tutti i loro sforzi hanno reso il widget Gratitudine di alta qualità e differenziato.

La soluzione, parte 2: promuovi i nuovi widget in-app 

Gli sviluppatori hanno poi utilizzato il blocco dei widget in-app per aumentare la visibilità e le installazioni dei widget. Chiedere agli utenti di installare i widget in un momento contestualmente pertinente all'interno dell'app li aiuta a trovare i widget senza dover passare per il selettore di widget di sistema. La seguente GIF mostra il foglio inferiore di Gratitude per aggiungere widget dall'interno dell'app:

Il team ha anche eseguito il refactoring dei pacchetti di widget, il che ha modificato i percorsi dei ricevitori dei widget e ha causato l'eliminazione dei widget dalle schermate Home degli utenti. Utilizzando i flag utente memorizzati in precedenza per identificare gli utenti dei widget, hanno attivato un altro prompt requestPinGlanceAppWidget che invitava gli utenti dei widget a utilizzare i nuovi widget modernizzati.

Suggerimento per gli sviluppatori:per mantenere le installazioni dei widget durante la migrazione da RemoteViews a Jetpack Glance, assicurati che il tuo GlanceAppWidgetReceiver utilizzi lo stesso nome di classe e lo stesso pacchetto del tuo precedente AppWidgetProvider nel file manifest di Android. Se è necessario un nuovo nome di classe o una nuova posizione del pacchetto, segui l'esempio di Gratitude utilizzando il blocco in-app per aiutare gli utenti a ripristinare i widget.

La strategia sta funzionando, dato che il 10% degli utenti attivi giornalieri totali ha adottato i widget.

Conclusione

Questa storia di gratitudine mostra che i widget possono essere strumenti per la formazione di abitudini. Implementando azioni rapide per l'autoanalisi direttamente dalla schermata Home, il team ha migliorato la fedeltà degli utenti. Gratitude ha ridotto il debito tecnico e modernizzato i propri widget adottando Jetpack Glance e ha invitato gli utenti ad aggiungere widget all'interno della propria app.

"La nostra esperienza con Jetpack Glance è stata eccellente. L'approccio basato su Compose è molto più moderno, flessibile e in linea con il modo in cui creiamo il resto della nostra UI oggi. Ci consente di esprimere i layout dei widget in modo più naturale, riutilizzare i componenti Compose familiari e iterare le modifiche all'interfaccia utente molto più rapidamente. Molti dei vincoli della UI che avevamo in precedenza con RemoteViews non sono più un problema, il che ha reso più facile creare widget che corrispondono meglio al design e all'esperienza della nostra app." – Divij Gupta

Per iniziare

Per iniziare a utilizzare Jetpack Glance e scoprire le tecnologie menzionate in questo post, consulta queste guide:

• Panoramica di Jetpack Glance
• Pagina di progettazione dei widget su Android
• Layout dei widget canonici
• Anteprime dei widget generati
• Livelli di qualità dei widget
• Blocco dei widget in-app
• Colori dinamici
• Ridimensionamento
• Attività di configurazione

Scopri altri case study sui widget:

• L'app Contatti di Google ha creato un nuovo widget il 25% più velocemente utilizzando Jetpack Glance
• SoundCloud utilizza Jetpack Glance per creare il widget Tracce che ti piacciono in sole due settimane

1: Diniz, G., Korkes, L., Tristão, L. S., Pelegrini, R., Bellodi, P. L., & Bernardo, W. M. (2023). The effects of gratitude interventions: a systematic review and meta-analysis. einstein (Sao Paulo)., 21, eRW0371. https://doi.org/10.31744/einstein_journal/2023RW0371

2: Bohlmeijer, E., Kraiss, J., Schotanus-Dijkstra, M., e ten Klooster, P. (2022). Gratitudine come stato d'animo che media gli effetti di un intervento di gratitudine di 6 settimane sul benessere mentale: analisi post hoc di uno studio controllato randomizzato. Anteriore. Psychol., 12, 799447. https://doi.org/10.3389/fpsyg.2021.799447