FirebaseUI ile Android uygulamanıza kolayca oturum açma ekleyin

FirebaseUI, için kullanılacak geçişli kullanıcı arayüzü akışları sağlayan Firebase Authentication SDK'sının dokunun. FirebaseUI aşağıdaki avantajları sağlar:

  • Birden Fazla Sağlayıcı: E-posta/şifre, e-posta bağlantısı, telefon için oturum açma akışları kimlik doğrulama, Google ile Oturum Açma, Facebook Girişi, Twitter Girişi ve GitHub Girişi.
  • Hesap Yönetimi: Hesap yönetimi görevleri, hesap oluşturma ve şifre sıfırlama.
  • Hesap Bağlama: Kullanıcı hesaplarını kimlik genelinde güvenli bir şekilde bağlama akışları sağlayıcılar.
  • Anonim Kullanıcı Yükseltme: Anonim kullanıcıları güvenli bir şekilde yükseltme akışları
  • Özel Temalar: FirebaseUI'nin görünümünü uygulamanıza uyacak şekilde özelleştirin. Ayrıca, FirebaseUI açık kaynak olduğundan projeyi çatallayıp özelleştirebilirsiniz. uyarlayabilirsiniz.
  • Şifreler için Smart Lock - Şifreler için Smart Lock cihazlar arası oturum açmayı deneyin.

Başlamadan önce

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

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

    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'nın Firebase SDK'sına geçişli bağımlılıkları vardır ve Google Play Hizmetleri SDK'sı.

  3. Firebase konsolunda Kimlik Doğrulama bölümünü açın ve aşağıdaki ayarı etkinleştirin: oturum açma yöntemlerini belirlemenize yardımcı olur. Bazı oturum açma yöntemleri için genellikle hizmetin geliştiricisinde bulunan ek bilgiler konsolu.

  4. Google ile Oturum Açma'yı etkinleştirdiyseniz:

    1. Konsolda istendiğinde güncellenmiş Firebase yapılandırma dosyasını indirin (google-services.json), artık OAuth istemci bilgilerini içeriyor Google'da oturum açmak için gereklidir.

    2. Bu güncellenen yapılandırma dosyasını Android Studio projenize taşıyarak değiştirin karşılık gelen yapılandırma dosyasını yeni sürüme geçirmeniz gerekir. (Firebase'i Android projenize ekleme başlıklı makaleyi inceleyin.)

    3. Uygulamanızın SHA parmak izini henüz belirtmediyseniz Ayarlar sayfası bölümüne gidin. İstemcinizin Kimliğini Doğrulama bölümünü inceleyin sayfasına göz atın.

  5. Facebook veya Twitter ile oturum açmayı destekliyorsanız Her biri için gereken tanımlayıcı bilgileri belirten strings.xml sağlayıcı:

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

Oturum aç

FirebaseUI için geri çağırma sağlayan bir ActivityResultLauncher oluşturun Etkinlik sonucu sözleşmesi:

Kotlin+KTX

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

Java

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

FirebaseUI oturum açma akışını başlatmak için tercih ettiğiniz oturum açma yöntemleri:

Kotlin+KTX

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

Java

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

Oturum açma akışı tamamlandığında sonucu şu şekilde alırsınız: onSignInResult:

Kotlin+KTX

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.
        // ...
    }
}

Java

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.
        // ...
    }
}

Oturum açma yöntemlerini ayarlayın

  1. Firebase konsolunda Kimlik Doğrulama bölümünü açın. Sign in method (Oturum açma yöntemi) sekmesinde, Email/Password (E-posta/Şifre) sağlayıcısını etkinleştirin. Not e-posta bağlantısıyla oturum açmayı kullanmak için e-posta/şifre oturum açma etkinleştirilmelidir.

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

  3. Ayrıca, e-posta bağlantısıyla oturum açma özelliğini kullanmak için Firebase Dynamic Links'i etkinleştirmeniz gerekir. Firebase konsolunda, gezinme çubuğundaki Etkileşim'in altındaki Dinamik Bağlantılar'ı tıklayın. Tıklayın: Başlayın ve alan adı ekleyin. Burada seçtiğiniz alan adı e-postaya yansıtılacaktır. bağlantılarla karşılaşırsınız.

  4. FirebaseUI'de e-posta bağlantısıyla oturum açmayı etkinleştirmek için enableEmailLinkSignIn öğesini EmailBuilder örneği. Ayrıca,ActionCodeSettings setHandleCodeInApp doğru değerine ayarlandı. Ayrıca, aktardığınız URL'yi de beyaz listeye eklemeniz gerekir setUrl (Bu işlem Firebase konsolunda Kimlik Doğrulama -> altında yapılabilir) Oturum Açma Yöntemleri -> Yetkilendirilen alanlar.

    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)

    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);
  5. Bağlantıyı belirli bir etkinlikte yakalamak isterseniz lütfen aşağıda belirtilen adımları uygulayın: burada bulabilirsiniz. Aksi halde bağlantı başlatıcı etkinliğinize yönlendirmelidir.

  6. Derin bağlantıyı yakaladıktan sonra, sorunu sizin için ele alabileceğimizi doğrulamak için bizi aramanız gerekir. Bir bunu bize setEmailLink aracılığıyla iletmeniz gerekir.

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

    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);
        }
    }
  7. İsteğe bağlı Cihazlar arası e-posta bağlantısıyla oturum açma desteklenir. Yani bağlantı Android uygulamanız web veya Apple uygulamalarınıza giriş yapmak için kullanılabilir. Varsayılan olarak cihazlar arası destek etkin olduğundan emin olun. EmailBuilder örneğinde setForceSameDevice yöntemini çağırarak bunu devre dışı bırakabilirsiniz.

    Bkz. FirebaseUI-Web ve FirebaseUI-iOS konulu videomuzu izleyin.

Oturumu Kapatın

FirebaseUI, Firebase Authentication'dan çıkış yapmak için kolay yöntemler sunar sosyal kimlik sağlayıcılarının yanı sıra şunlara da dikkat etmelisiniz:

Kotlin+KTX

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

Java

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

Kullanıcının hesabını tamamen de silebilirsiniz:

Kotlin+KTX

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

Java

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

Özelleştirme

FirebaseUI, varsayılan olarak tema için AppCompat'ı kullanır. Bu nedenle, doğal olarak ve uygulamanızın renk şemasına uygun olmalıdır. Daha fazla özelleştirmeye ihtiyacınız varsa oturum açma Intent oluşturucuya bir tema ve logo iletin:

Kotlin+KTX

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)

Java

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

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

Kotlin+KTX

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

Java

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

Sonraki adımlar

  • FirebaseUI'yi kullanma ve özelleştirme hakkında daha fazla bilgi için BENİOKU dosyasına gidin.
  • FirebaseUI'de bir sorun bulursanız ve bunu bildirmek isterseniz GitHub sorun izleyici.