將應用程式連結至 Firebase
如果您尚未將 Firebase 新增至 Android 專案，請新增 Firebase。
在應用程式中新增 Firebase Authentication
在模組 (應用程式層級) Gradle 檔案 (通常為
<project>/<app-module>/build.gradle.kts或<project>/<app-module>/build.gradle) 中，加入 Android 的 Firebase Authentication 程式庫依附元件。建議您使用 Firebase Android BoM 來控制程式庫版本。dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.7.0")) // Add 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") }
只要使用 Firebase Android BoM，應用程式就會一律使用相容的 Firebase Android 程式庫版本。
(替代做法) 不使用 BoM 新增 Firebase 程式庫依附元件
如果您選擇不使用 Firebase BoM，則必須在依附元件行中指定每個 Firebase 程式庫版本。
請注意，如果您在應用程式中使用多個 Firebase 程式庫，強烈建議您使用 BoM 來管理程式庫版本，確保所有版本皆相容。
dependencies { // Add 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:23.1.0") }
如要使用驗證提供者，您必須在 Firebase 主控台中啟用這項功能。請前往 Firebase Authentication 區段中的「Sign-in Method」(登入方式) 頁面，啟用電子郵件/密碼登入功能，以及您想要在應用程式中使用的任何其他身分識別提供者。
(選用) 使用 Firebase Local Emulator Suite 設計原型並進行測試
在討論應用程式如何驗證使用者之前，我們先介紹一組工具，可用於製作原型並測試 Authentication 功能：Firebase Local Emulator Suite。如果您正在考慮要使用哪種驗證技術和供應商，不妨使用 Authentication 和 Firebase Security Rules，嘗試使用公開和私人資料的不同資料模型，或製作登入使用者介面設計的原型。如果您不想部署實際服務，也可以在本機上進行驗證，這麼做可以讓您在本機上進行驗證，而無需部署實際服務。
Authentication 模擬器是 Local Emulator Suite 的一部分，可讓應用程式與模擬資料庫內容和設定互動，以及視需要與模擬的專案資源 (函式、其他資料庫和安全性規則) 互動。
使用 Authentication 模擬器只需幾個步驟：
- 在應用程式的測試設定中加入一行程式碼，以便連線至模擬器。
- 在本機專案目錄的根目錄中執行
firebase emulators:start。 - 使用 Local Emulator Suite UI 進行互動式原型設計，或使用 Authentication 模擬器 REST API 進行非互動式測試。
如需詳細指南，請參閱「將應用程式連結至 Authentication 模擬器」。詳情請參閱 Local Emulator Suite 簡介。
接下來，我們將繼續說明如何驗證使用者。
檢查目前的驗證狀態
宣告
FirebaseAuth的例項。Kotlin
private lateinit var auth: FirebaseAuth
Java
private FirebaseAuth mAuth;
在
onCreate()方法中，初始化FirebaseAuth例項。Kotlin
// Initialize Firebase Auth auth = Firebase.auth
Java
// Initialize Firebase Auth mAuth = FirebaseAuth.getInstance();
初始化活動時，請檢查使用者目前是否已登入。
Kotlin
public override fun onStart() { super.onStart() // Check if user is signed in (non-null) and update UI accordingly. val currentUser = auth.currentUser if (currentUser != null) { reload() } }
Java
@Override public void onStart() { super.onStart(); // Check if user is signed in (non-null) and update UI accordingly. FirebaseUser currentUser = mAuth.getCurrentUser(); if(currentUser != null){ reload(); } }
註冊新使用者
建立新的 createAccount 方法，用於接收電子郵件地址和密碼、驗證這些項目，然後使用 createUserWithEmailAndPassword 方法建立新使用者。
Kotlin
auth.createUserWithEmailAndPassword(email, password) .addOnCompleteListener(this) { task -> if (task.isSuccessful) { // Sign in success, update UI with the signed-in user's information Log.d(TAG, "createUserWithEmail:success") val user = auth.currentUser updateUI(user) } else { // If sign in fails, display a message to the user. Log.w(TAG, "createUserWithEmail:failure", task.exception) Toast.makeText( baseContext, "Authentication failed.", Toast.LENGTH_SHORT, ).show() updateUI(null) } }
Java
mAuth.createUserWithEmailAndPassword(email, password) .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, "createUserWithEmail:success"); FirebaseUser user = mAuth.getCurrentUser(); updateUI(user); } else { // If sign in fails, display a message to the user. Log.w(TAG, "createUserWithEmail:failure", task.getException()); Toast.makeText(EmailPasswordActivity.this, "Authentication failed.", Toast.LENGTH_SHORT).show(); updateUI(null); } } });
新增表單，以電子郵件和密碼註冊新使用者，並在提交時呼叫這個新方法。您可以在快速入門範例中查看範例。
讓現有使用者登入
建立新的 signIn 方法，該方法會擷取電子郵件地址和密碼並進行驗證，然後使用 signInWithEmailAndPassword 方法登入使用者。
Kotlin
auth.signInWithEmailAndPassword(email, password) .addOnCompleteListener(this) { task -> if (task.isSuccessful) { // Sign in success, update UI with the signed-in user's information Log.d(TAG, "signInWithEmail:success") val user = auth.currentUser updateUI(user) } else { // If sign in fails, display a message to the user. Log.w(TAG, "signInWithEmail:failure", task.exception) Toast.makeText( baseContext, "Authentication failed.", Toast.LENGTH_SHORT, ).show() updateUI(null) } }
Java
mAuth.signInWithEmailAndPassword(email, password) .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, "signInWithEmail:success"); FirebaseUser user = mAuth.getCurrentUser(); updateUI(user); } else { // If sign in fails, display a message to the user. Log.w(TAG, "signInWithEmail:failure", task.getException()); Toast.makeText(EmailPasswordActivity.this, "Authentication failed.", Toast.LENGTH_SHORT).show(); updateUI(null); } } });
新增表單，讓使用者以電子郵件和密碼登入，並在提交時呼叫這個新方法。您可以在快速入門範例中查看範例。
存取使用者資訊
如果使用者已成功登入，您可以隨時使用 getCurrentUser 方法取得其帳戶資料。
Kotlin
val user = Firebase.auth.currentUser user?.let { // Name, email address, and profile photo Url val name = it.displayName val email = it.email val photoUrl = it.photoUrl // Check if user's email is verified val emailVerified = it.isEmailVerified // The user's ID, unique to the Firebase project. Do NOT use this value to // authenticate with your backend server, if you have one. Use // FirebaseUser.getIdToken() instead. val uid = it.uid }
Java
FirebaseUser user = FirebaseAuth.getInstance().getCurrentUser(); if (user != null) { // Name, email address, and profile photo Url String name = user.getDisplayName(); String email = user.getEmail(); Uri photoUrl = user.getPhotoUrl(); // Check if user's email is verified boolean emailVerified = user.isEmailVerified(); // The user's ID, unique to the Firebase project. Do NOT use this value to // authenticate with your backend server, if you have one. Use // FirebaseUser.getIdToken() instead. String uid = user.getUid(); }
後續步驟
如要瞭解如何新增其他身分和驗證服務，請參閱下列指南：