Credential Manager semplifica l'autenticazione nell'intero ecosistema Android. Offre un'esperienza coerente per gli utenti e una superficie API unificata per gli sviluppatori per utilizzare passkey, password e meccanismi di accesso federato come Accedi con Google. Sebbene l'interfaccia di programmazione principale rimanga coerente tra i fattori di forma, ogni fattore di forma presenta considerazioni uniche in termini di UI e UX. L'implementazione riuscita richiede l'adattamento dei flussi di autenticazione dell'app ai metodi di input, alle dimensioni dello schermo e ai contesti utente specifici di ogni dispositivo.
Questa guida fornisce una panoramica su come implementare Credential Manager su diversi fattori di forma Android, evidenziando le considerazioni chiave e fornendo link a documentazione più dettagliata.
Dispositivi mobili
I dispositivi mobili, inclusi smartphone, tablet e pieghevoli, rappresentano il target più comune per lo sviluppo di Android. L'implementazione standard di Credential Manager è adatta a questi dispositivi, che in genere sono dotati di touchscreen e tastiere sul dispositivo. L'esperienza utente su questo fattore di forma funge da base di riferimento da cui adattarsi per gli altri. I flussi di autenticazione devono essere adatti al fattore di forma e utilizzare tutte le funzionalità dello spazio sullo schermo e dei metodi di input del dispositivo.
Wear OS
I dispositivi Wear OS sono caratterizzati da schermi piccoli e input limitati sul dispositivo. L'implementazione delle passkey di Credential Manager offre un ambiente sicuro per consentire agli utenti di accedere alle app senza bisogno di uno smartphone accoppiato e senza dover ricordare una password.
L'API per Wear OS è identica a quella per il mobile, quindi puoi riutilizzare un'integrazione mobile esistente. Oltre alle passkey, ad Accedi con Google e alle password con Credential Manager, puoi utilizzare altri metodi di autenticazione, tra cui la condivisione di token del livello dati, OAuth o le tue soluzioni esistenti. Questi possono essere utilizzati come backup durante la transizione degli utenti a Credential Manager o, nel caso della condivisione dei token del livello dati, come soluzione a lungo termine.
L'interfaccia utente sui dispositivi Wear OS è la seguente:


Per indicazioni dettagliate sull'implementazione ed esempi di codice, consulta le seguenti risorse:
- Autenticazione su indossabili
- Consigli per la progettazione dell'interfaccia utente per Wear OS
- Esempio di Gestore delle credenziali Wear
Android XR
Con Android XR, che include realtà virtuale e aumentata, le app vengono visualizzate in uno spazio 3D. L'input dell'utente è fondamentalmente diverso da quelli di altri fattori di forma, in quanto si basa su input naturali come i gesti delle mani.
L'adattamento di Credential Manager per XR comporta la riprogettazione della UI di autenticazione, che si tratti di passkey, password o metodi di accesso federato, per uno spazio 3D. Ad esempio, i prompt di autenticazione vengono visualizzati in pannelli mobili e gli utenti effettuano le selezioni utilizzando i gesti della mano. Devi anche tenere in considerazione eventuali prerequisiti hardware o software specifici per i tuoi dispositivi XR di destinazione.
Una sfida di progettazione fondamentale è creare un'esperienza di autenticazione intuitiva e sicura all'interno di un ambiente VR o AR. Devi anche considerare come gestire l'identità in scenari XR multiutente, in cui persone diverse potrebbero utilizzare lo stesso dispositivo.
L'utilizzo di Credential Manager per Android XR presenta i seguenti requisiti:
- Livello API minimo:
minSdkVersion
34 o versioni successive - Versione GMS: la stessa richiesta per le app mobile
- Emulatore:
- Immagine di sistema dell'emulatore minima:
- macOS: revisione 7 dell'immagine di sistema Google Play XR ARM 64 v8a
- Windows: Google Play XR Intel x86_64 Atom System Image Revision 7
- Versioni dell'emulatore successive alla 35.6.11 stabile
- Immagine di sistema dell'emulatore minima:
Un'esperienza di accesso su XR potrebbe avere il seguente aspetto:

Flussi non supportati da XR
Credential Manager in Android XR non supporta i flussi di autenticazione che richiedono a un altro dispositivo di scansionare un codice QR. Questo è osservabile durante le procedure di accesso sui visori XR e durante i test con l'emulatore.
Per scoprire di più su XR, consulta la pagina Android XR.