Funkcja Przywracanie danych logowania w Menedżerze danych logowania umożliwia użytkownikom przywracanie kont aplikacji podczas konfigurowania nowego urządzenia. Ten interfejs API jest w wersji dla programistów. dostępne na wszystkich urządzeniach z Androidem 9 lub nowszym i Usługami Google Play (GMS) Core w wersji 242200000 lub nowszej. Zalety przywracania danych logowania obejmuje:
- Bezproblemowe korzystanie z aplikacji: użytkownicy mogą przywrócić swoje konto w aplikacji bez i konieczne jest ręczne logowanie się w poszczególnych aplikacjach.
- Wzrost zaangażowania użytkowników: użytkownicy chętniej będą korzystać z aplikacji, jeśli będą mogli przywrócić swoje konto podczas konfigurowania nowego urządzenia.
- Mniejsze nakłady na rozwój: funkcja przywracania danych logowania jest zintegrowana z Menedżerem danych logowania, więc deweloperzy, którzy obsługują już klucze dostępu, mogą dodać funkcje przywracania danych logowania.
Jak to działa
Za pomocą funkcji przywracania danych logowania możesz tworzyć, pobierać i usuwać odpowiednie dane logowania.
- Utwórz dane logowania do przywracania: gdy użytkownik zaloguje się w aplikacji, utwórz dane logowania do przywracania powiązane z jego kontem. Te dane są przechowywane lokalnie i synchronizowane z chmurą, jeśli użytkownik ma włączoną usługę Kopia zapasowa Google i jest dostępny szyfrowanie end-to-end (aplikacje mogą zrezygnować z synchronizacji z chmurą).
- Pobierz dane logowania do przywracania: gdy użytkownik skonfiguruje nowe urządzenie, Twoja aplikacja może poprosić Menedżera poświadczeń o dane logowania do przywracania. Dzięki temu możesz: automatycznego logowania użytkownika bez konieczności wprowadzania dodatkowych danych.
- Wyczyść dane logowania do przywracania: gdy użytkownik wyloguje się z aplikacji, należy usunąć powiązane dane logowania do przywracania.
Funkcja przywracania danych logowania może płynnie integrować się z systemami backendu na których są już zaimplementowane klucze dostępu. Wynika to z faktu, że że zarówno klucze dostępu, jak i klucze do przywracania (typ danych logowania używany przez funkcji przywracania danych logowania) muszą spełniać te same podstawowe wymagania techniczne. specyfikacji. Dzięki temu procesowi procesu przywracania danych logowania skutecznie pobierać i przywracać dane logowania użytkowników przechowywane w systemów uczących się, zapewniając spójną i przyjazną dla użytkownika obsługę platform i metod uwierzytelniania.
Implementacja
Interfejs API przywracania danych logowania jest dostępny w bibliotece Jetpacka Menedżera poświadczeń. Aby zacząć go używać, wykonaj te czynności:
Dodaj do projektu zależność Credential Manager.
// build.gradle.kts implementation("androidx.credentials:credentials:1.5.0-alpha03")
Utwórz obiekt
CreateRestoreCredentialRequest
.Wywołaj metodę
createCredential()
obiektuCredentialManager
.val credentialManager = CredentialManager.create(context) // On a successful authentication create a Restore Key // Pass in the context and CreateRestoreCredentialRequest object val response = credentialManager.createCredential(context, createRestoreRequest)
Te wygenerowane dane logowania do przywrócenia są typem klucza dostępu i są również znane jako klucza przywracania lub klucza przywracania.
Gdy użytkownik skonfiguruje nowe urządzenie, wywołaj metodę
getCredential()
obiektuCredentialManager
.// Fetch the Authentication JSON from server val authenticationJson = ... // Create the GetRestoreCredentialRequest object val options = GetRestoreCredentialOption(authenticationJson) val getRequest = GetCredentialRequest(Immutablelist.of(options)) // The restore key can be fetched in two scenarios to // 1. On the first launch of app on the device, fetch the Restore Key // 2. In the onRestore callback (if the app implements the Backup Agent) val response = credentialManager.getCredential(context, getRequest)
Gdy użytkownik wyloguje się z aplikacji, wywołaj
clearCredentialState()
na obiekcieCredentialManager
.// Create a ClearCredentialStateRequest object val clearRequest = ClearCredentialStateRequest(TYPE_CLEAR_RESTORE_CREDENTIAL) // On user log-out, clear the restore key val response = credentialManager.clearCredentialState(clearRequest)
Jeśli korzystasz z agenta zapasowego, wykonaj część getCredential
w
onRestore
oddzwonienie. Dzięki temu dane logowania aplikacji zostaną przywrócone natychmiast po przywróceniu danych aplikacji.