Linee guida AEP: qualità - Jetpack Compose

Utilizza Jetpack Compose per creare l'UI. Jetpack Compose è il toolkit per la UI preferito per lo sviluppo Android. Fornisce il percorso più diretto per soddisfare i criteri del programma e creare esperienze Android di alta qualità grazie al supporto nativo di Material Design, all'integrazione perfetta del sistema e alla scalabilità semplificata per vari fattori di forma.

Implementazione richiesta

Per essere idonee al programma AEP, le app devono utilizzare Jetpack Compose o un'alternativa equivalente per creare l'interfaccia utente.

Sebbene Compose sia lo standard preferito, puoi utilizzare toolkit alternativi se offrono prestazioni e funzionalità equivalenti. React Native è un toolkit alternativo approvato, anche se l'elenco dei toolkit approvati potrebbe cambiare con l'evolversi dell'ecosistema Jetpack. I toolkit possono essere aggiunti o rimossi dall'elenco in base alla loro conformità agli standard più recenti.

Queste linee guida consentono l'utilizzo supplementare di altri toolkit come Flutter, Android Views o WebView insieme a Jetpack Compose o altre alternative accettate. Sebbene gli standard attuali consentano questa flessibilità, i futuri aggiornamenti del programma potrebbero introdurre soglie di utilizzo più elevate in base alla percentuale di attività o componenti UI di un'app creati con Compose. Come per tutti gli aggiornamenti dei requisiti del programma, agli sviluppatori verrà dato un preavviso sufficiente prima che queste soglie vengano aggiornate.

Applicabilità delle linee guida

Queste linee guida sono applicabili a tutte le app su tutti i fattori di forma.

Esenzioni

Puoi inviare toolkit alternativi per la valutazione se ritieni che debbano essere presi in considerazione insieme ai toolkit alternativi accettati. Per essere idoneo, il toolkit deve soddisfare questi benchmark:

  1. Prestazioni
    1. Raggiungi un tempo alla visualizzazione iniziale inferiore a 400 ms utilizzando la precompilazione o ottimizzazioni equivalenti.
    2. Esegui il rendering dell'interfaccia utente alla frequenza di aggiornamento nativa del dispositivo senza cali di frame.
  2. Paradigmi standard dell'interfaccia utente di Android
    1. Fornisci animazioni di feedback tattile per tutte le interazioni con gli elementi.
    2. Supporta il design edge-to-edge disegnando dietro le barre di sistema e gestendo i margini interni della finestra.
    3. Supporta gli effetti di allungamento dell'overscroll ai limiti dello scorrimento.
    4. Rispondere automaticamente all'attivazione/disattivazione del tema chiaro e scuro del sistema senza riavviare l'app.
    5. Applica le API della tavolozza a livello di dispositivo per modificare dinamicamente i token dell'interfaccia utente utilizzando il supporto di Material Design.
  3. Supporta le funzionalità assistive
    1. Integrazione con l'Android Accessibility Framework, incluso il supporto dello screen reader e di TalkBack.
    2. Supporta il framework di compilazione automatica di Android per l'inserimento semplificato dei dati utente.
    3. Esegui l'integrazione con i servizi di intelligence di sistema per l'acquisizione in tempo reale dell'attività delle app.
  4. Multi-Window, piegatura e adattabilità
    1. Ridimensiona i limiti dell'interfaccia utente a metà sessione in base alle classi di dimensioni della finestra senza riavviare i contenitori.
    2. Conserva gli stati delle sessioni attive, come la riproduzione di video o l'inserimento di moduli, durante la chiusura o il ridimensionamento a metà sessione.

Documentazione e risorse sulle funzionalità

Le seguenti risorse forniscono indicazioni sull'implementazione e dettagli tecnici sulla funzionalità Jetpack Compose. Queste risorse sono solo di riferimento e non contengono requisiti aggiuntivi del programma.