Usar o FirebaseUI para adicionar login ao app para Android com facilidade

A FirebaseUI é uma biblioteca criada a partir do SDK do Firebase Authentication e fornece fluxos de IU com drop-in para serem usados no seu app. Esse recurso oferece os seguintes benefícios:

  • Vários provedores: fluxos de login para e-mail, autenticação por telefone, Login do Google, do Facebook e do Twitter.
  • Gerenciamento de contas: fluxos para processar tarefas de gerenciamento, como criação de conta e redefinições de senha.
  • Vinculação de contas: fluxos para vincular as contas do usuário de maneira segura nos provedores de identidade.
  • Temas personalizados: personalize o visual da FirebaseUI para combinar com seu app. Além disso, como a FirebaseUI é um recurso de código aberto, você pode bifurcar o projeto e personalizá-lo de acordo com suas necessidades.
  • Smart Lock para senhas: a integração automática com o Smart Lock para senhas agiliza o login entre dispositivos.

Antes de começar

  1. Adicione o Firebase ao projeto do Android.

  2. Adicione as dependências para a FirebaseUI ao seu arquivo build.gradle do nível do app. Se você quiser oferecer suporte ao login com o Facebook ou o Twitter, inclua também os SDKs dessas redes sociais:

    dependencies {
        // ...
    
        implementation 'com.firebaseui:firebase-ui-auth:4.1.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:4.x'
    
        // Required only if Twitter login support is required
        // Find the latest Twitter SDK releases here: https://goo.gl/E5wZvQ
        implementation 'com.twitter.sdk.android:twitter-core:3.x'
    }
    

    O SDK da FirebaseUI Auth tem dependências transitivas nos SDKs do Firebase e do Google Play Services.

  3. Se você ainda não conectou o app ao projeto do Firebase, faça isso no Firebase console.

  4. No Console do Firebase, abra a seção Autenticação e ative os métodos de login que serão compatíveis. Para alguns métodos de login, é necessário fornecer informações adicionais, geralmente disponíveis no console para desenvolvedores do serviço.

  5. Se você oferece compatibilidade com o Login do Google e ainda não especificou a impressão digital SHA-1 do seu app, faça isso na página "Configurações" do Firebase console. Consulte Como autenticar seu cliente para mais detalhes sobre como conseguir a impressão digital SHA-1 do seu app.

  6. Se você oferece compatibilidade com o login do Facebook ou do Twitter, adicione recursos de string a strings.xml para especificar as informações de identificação exigidas pelos provedores:

    
    <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>
      <!-- Twitter consumer key and secret -->
      <string name="twitter_consumer_key" translatable="false">YOUR_CONSUMER_KEY</string>
      <string name="twitter_consumer_secret" translatable="false">YOUR_CONSUMER_SECRET</string>
    </resources>
    

Fazer login

Para iniciar o fluxo de login da FirebaseUI, crie um intent de login com seus métodos de início de sessão preferidos:

Java
Android

// 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
startActivityForResult(
        AuthUI.getInstance()
                .createSignInIntentBuilder()
                .setAvailableProviders(providers)
                .build(),
        RC_SIGN_IN);

Kotlin
Android

// 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
startActivityForResult(
        AuthUI.getInstance()
                .createSignInIntentBuilder()
                .setAvailableProviders(providers)
                .build(),
        RC_SIGN_IN)

Quando o fluxo de login estiver concluído, você receberá o resultado em onActivityResult:

Java
Android

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);

    if (requestCode == RC_SIGN_IN) {
        IdpResponse response = IdpResponse.fromResultIntent(data);

        if (resultCode == 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.
            // ...
        }
    }
}

Kotlin
Android

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)

    if (requestCode == RC_SIGN_IN) {
        val response = IdpResponse.fromResultIntent(data)

        if (resultCode == Activity.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.
            // ...
        }
    }
}

Sair

A FirebaseUI oferece métodos de conveniência para sair do Firebase Authentication, bem como de todos os provedores de identidade de redes sociais:

Java
Android

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

Kotlin
Android

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

Você também pode excluir completamente a conta do usuário:

Java
Android

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

Kotlin
Android

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

Personalização

Por padrão, a FirebaseUI usa o AppCompat para gerar temas. Isso significa que ele adotará naturalmente o esquema de cores do seu app. Se você quiser personalizá-lo ainda mais, transmita um tema e um logotipo para o criador de Intent de login:

Java
Android

startActivityForResult(
        AuthUI.getInstance()
                .createSignInIntentBuilder()
                .setAvailableProviders(providers)
                .setLogo(R.drawable.my_great_logo)      // Set logo drawable
                .setTheme(R.style.MySuperAppTheme)      // Set theme
                .build(),
        RC_SIGN_IN);

Kotlin
Android

startActivityForResult(
        AuthUI.getInstance()
                .createSignInIntentBuilder()
                .setAvailableProviders(providers)
                .setLogo(R.drawable.my_great_logo)      // Set logo drawable
                .setTheme(R.style.MySuperAppTheme)      // Set theme
                .build(),
        RC_SIGN_IN)

Você também pode definir uma política de privacidade e Termos de Serviço personalizados:

Java
Android

startActivityForResult(
        AuthUI.getInstance()
                .createSignInIntentBuilder()
                .setAvailableProviders(providers)
                .setTosAndPrivacyPolicyUrls(
                        "https://example.com/terms.html",
                        "https://example.com/privacy.html")
                .build(),
        RC_SIGN_IN);

Kotlin
Android

startActivityForResult(
        AuthUI.getInstance()
                .createSignInIntentBuilder()
                .setAvailableProviders(providers)
                .setTosAndPrivacyPolicyUrls(
                        "https://example.com/terms.html",
                        "https://example.com/privacy.html")
                .build(),
        RC_SIGN_IN)

Próximas etapas

  • Para mais informações sobre como usar e personalizar a FirebaseUI, consulte o arquivo README no GitHub.
  • Se você encontrar um problema no FirebaseUI e quiser reportá-lo, use o rastreador de problemas do GitHub.

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.