本頁面由 Cloud Translation API 翻譯而成。

在 Android 上使用 Google 登錄進行身份驗證

您可以通過將 Google Sign-In 集成到您的應用中，讓您的用戶使用他們的 Google 帳戶向 Firebase 進行身份驗證。

在你開始之前

如果你還沒有，添加火力地堡到您的Android項目。

使用火力地堡Android的物料清單，聲明你的模塊（應用程序級）搖籃文件（通常為火力地堡認證的Android庫的依賴app/build.gradle ）。

此外，作為設置 Firebase 身份驗證的一部分，您需要將 Google Play 服務 SDK 添加到您的應用中。

爪哇

dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:29.0.4')

    // Declare the dependency for the Firebase Authentication library
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-auth'

    // Also declare the dependency for the Google Play services library and specify its version
    implementation 'com.google.android.gms:play-services-auth:20.0.1'
}

通過使用火力地堡Android的物料清單，您的應用程序將始終使用火力地堡的Android庫的兼容版本。

（替代）聲明火力地堡庫依賴不使用物料清單

如果您選擇不使用 Firebase BoM，則必須在其依賴行中指定每個 Firebase 庫版本。

需要注意的是，如果你在你的應用程序使用多個火力地堡庫，我們強烈建議您使用的物料清單管理庫版本，以保證所有版本相互兼容。

dependencies {
    // Declare the dependency for the Firebase Authentication library
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-auth:21.0.1'

    // Also declare the dependency for the Google Play services library and specify its version
    implementation 'com.google.android.gms:play-services-auth:20.0.1'
}

科特林+KTX

dependencies {
    // Import the BoM for the Firebase platform
    implementation platform('com.google.firebase:firebase-bom:29.0.4')

    // Declare the dependency for the Firebase Authentication library
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-auth-ktx'

    // Also declare the dependency for the Google Play services library and specify its version
    implementation 'com.google.android.gms:play-services-auth:20.0.1'
}

通過使用火力地堡Android的物料清單，您的應用程序將始終使用火力地堡的Android庫的兼容版本。

（替代）聲明火力地堡庫依賴不使用物料清單

如果您選擇不使用 Firebase BoM，則必須在其依賴行中指定每個 Firebase 庫版本。

需要注意的是，如果你在你的應用程序使用多個火力地堡庫，我們強烈建議您使用的物料清單管理庫版本，以保證所有版本相互兼容。

dependencies {
    // Declare the dependency for the Firebase Authentication library
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation 'com.google.firebase:firebase-auth-ktx:21.0.1'

    // Also declare the dependency for the Google Play services library and specify its version
    implementation 'com.google.android.gms:play-services-auth:20.0.1'
}

如果您還沒有指定您的應用程序的SHA-1指紋，從這樣做設置頁面的火力地堡控制台。請參閱驗證您的客戶，了解如何讓你的應用程序的SHA-1指紋細節。
在 Firebase 控制台中啟用 Google 登錄：
1. 在火力地堡控制台，打開驗證部分。
2. 在登錄方法選項卡，啟用谷歌登錄方法，然後單擊保存。

使用 Firebase 進行身份驗證

整合谷歌登錄在您的應用通過以下的步驟整合谷歌登錄在為你的Android應用程序頁面。當您配置GoogleSignInOptions對象，調用requestIdToken ：

爪哇

// Configure Google Sign In
GoogleSignInOptions gso = new GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_SIGN_IN)
        .requestIdToken(getString(R.string.default_web_client_id))
        .requestEmail()
        .build();

mGoogleSignInClient = GoogleSignIn.getClient(this, gso);GoogleSignInActivity.java

科特林+KTX

// Configure Google Sign In
val gso = GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_SIGN_IN)
        .requestIdToken(getString(R.string.default_web_client_id))
        .requestEmail()
        .build()

googleSignInClient = GoogleSignIn.getClient(this, gso)GoogleSignInActivity.kt

你必須通過你的服務器的客戶端ID到requestIdToken方法。要查找 OAuth 2.0 客戶端 ID：

打開憑據頁的GCP控制台。
Web應用程序類型的客戶端ID是你的後端服務器的OAuth 2.0客戶端ID。

集成 Google 登錄後，您的登錄活動將包含類似於以下內容的代碼：

爪哇

private void signIn() {
    Intent signInIntent = mGoogleSignInClient.getSignInIntent();
    startActivityForResult(signInIntent, RC_SIGN_IN);
}

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

    // Result returned from launching the Intent from GoogleSignInApi.getSignInIntent(...);
    if (requestCode == RC_SIGN_IN) {
        Task<GoogleSignInAccount> task = GoogleSignIn.getSignedInAccountFromIntent(data);
        try {
            // Google Sign In was successful, authenticate with Firebase
            GoogleSignInAccount account = task.getResult(ApiException.class);
            Log.d(TAG, "firebaseAuthWithGoogle:" + account.getId());
            firebaseAuthWithGoogle(account.getIdToken());
        } catch (ApiException e) {
            // Google Sign In failed, update UI appropriately
            Log.w(TAG, "Google sign in failed", e);
        }
    }
}GoogleSignInActivity.java

科特林+KTX

private fun signIn() {
    val signInIntent = googleSignInClient.signInIntent
    startActivityForResult(signInIntent, RC_SIGN_IN)
}

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

    // Result returned from launching the Intent from GoogleSignInApi.getSignInIntent(...);
    if (requestCode == RC_SIGN_IN) {
        val task = GoogleSignIn.getSignedInAccountFromIntent(data)
        try {
            // Google Sign In was successful, authenticate with Firebase
            val account = task.getResult(ApiException::class.java)!!
            Log.d(TAG, "firebaseAuthWithGoogle:" + account.id)
            firebaseAuthWithGoogle(account.idToken!!)
        } catch (e: ApiException) {
            // Google Sign In failed, update UI appropriately
            Log.w(TAG, "Google sign in failed", e)
        }
    }
}GoogleSignInActivity.kt

在您登入活動的onCreate方法，得到的共享實例FirebaseAuth對象：

爪哇

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

科特林+KTX

private lateinit var auth: FirebaseAuth
// ...
// Initialize Firebase Auth
auth = Firebase.authGoogleSignInActivity.kt

初始化 Activity 時，檢查用戶當前是否登錄：

爪哇

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

科特林+KTX

override fun onStart() {
    super.onStart()
    // Check if user is signed in (non-null) and update UI accordingly.
    val currentUser = auth.currentUser
    updateUI(currentUser)
}GoogleSignInActivity.kt

用戶經過成功的標誌，得到令牌的ID GoogleSignInAccount對象，換取一個火力地堡證書，並驗證使用火力地堡火力地堡的憑據：

爪哇

private void firebaseAuthWithGoogle(String idToken) {
    AuthCredential credential = GoogleAuthProvider.getCredential(idToken, null);
    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());
                        updateUI(null);
                    }
                }
            });
}GoogleSignInActivity.java

科特林+KTX

private fun firebaseAuthWithGoogle(idToken: String) {
    val credential = GoogleAuthProvider.getCredential(idToken, null)
    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)
                    updateUI(null)
                }
            }
}GoogleSignInActivity.kt

如果調用signInWithCredential成功，你可以使用getCurrentUser方法來獲取用戶的帳戶數據。

下一步

用戶首次登錄後，會創建一個新用戶帳戶並將其鏈接到憑據（即用戶名和密碼、電話號碼或身份驗證提供商信息），即用戶登錄時使用的憑據。這個新帳戶作為 Firebase 項目的一部分存儲，可用於在項目中的每個應用中識別用戶，無論用戶如何登錄。

在您的應用程序，你可以從用戶的基本資料信息FirebaseUser對象。請參閱管理用戶。
在你的火力地堡實時數據庫和雲存儲安全規則，你可以得到簽署的，從用戶的唯一的用戶ID auth的變量，並用它來控制哪些數據的用戶可以訪問。

您可以允許用戶通過使用多個身份驗證提供登錄到您的應用程序連接身份驗證提供憑據到現有的用戶帳戶。

要註銷用戶，請撥打signOut ：

爪哇

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

科特林+KTX

Firebase.auth.signOut()MainActivity.kt