Norme sulla qualità principali delle app

Gli orientamenti del display e gli stati di piegatura espongono essenzialmente le stesse funzionalità e azioni e preservano la parità funzionale.

L'app riempie la finestra dell'app in entrambi gli orientamenti e non è in formato letterbox a causa di modifiche alla configurazione, tra cui l'apertura e la chiusura del dispositivo.

È accettabile un leggero letterboxing per compensare piccole variazioni nella geometria dello schermo.

L'app mostra grafica, testo, immagini e altri elementi UI senza distorsioni, sfocature o pixelizzazione evidenti.

• L'app utilizza drawable vettoriali ove possibile
• L'app utilizza grafica di alta qualità per tutte le dimensioni dello schermo e i fattori di forma scelti come target
• Nessun aliasing ai bordi di menu, pulsanti e altri elementi UI

L'app mantiene il proprio stato o lo stato dell'utente quando non è più in primo piano e impedisce la perdita accidentale di dati a causa della navigazione a ritroso e di altre modifiche dello stato.

Quando torna in primo piano, l'app ripristina lo stato conservato e le eventuali transazioni stateful in attesa. Ad esempio, modifiche ai campi modificabili, ai progressi di gioco, ai menu, ai video e ad altre sezioni dell'app.

• Quando l'app viene ripresa dal selettore di app Recenti, l'utente torna allo stato esatto in cui l'app è stata utilizzata l'ultima volta.
• Quando l'app viene ripresa dopo che il dispositivo si riattiva dallo stato di sospensione (bloccato), l'app riporta l'utente allo stato esatto in cui si trovava l'ultima volta che l'app è stata utilizzata.
• Quando l'app viene riavviata dalla Home o da Tutte le app, deve eseguire una delle seguenti operazioni, a seconda del tempo trascorso dall'ultimo utilizzo dell'app:
• Se l'app è stata utilizzata di recente (minuti), ripristina lo stato dell'app il più vicino possibile a quello precedente.
• Se è trascorso più tempo dall'ultimo utilizzo dell'app, prova a ripristinarla il più vicino possibile allo stato precedente o avviala dalla schermata Home o da un altro stato predefinito.

Le notifiche forniscono informazioni pertinenti relative alla tua app.

• Non utilizzare le notifiche per la promozione incrociata o la pubblicità di un altro prodotto, in quanto ciò è severamente vietato dal Play Store.
• I canali di notifica sono definiti in base alle best practice, anziché pubblicare tutte le notifiche da un unico canale.
• Seleziona la priorità di notifica corretta.
• Se possibile, raggruppa più notifiche in un unico gruppo di notifiche.
• Imposta i timeout per le notifiche, se opportuno.
• Le notifiche sono persistenti solo se sono relative a eventi in corso, come la riproduzione di musica o una telefonata. Per saperne di più, consulta la sezione Funzionalità.

Per le app di messaggistica, le app social e le conversazioni:

• Utilizza le notifiche di MessagingStyle per le conversazioni.
• Supportare l'azione di risposta diretta.
• Supporta le scorciatoie per le conversazioni e implementa le best practice per ottenere il ranking migliore per la condivisione diretta.
• Supporto delle bolle.

Il testo dell'app e i contenuti in primo piano mantengono i seguenti rapporti di contrasto con lo sfondo dell'app:

• 3:1 per testo e immagini di grandi dimensioni
• 4,5:1 per testo di piccole dimensioni (meno di 18 pt o meno di 14 pt se il testo è in grassetto)

Scopri di più su colore e contrasto.

Quando l'utente avvia la riproduzione audio, l'app deve eseguire una delle seguenti operazioni entro un secondo:

• Avvia la riproduzione dell'audio
• Fornisci un indicatore visivo che mostri che i dati audio sono in fase di preparazione

L'app deve supportare la riproduzione in background.

L'app deve utilizzare un servizio in primo piano per impedire al sistema di interrompere il processo dell'app quando questa non è più visibile. L'app deve inoltre mostrare una notifica persistente e non ignorabile nella barra di stato o nella schermata di blocco per informare l'utente che l'app è in esecuzione.

Gli utenti devono poter controllare la riproduzione utilizzando i controlli della notifica o della schermata di blocco oppure i controlli di un accessorio collegato.

L'app supporta la riproduzione in background dei video quando non è l'app in primo piano, anche quando la finestra dell'app è:

• Ridotto a icona
• Dietro altre finestre o UI di sistema (ad esempio, l'area notifiche o la schermata Home/di blocco)
• Fuori dallo schermo visibile del computer

L'app evita di eseguire servizi inutilmente lunghi in background per garantire il corretto funzionamento del dispositivo dell'utente.

Nota:il sistema applica varie limitazioni ai servizi in background.

Di seguito sono riportati alcuni esempi di utilizzo non corretto dei servizi in background:

• Mantenimento di una connessione di rete per le notifiche
• Mantenimento di una connessione Bluetooth
• Mantenere il GPS acceso

Per saperne di più, consulta Panoramica delle attività in background.

Gli SDK di Google o di terze parti utilizzati sono aggiornati. Eventuali miglioramenti a questi SDK relativi a stabilità, compatibilità o sicurezza devono essere messi a disposizione degli utenti in modo tempestivo.

Per gli SDK Google, utilizza gli SDK basati su Google Play Services, se disponibili. Questi SDK sono compatibili con le versioni precedenti, ricevono aggiornamenti automatici, riducono le dimensioni del pacchetto applicativo e utilizzano in modo efficiente le risorse on-device.

L'app supporta correttamente le funzionalità di gestione del consumo energetico Doze e Standby delle app.

Le app possono richiedere un'esenzione per la manutenzione dell'alimentazione. Consulta la sezione Supporto per altri casi d'uso in Ottimizza per Doze e Standby delle app.

L'app richiede l'autorizzazione ad accedere a dati sensibili (ad esempio gruppi di autorizzazioni SMS o Registri chiamate o posizione) o a servizi a pagamento (ad esempio Dialer o SMS) solo se direttamente correlati ai casi d'uso principali dell'app. Le implicazioni relative a queste autorizzazioni devono essere comunicate all'utente in un'informativa in evidenza.

A seconda di come la tua app utilizza le autorizzazioni, potrebbe essere possibile un modo alternativo per soddisfare il caso d'uso della tua app senza fare affidamento sull'accesso a informazioni sensibili. Ad esempio, anziché richiedere autorizzazioni relative ai contatti di un utente, utilizza un intent implicito per richiedere l'accesso.

L'app conserva i dati utente, le impostazioni e lo stato dell'app nei backup sul cloud e nei trasferimenti da dispositivo a dispositivo (D2D).

Implementa il backup automatico e configura android:dataExtractionRules per garantire un ripristino dei dati senza problemi durante la configurazione di un nuovo dispositivo o la reinstallazione dell'app.

L'app ripristina automaticamente gli account utente e lo stato di accesso quando un utente configura un nuovo dispositivo.

Implementa Restore Credentials utilizzando Gestore delle credenziali per autenticare nuovamente gli utenti in modo automatico senza forzare i flussi di accesso manuale o di recupero dell'account.

L'app imposta l'attributo android:exported in modo esplicito per tutte le attività, i servizi, i broadcast receiver e, in particolare, i provider di contenuti.

Vengono esportati solo i componenti dell'applicazione che condividono dati con altre app o i componenti che devono essere richiamati da altre app.

Tutti gli intent e i broadcast seguono le best practice:

• Utilizza intent espliciti se l'applicazione di destinazione è ben definita.
• Utilizza gli intent per rimandare le autorizzazioni a un'altra app che le ha già.
• Condividi i dati in modo sicuro tra le app.
• Gli intent che contengono un payload vengono verificati prima dell'uso.
• Se devi passare un intent a un'altra app, in modo che l'app di destinazione possa richiamare e aspettarsi un callback nell'app di chiamata, non includere un intent nidificato negli extra. Utilizza un PendingIntent.
• Quando configuri i pending intent, imposta esplicitamente il flag immutabile, se applicabile.

Tutti i componenti che condividono contenuti tra app utilizzano android:protectionLevel="signature" per le autorizzazioni personalizzate. Sono inclusi attività, servizi, broadcast receiver e, in particolare, provider di contenuti.

Le app non devono fare affidamento sull'accesso a un elenco di pacchetti installati.

Visualizzazioni web: non utilizzare addJavaScriptInterface() con contenuti non attendibili.

Su Android 6.0 (livello API 23 e versioni successive), utilizza invece i canali di messaggi HTML.

L'app non carica dinamicamente codice dall'esterno dell'APK dell'app. Utilizza gli Android App Bundle, che includono Play Feature Delivery e Play Asset Delivery.

A partire da agosto 2021, l'utilizzo degli Android App Bundle è obbligatorio per tutte le nuove app nel Google Play Store.

L'immagine in primo piano dell'app segue le linee guida descritte in questo articolo di assistenza. Verifica quanto segue:

• La scheda dell'app include un'immagine in primo piano di alta qualità
• L'immagine in evidenza non contiene immagini del dispositivo, screenshot o testo di piccole dimensioni che risulta illeggibile quando viene ridotto e visualizzato sulle dimensioni dello schermo più piccole scelte come target per la tua app
• L'immagine in primo piano non assomiglia a una pubblicità

Naviga in tutte le parti dell'app: tutte le schermate, le finestre di dialogo, le impostazioni e tutti i flussi utente.

Esegui test delle funzionalità di base con l'app installata su una scheda SD del dispositivo (se l'app supporta questo metodo di installazione).

Per spostare l'app su una scheda SD, consulta le Impostazioni dell'app.

Da ogni schermata dell'app, ruota il dispositivo tra gli orientamenti orizzontale e verticale e tra gli stati aperto e chiuso almeno tre volte.

Esamina tutti i blocchi di testo nell'app. Verifica che la lunghezza delle righe del testo e dei blocchi di testo sia limitata a 45-75 caratteri (spazi inclusi) per garantire la leggibilità.

Naviga in tutte le parti dell'app: tutte le schermate, le finestre di dialogo, le impostazioni e tutti i flussi utente.

Dalla schermata di ogni app, premi il pulsante Indietro o utilizza il gesto di scorrimento indietro. L'app dovrebbe tornare alla schermata precedente o alla schermata Home.

Avviare la riproduzione audio. Interagisci con un'altra app non audio come app in primo piano. L'app dovrebbe continuare a riprodurre l'audio in background e mostrare una notifica nella barra di stato. Verifica di poter gestire la riproduzione utilizzando i controlli visualizzati nella notifica.

Blocca lo schermo del dispositivo. L'app dovrebbe continuare a riprodurre l'audio in background e mostrare una notifica nella schermata di blocco. Verifica di poter gestire la riproduzione utilizzando i controlli visualizzati nella notifica.

Utilizza tutte le funzionalità principali della tua app. Verifica che non vengano avviati servizi in background di lunga durata.

Passa a un'altra app per inviare l'app in background. Vai a Impostazioni e controlla se la tua app ha servizi in esecuzione in background. Su Android 4.0 e versioni successive, vai alla schermata App e trova l'app nella scheda In esecuzione.

Attiva StrictMode nella tua app. Utilizza tutte le funzionalità principali. Verifica che l'app non generi avvisi relativi alle prestazioni di StrictMode, ovvero che non siano visibili flash rossi durante il test dell'app. I flash rossi indicano prestazioni scadenti relative allo spazio di archiviazione, all'accesso alla rete o alla gestione della memoria (ad esempio perdite di memoria).

Presta molta attenzione alla garbage collection e al suo impatto sull'esperienza utente.

Utilizzare tutte le funzionalità principali dell'app nelle modalità di sospensione e Standby delle app. Verifica che sveglie, timer, notifiche e sincronizzazioni funzionino correttamente nel periodo di manutenzione di Doze e quando l'app esce dalla modalità Standby delle app.

Testa il comportamento di Doze e Standby delle app utilizzando i comandi ADB (consulta Test con Doze e Standby delle app per i requisiti e le linee guida).

Per diagnosticare un consumo imprevisto della batteria, utilizza Power Profiler di Android Studio o lo strumento Battery Historian in combinazione con il lavoro in background pianificato.

Configura le preferenze locali, i database e le impostazioni delle app su un dispositivo principale. Esegui un backup sul cloud o un trasferimento da dispositivo a dispositivo (D2D) su un nuovo dispositivo.

Avvia l'app sul dispositivo di destinazione dopo il trasferimento e verifica che le preferenze locali, lo stato del database e le impostazioni utente vengano ripristinati correttamente in base alle regole di backup automatico. Per procedure di test dettagliate, consulta Esegui il test di backup e ripristino.

Configura una sessione con accesso eseguito su un dispositivo principale utilizzando passkey, password o Accedi con Google. Esegui un backup sul cloud o un trasferimento da dispositivo a dispositivo (D2D) su un nuovo dispositivo.

Avvia l'app sul dispositivo di destinazione dopo il trasferimento e verifica che l'autenticazione venga ripristinata automaticamente utilizzando Restore Credentials senza visualizzare schermate di accesso o richiedere il recupero dell'account. Per procedure di test dettagliate, consulta Test delle credenziali di ripristino.