FirebaseUI ile Android uygulamanıza kolayca oturum açma özelliğini ekleyin

FirebaseUI , uygulamanızda kullanım için açılır UI akışları sağlayan Firebase Authentication SDK'nın üzerine kurulmuş bir kitaplıktır. FirebaseUI aşağıdaki avantajları sağlar:

• Birden Çok Sağlayıcı - e-posta/parola, e-posta bağlantısı, telefonla kimlik doğrulama, Google Oturum Açma, Facebook Oturum Açma, Twitter Oturum Açma ve GitHub Oturum Açma için oturum açma akışları.
• Hesap Yönetimi - hesap oluşturma ve parola sıfırlama gibi hesap yönetimi görevlerini yerine getirmek için akışlar.
• Hesap Bağlama - kimlik sağlayıcılar arasında kullanıcı hesaplarını güvenli bir şekilde bağlamak için akışlar.
• Anonim Kullanıcı Yükseltmesi - anonim kullanıcıları güvenli bir şekilde yükseltmek için akar.
• Özel Temalar - FirebaseUI'nin görünümünü uygulamanıza uyacak şekilde özelleştirin. Ayrıca, FirebaseUI açık kaynak olduğu için projeyi çatallayabilir ve tam olarak ihtiyaçlarınıza göre özelleştirebilirsiniz.
• Parolalar için Smart Lock - cihazlar arası hızlı oturum açma için Parolalar için Smart Lock ile otomatik entegrasyon.

Sen başlamadan önce

1. Henüz yapmadıysanız, Android projenize Firebase'i ekleyin .

2. FirebaseUI bağımlılıklarını uygulama düzeyindeki build.gradle dosyanıza ekleyin. Facebook veya Twitter ile oturum açmayı desteklemek istiyorsanız, Facebook ve Twitter SDK'larını da ekleyin:

   dependencies {
       // ...
   
       implementation 'com.firebaseui:firebase-ui-auth:7.2.0'
   
       // Required only if Facebook login support is required
       // Find the latest Facebook SDK releases here: https://goo.gl/Ce5L94
       implementation 'com.facebook.android:facebook-android-sdk:8.x'
   }
   

   FirebaseUI Auth SDK, Firebase SDK ve Google Play hizmetleri SDK üzerinde geçişli bağımlılıklara sahiptir.

3. Firebase konsolunda Kimlik Doğrulama bölümünü açın ve desteklemek istediğiniz oturum açma yöntemlerini etkinleştirin. Bazı oturum açma yöntemleri, genellikle hizmetin geliştirici konsolunda bulunan ek bilgiler gerektirir.

4. Google ile Oturum Açmayı destekliyorsanız ve uygulamanızın SHA-1 parmak izini henüz belirlemediyseniz, bunu Firebase konsolunun Ayarlar sayfasından yapın. Uygulamanızın SHA-1 parmak izini nasıl alacağınızla ilgili ayrıntılar için Müşterinizin Kimliğini Doğrulama bölümüne bakın.

5. Facebook veya Twitter ile oturum açmayı destekliyorsanız, her sağlayıcının gerektirdiği tanımlayıcı bilgileri belirten strings.xml dize kaynakları ekleyin:

   
   <resources>
     <!-- Facebook application ID and custom URL scheme (app ID prefixed by 'fb'). -->
     <string name="facebook_application_id" translatable="false">YOUR_APP_ID</string>
     <string name="facebook_login_protocol_scheme" translatable="false">fbYOUR_APP_ID</string>
   </resources>
   

Kayıt olmak

FirebaseUI Etkinlik sonuç sözleşmesi için bir geri arama kaydeden bir ActivityResultLauncher oluşturun:

// See: https://developer.android.com/training/basics/intents/result
private final ActivityResultLauncher<Intent> signInLauncher = registerForActivityResult(
        new FirebaseAuthUIActivityResultContract(),
        new ActivityResultCallback<FirebaseAuthUIAuthenticationResult>() {
            @Override
            public void onActivityResult(FirebaseAuthUIAuthenticationResult result) {
                onSignInResult(result);
            }
        }
);
FirebaseUIActivity.java

// See: https://developer.android.com/training/basics/intents/result
private val signInLauncher = registerForActivityResult(
        FirebaseAuthUIActivityResultContract()
) { res ->
    this.onSignInResult(res)
}
FirebaseUIActivity.kt

FirebaseUI oturum açma akışını başlatmak için tercih ettiğiniz oturum açma yöntemleriyle bir oturum açma amacı oluşturun:

// Choose authentication providers
List<AuthUI.IdpConfig> providers = Arrays.asList(
        new AuthUI.IdpConfig.EmailBuilder().build(),
        new AuthUI.IdpConfig.PhoneBuilder().build(),
        new AuthUI.IdpConfig.GoogleBuilder().build(),
        new AuthUI.IdpConfig.FacebookBuilder().build(),
        new AuthUI.IdpConfig.TwitterBuilder().build());

// Create and launch sign-in intent
Intent signInIntent = AuthUI.getInstance()
        .createSignInIntentBuilder()
        .setAvailableProviders(providers)
        .build();
signInLauncher.launch(signInIntent);
FirebaseUIActivity.java

// Choose authentication providers
val providers = arrayListOf(
        AuthUI.IdpConfig.EmailBuilder().build(),
        AuthUI.IdpConfig.PhoneBuilder().build(),
        AuthUI.IdpConfig.GoogleBuilder().build(),
        AuthUI.IdpConfig.FacebookBuilder().build(),
        AuthUI.IdpConfig.TwitterBuilder().build())

// Create and launch sign-in intent
val signInIntent = AuthUI.getInstance()
        .createSignInIntentBuilder()
        .setAvailableProviders(providers)
        .build()
signInLauncher.launch(signInIntent)
FirebaseUIActivity.kt

Oturum açma akışı tamamlandığında, sonucu onSignInResult içinde alacaksınız:

private void onSignInResult(FirebaseAuthUIAuthenticationResult result) {
    IdpResponse response = result.getIdpResponse();
    if (result.getResultCode() == RESULT_OK) {
        // Successfully signed in
        FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser();
        // ...
    } else {
        // Sign in failed. If response is null the user canceled the
        // sign-in flow using the back button. Otherwise check
        // response.getError().getErrorCode() and handle the error.
        // ...
    }
}
FirebaseUIActivity.java

private fun onSignInResult(result: FirebaseAuthUIAuthenticationResult) {
    val response = result.idpResponse
    if (result.resultCode == RESULT_OK) {
        // Successfully signed in
        val user = FirebaseAuth.getInstance().currentUser
        // ...
    } else {
        // Sign in failed. If response is null the user canceled the
        // sign-in flow using the back button. Otherwise check
        // response.getError().getErrorCode() and handle the error.
        // ...
    }
}
FirebaseUIActivity.kt

Oturum açma yöntemlerini ayarlayın

E-posta bağlantısı kimlik doğrulaması

1. Firebase konsolunda , Kimlik Doğrulama bölümünü açın. Oturum açma yöntemi sekmesinde E-posta/Parola sağlayıcısını etkinleştirin. E-posta bağlantısı oturum açmayı kullanmak için e-posta/şifre oturum açmanın etkinleştirilmesi gerektiğini unutmayın.

2. Aynı bölümde, E-posta bağlantısı (parolasız oturum açma) oturum açma yöntemini etkinleştirin ve Kaydet'i tıklayın .

3. Ayrıca e-posta bağlantısıyla oturum açmayı kullanmak için Firebase Dynamic Links'i etkinleştirmeniz gerekecek. Firebase konsolunda , gezinme çubuğunda Engage altında Dynamic Links'e tıklayın. Başlarken'e tıklayın ve bir etki alanı ekleyin. Burada seçtiğiniz alan adı, kullanıcılarınıza gönderilen e-posta bağlantılarına yansıtılacaktır.

4. Bir EmailBuilder örneğinde enableEmailLinkSignIn öğesini çağırarak enableEmailLinkSignIn e-posta bağlantısı oturum açmayı etkinleştirebilirsiniz. Ayrıca setHandleCodeInApp true olarak ayarlanmış geçerli bir ActionCodeSettings nesnesi sağlamanız gerekecektir. Ek olarak, Firebase konsolunda Kimlik Doğrulama -> Oturum Açma Yöntemleri -> Yetkili alanlar altında yapılabilen setUrl URL'yi beyaz listeye eklemeniz gerekir.

   Java

   ActionCodeSettings actionCodeSettings = ActionCodeSettings.newBuilder()
           .setAndroidPackageName(
                   /* yourPackageName= */ "...",
                   /* installIfNotAvailable= */ true,
                   /* minimumVersion= */ null)
           .setHandleCodeInApp(true) // This must be set to true
           .setUrl("https://google.com") // This URL needs to be whitelisted
           .build();
   
   List<AuthUI.IdpConfig> providers = Arrays.asList(
           new AuthUI.IdpConfig.EmailBuilder()
                   .enableEmailLinkSignIn()
                   .setActionCodeSettings(actionCodeSettings)
                   .build()
   );
   Intent signInIntent = AuthUI.getInstance()
           .createSignInIntentBuilder()
           .setAvailableProviders(providers)
           .build();
   signInLauncher.launch(signInIntent);
   FirebaseUIActivity.java

   Kotlin+KTX

   val actionCodeSettings = ActionCodeSettings.newBuilder()
           .setAndroidPackageName( /* yourPackageName= */
                   "...",  /* installIfNotAvailable= */
                   true,  /* minimumVersion= */
                   null)
           .setHandleCodeInApp(true) // This must be set to true
           .setUrl("https://google.com") // This URL needs to be whitelisted
           .build()
   
   val providers = listOf(
           EmailBuilder()
                   .enableEmailLinkSignIn()
                   .setActionCodeSettings(actionCodeSettings)
                   .build()
   )
   val signInIntent = AuthUI.getInstance()
           .createSignInIntentBuilder()
           .setAvailableProviders(providers)
           .build()
   signInLauncher.launch(signInIntent)
   FirebaseUIActivity.kt

5. Bağlantıyı belirli bir aktivitede yakalamak istiyorsanız, lütfen burada özetlenen adımları izleyin. Aksi takdirde, bağlantı başlatıcı etkinliğinize yönlendirilecektir.

6. Derin bağlantıyı yakaladığınızda, sizin için halledebileceğimizi doğrulamak için aramanız gerekir. Yapabilirsek, setEmailLink aracılığıyla bize iletmeniz gerekir.

   Java

   if (AuthUI.canHandleIntent(getIntent())) {
       if (getIntent().getExtras() == null) {
           return;
       }
       String link = getIntent().getExtras().getString("email_link_sign_in");
       if (link != null) {
           Intent signInIntent = AuthUI.getInstance()
                   .createSignInIntentBuilder()
                   .setEmailLink(link)
                   .setAvailableProviders(providers)
                   .build();
           signInLauncher.launch(signInIntent);
       }
   }
   FirebaseUIActivity.java

   Kotlin+KTX

   if (AuthUI.canHandleIntent(intent)) {
       val extras = intent.extras ?: return
       val link = extras.getString("email_link_sign_in")
       if (link != null) {
           val signInIntent = AuthUI.getInstance()
                   .createSignInIntentBuilder()
                   .setEmailLink(link)
                   .setAvailableProviders(providers)
                   .build()
           signInLauncher.launch(signInIntent)
       }
   }
   FirebaseUIActivity.kt

7. İsteğe bağlı Cihazlar arası e-posta bağlantısıyla oturum açma desteklenir; bu, Android uygulamanız aracılığıyla gönderilen bağlantının web veya Apple uygulamalarınızda oturum açmak için kullanılabileceği anlamına gelir. Varsayılan olarak, çapraz cihaz desteği etkindir. EmailBuilder örneğinde setForceSameDevice arayarak devre dışı bırakabilirsiniz.

   Daha fazla bilgi için FirebaseUI-Web ve FirebaseUI-iOS'a bakın.

Oturumu Kapat

FirebaseUI, tüm sosyal kimlik sağlayıcılarının yanı sıra Firebase Authentication'dan çıkış yapmak için kolaylık yöntemleri sağlar:

AuthUI.getInstance()
        .signOut(this)
        .addOnCompleteListener(new OnCompleteListener<Void>() {
            public void onComplete(@NonNull Task<Void> task) {
                // ...
            }
        });
FirebaseUIActivity.java

AuthUI.getInstance()
        .signOut(this)
        .addOnCompleteListener {
            // ...
        }
FirebaseUIActivity.kt

Ayrıca kullanıcının hesabını tamamen silebilirsiniz:

AuthUI.getInstance()
        .delete(this)
        .addOnCompleteListener(new OnCompleteListener<Void>() {
            @Override
            public void onComplete(@NonNull Task<Void> task) {
                // ...
            }
        });
FirebaseUIActivity.java

AuthUI.getInstance()
        .delete(this)
        .addOnCompleteListener {
            // ...
        }
FirebaseUIActivity.kt

özelleştirme

Varsayılan olarak FirebaseUI, tema için AppCompat'ı kullanır; bu, uygulamanızın renk düzenini doğal olarak benimseyeceği anlamına gelir. Daha fazla özelleştirmeye ihtiyacınız varsa, oturum açma Intent oluşturucusuna bir tema ve logo iletebilirsiniz:

Intent signInIntent = AuthUI.getInstance()
        .createSignInIntentBuilder()
        .setAvailableProviders(providers)
        .setLogo(R.drawable.my_great_logo)      // Set logo drawable
        .setTheme(R.style.MySuperAppTheme)      // Set theme
        .build();
signInLauncher.launch(signInIntent);
FirebaseUIActivity.java

val signInIntent = AuthUI.getInstance()
        .createSignInIntentBuilder()
        .setAvailableProviders(providers)
        .setLogo(R.drawable.my_great_logo) // Set logo drawable
        .setTheme(R.style.MySuperAppTheme) // Set theme
        .build()
signInLauncher.launch(signInIntent)
FirebaseUIActivity.kt

Ayrıca özel bir gizlilik politikası ve hizmet şartları da belirleyebilirsiniz:

Intent signInIntent = AuthUI.getInstance()
        .createSignInIntentBuilder()
        .setAvailableProviders(providers)
        .setTosAndPrivacyPolicyUrls(
                "https://example.com/terms.html",
                "https://example.com/privacy.html")
        .build();
signInLauncher.launch(signInIntent);
FirebaseUIActivity.java

val signInIntent = AuthUI.getInstance()
        .createSignInIntentBuilder()
        .setAvailableProviders(providers)
        .setTosAndPrivacyPolicyUrls(
                "https://example.com/terms.html",
                "https://example.com/privacy.html")
        .build()
signInLauncher.launch(signInIntent)
FirebaseUIActivity.kt

Sonraki adımlar

• FirebaseUI'yi kullanma ve özelleştirme hakkında daha fazla bilgi için GitHub'daki README dosyasına bakın.
• FirebaseUI'de bir sorun bulursanız ve bunu bildirmek isterseniz GitHub sorun izleyicisini kullanın.