Kimlik bilgilerini geri yükle

Kimlik Bilgisi Yöneticisi'nin Kimlik Bilgilerini Geri Yükleme özelliği, kullanıcıların yeni bir cihaz kurarken uygulama hesaplarını geri yüklemelerine olanak tanır. Bu API geliştirici önizlemesindedir ve Android 9 veya sonraki bir sürüme sahip tüm cihazlarda ve Google Play Hizmetleri'nde kullanılabilir (GMS) Core 242200000 veya sonraki sürümler. Kimlik Bilgilerini Geri Yükleme özelliğinin avantajları şunlardır:

• Sorunsuz kullanıcı deneyimi: Kullanıcılar, uygulama hesaplarını ve her uygulamada manuel olarak oturum açmanız gerekebilir.
• Daha fazla kullanıcı etkileşimi: Kullanıcıların uygulamasını kullanmayı tercih edebilirler.
• Daha az geliştirme çabası: Kimlik Bilgilerini Geri Yükleme özelliği entegre edilmiştir Kimlik Bilgisi Yöneticisi ile birlikte çalışarak, geçiş anahtarlarını hâlihazırda destekleyen geliştiricilerin kimlik bilgilerini geri yükleme özellikleridir.

İşleyiş şekli

Kimlik Bilgilerini Geri Yükle özelliğini kullanarak alakalı kimlik bilgileri.

1. Geri Yükleme Kimlik Bilgisi oluşturun: Kullanıcı uygulamanızda oturum açtığında, hesabıyla ilişkili bir Geri Yükleme Kimlik Bilgisi oluşturun. Bu kimlik bilgisi depolanıyor kullanıcı Google Yedekleme'yi etkinleştirdiyse yerel olarak ve bulutta şifrelemenin kullanılabilir olması (uygulamalar bulutla senkronizasyonu devre dışı bırakabilir)
2. Geri Yükleme Kimlik Bilgilerini Alın: Kullanıcı yeni bir cihaz kurarken uygulamanız, Kimlik Bilgileri Yöneticisi'nden Geri Yükleme Kimlik Bilgileri'ni isteyebilir. Bu şekilde şunları yapabilirsiniz: ek giriş gerektirmeden kullanıcının otomatik olarak oturum açmasını sağlar.
3. Yedekleme Kimlik Bilgisini temizleyin: Kullanıcı uygulamanızdan çıkış yaptığında ilişkili Yedekleme Kimlik Bilgisini silmeniz gerekir.

Kimlik Bilgilerini Geri Yükle özelliği, arka uç sistemleriyle sorunsuz entegrasyon sağlayabilir. geçiş anahtarı olarak kullanabilirsiniz. Bu uyumluluk, hem geçiş anahtarlarının hem de geri yükleme anahtarlarının (Kimlik Bilgilerini Geri Yükleme özelliği tarafından kullanılan kimlik bilgisi türü) temel teknik spesifikasyonlara uymasından kaynaklanır. Bu uyumluluk, kimlik bilgilerini geri yükleme sürecinin geçiş anahtarı özellikli sistemlerde depolanan kullanıcı kimlik bilgilerini etkili bir şekilde almasını ve yeniden etkinleştirmesini sağlar. Böylece farklı platformlar ve kimlik doğrulama yöntemleri arasında tutarlı ve kullanıcı dostu bir deneyim sunulur.

Uygulama

Restore Credentials API, Kimlik Bilgileri Yöneticisi Jetpack kitaplığı üzerinden kullanılabilir. Başlamak için şu adımları uygulayın:

1. Projenize Kimlik Bilgisi Yöneticisi bağımlılığını ekleyin.

   // build.gradle.kts
   implementation("androidx.credentials:credentials:1.5.0-alpha03")
   

2. Bir CreateRestoreCredentialRequest nesnesi oluşturun.

3. CredentialManager nesnesinde createCredential() yöntemini çağırın.

   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)
   

   Oluşturulan bu kurtarma kimlik bilgisi, bir geçiş anahtarı türüdür ve kurtarma geçiş anahtarı veya kurtarma anahtarı olarak da bilinir.

4. Kullanıcı yeni bir cihaz kurduğundagetCredential() CredentialManager nesne algılandı.

   // 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)
   

5. Kullanıcı uygulamanızdan çıktığında CredentialManager nesnesinde clearCredentialState() yöntemini çağırın.

   // Create a ClearCredentialStateRequest object
   val clearRequest = ClearCredentialStateRequest(TYPE_CLEAR_RESTORE_CREDENTIAL)
   
   // On user log-out, clear the restore key
   val response = credentialManager.clearCredentialState(clearRequest)
   

Yedek aracı kullanıyorsanız getCredential bölümünü onRestore geri arama. Bu sayede, uygulama verileri geri yüklendikten hemen sonra uygulamanın kimlik bilgilerinin de geri yüklenmesi sağlanır.