在 Android 上使用 Facebook 登录服务进行身份验证

您可以将 Facebook 登录机制集成到您的应用中，让您的用户能够使用自己的 Facebook 帐号进行 Firebase 身份验证。

准备工作

  1. 将 Firebase 添加到您的 Android 项目（如果尚未添加）。
  2. 请务必在您的项目级 build.gradle 文件中的 buildscript 和 allprojects 部分添加 Google 的 Maven 代码库。

  3. 将 Android 版 Firebase 身份验证库的依赖项添加到您的模块（应用级）Gradle 文件（通常为 app/build.gradle）：

    implementation 'com.google.firebase:firebase-auth:19.3.1'
  4. 在 Facebook for Developers 网站上，为您的应用获取应用 ID 和应用密钥。
  5. 启用 Facebook 登录机制：
    1. 在 Firebase 控制台中，打开身份验证部分。
    2. 在登录方法标签页上，启用 Facebook 登录方法，并指定您之前从 Facebook 获得的应用 ID 和应用密钥。
    3. 然后，请务必转到 Facebook for Developers 网站，依次点击 Product Settings > Facebook Login 配置，然后在您的 Facebook 应用的设置页面中，确保您的 OAuth 重定向 URI（例如 my-app-12345.firebaseapp.com/__/auth/handler）出现在 OAuth redirect URIs 列表中。

进行 Firebase 身份验证

  1. 按开发者文档中的说明操作，将 Facebook 登录机制集成到您的应用中。配置 LoginButton 或 LoginManager 对象时，请申请 public_profile 和 email 权限。如果您使用 LoginButton 集成了 Facebook 登录机制，登录 Activity 的代码与以下代码类似：

    Java

    // Initialize Facebook Login button
mCallbackManager = CallbackManager.Factory.create();
LoginButton loginButton = mBinding.buttonFacebookLogin;
loginButton.setReadPermissions("email", "public_profile");
loginButton.registerCallback(mCallbackManager, new FacebookCallback<LoginResult>() {
    @Override
    public void onSuccess(LoginResult loginResult) {
        Log.d(TAG, "facebook:onSuccess:" + loginResult);
        handleFacebookAccessToken(loginResult.getAccessToken());
    }

    @Override
    public void onCancel() {
        Log.d(TAG, "facebook:onCancel");
        // ...
    }

    @Override
    public void onError(FacebookException error) {
        Log.d(TAG, "facebook:onError", error);
        // ...
    }
});
// ...
@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
    super.onActivityResult(requestCode, resultCode, data);

    // Pass the activity result back to the Facebook SDK
    mCallbackManager.onActivityResult(requestCode, resultCode, data);
}
    FacebookLoginActivity.java

    Kotlin+KTX

    // Initialize Facebook Login button
callbackManager = CallbackManager.Factory.create()

binding.buttonFacebookLogin.setReadPermissions("email", "public_profile")
binding.buttonFacebookLogin.registerCallback(callbackManager, object : FacebookCallback<LoginResult> {
    override fun onSuccess(loginResult: LoginResult) {
        Log.d(TAG, "facebook:onSuccess:$loginResult")
        handleFacebookAccessToken(loginResult.accessToken)
    }

    override fun onCancel() {
        Log.d(TAG, "facebook:onCancel")
        // ...
    }

    override fun onError(error: FacebookException) {
        Log.d(TAG, "facebook:onError", error)
        // ...
    }
})
// ...
override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)

    // Pass the activity result back to the Facebook SDK
    callbackManager.onActivityResult(requestCode, resultCode, data)
}
    FacebookLoginActivity.kt
  2. 在登录 Activity 的 onCreate 方法中，获取 FirebaseAuth 对象的共享实例：

    Java

    private FirebaseAuth mAuth;
// ...
// Initialize Firebase Auth
mAuth = FirebaseAuth.getInstance();
    FacebookLoginActivity.java

    Kotlin+KTX

    private lateinit var auth: FirebaseAuth
// ...
// Initialize Firebase Auth
auth = Firebase.auth
    FacebookLoginActivity.kt
  3. 初始化您的 Activity 时，请检查用户当前是否已登录：

    Java

    @Override
public void onStart() {
    super.onStart();
    // Check if user is signed in (non-null) and update UI accordingly.
    FirebaseUser currentUser = mAuth.getCurrentUser();
    updateUI(currentUser);
}
    FacebookLoginActivity.java

    Kotlin+KTX

    public override fun onStart() {
    super.onStart()
    // Check if user is signed in (non-null) and update UI accordingly.
    val currentUser = auth.currentUser
    updateUI(currentUser)
}
    FacebookLoginActivity.kt
  4. 用户成功登录之后，在 LoginButton 的 onSuccess 回调方法中为登录的用户获取一个访问令牌，用其换取 Firebase 凭据，然后使用此 Firebase 凭据进行 Firebase 身份验证：

    Java

    private void handleFacebookAccessToken(AccessToken token) {
    Log.d(TAG, "handleFacebookAccessToken:" + token);

    AuthCredential credential = FacebookAuthProvider.getCredential(token.getToken());
    mAuth.signInWithCredential(credential)
            .addOnCompleteListener(this, new OnCompleteListener<AuthResult>() {
                @Override
                public void onComplete(@NonNull Task<AuthResult> task) {
                    if (task.isSuccessful()) {
                        // Sign in success, update UI with the signed-in user's information
                        Log.d(TAG, "signInWithCredential:success");
                        FirebaseUser user = mAuth.getCurrentUser();
                        updateUI(user);
                    } else {
                        // If sign in fails, display a message to the user.
                        Log.w(TAG, "signInWithCredential:failure", task.getException());
                        Toast.makeText(FacebookLoginActivity.this, "Authentication failed.",
                                Toast.LENGTH_SHORT).show();
                        updateUI(null);
                    }

                    // ...
                }
            });
}
    FacebookLoginActivity.java

    Kotlin+KTX

    private fun handleFacebookAccessToken(token: AccessToken) {
    Log.d(TAG, "handleFacebookAccessToken:$token")

    val credential = FacebookAuthProvider.getCredential(token.token)
    auth.signInWithCredential(credential)
            .addOnCompleteListener(this) { task ->
                if (task.isSuccessful) {
                    // Sign in success, update UI with the signed-in user's information
                    Log.d(TAG, "signInWithCredential:success")
                    val user = auth.currentUser
                    updateUI(user)
                } else {
                    // If sign in fails, display a message to the user.
                    Log.w(TAG, "signInWithCredential:failure", task.exception)
                    Toast.makeText(baseContext, "Authentication failed.",
                            Toast.LENGTH_SHORT).show()
                    updateUI(null)
                }

                // ...
            }
}
    FacebookLoginActivity.kt
    如果对 signInWithCredential 的调用成功，您可以使用 getCurrentUser 方法获取用户的帐号数据。

后续步骤

在用户首次登录后，系统会创建一个新的用户帐号，并将其与该用户登录时使用的凭据（即用户名和密码、电话号码或者身份验证提供方信息）相关联。此新帐号存储在您的 Firebase 项目中，无论用户采用何种方式登录，您项目中的每个应用都可以使用此帐号来识别用户。

  • 在您的应用中，您可以从 FirebaseUser 对象中获取用户的基本个人资料信息。请参阅管理用户。

  • 在您的 Firebase 实时数据库和 Cloud Storage 安全规则中，您可以从 auth 变量获取已登录用户的唯一用户 ID，然后利用此 ID 来控制用户可以访问哪些数据。

您可以通过将身份验证提供方凭据关联至现有用户帐号，让用户可以使用多个身份验证提供方登录您的应用。

如需将用户退出登录，请调用 signOut：

Java

FirebaseAuth.getInstance().signOut();
MainActivity.java

Kotlin+KTX

Firebase.auth.signOut()
MainActivity.kt