新增使用者
您可以透過下列四種方式在 Firebase 專案中建立新使用者:
- 呼叫
createUserWithEmailAndPassword()
方法。 - 首次使用聯合識別資訊提供者 (例如 Google 登入、Facebook 登入或 Apple) 登入使用者。
您也可以透過 Firebase 控制台的「Users」(使用者) 頁面,從「Authentication」(驗證) 部分建立新的以密碼驗證的使用者。
取得使用者的個人資料
如要取得使用者的個人資料資訊,請使用 User
的屬性。有三種方法可以取得代表目前使用者的 User
物件:
authStateChanges
、idTokenChanges
和userChanges
串流:如未驗證任何使用者,事件監聽器會收到目前的User
。null
:FirebaseAuth.instance .authStateChanges() .listen((User? user) { if (user != null) { print(user.uid); } });
應用程式啟動後,當使用者憑證 (如有) 從本機儲存空間還原後,就會觸發事件,這表示使用者狀態初始化時,一律都會呼叫事件監聽器。之後,每當驗證狀態變更,系統就會以更新後的使用者狀態引發新事件。
藉由監聽驗證狀態,您可以建構使用者介面,因應驗證狀態中的這些變更。
驗證 (
signIn
-) 方法傳回的UserCredential
物件:UserCredential
物件包含具有目前User
的user
屬性:final userCredential = await FirebaseAuth.instance.signInWithCredential(credential); final user = userCredential.user; print(user?.uid);
FirebaseAuth
執行個體的currentUser
屬性:如果您確定使用者目前已登入,就可以從currentUser
屬性存取User
:if (FirebaseAuth.instance.currentUser != null) { print(FirebaseAuth.instance.currentUser?.uid); }
currentUser
可能是null
,原因如下:- 使用者未登入。
- Auth 物件尚未完成初始化。如果您使用事件監聽器來追蹤使用者的登入狀態,就不需要處理此情況。
取得使用者供應商專屬個人資料
如要從與使用者連結的登入提供者擷取個人資訊,請使用 providerData
屬性。例如:
if (user != null) {
for (final providerProfile in user.providerData) {
// ID of the provider (google.com, apple.com, etc.)
final provider = providerProfile.providerId;
// UID specific to the provider
final uid = providerProfile.uid;
// Name, email address, and profile photo URL
final name = providerProfile.displayName;
final emailAddress = providerProfile.email;
final profilePhoto = providerProfile.photoURL;
}
}
更新使用者的個人資料
您可以使用 update
方法更新使用者的基本個人資料資訊,包括使用者的顯示名稱和個人資料相片。例如:
await user?.updateDisplayName("Jane Q. User");
await user?.updatePhotoURL("https://example.com/jane-q-user/profile.jpg");
設定使用者的電子郵件地址
您可以使用 updateEmail()
方法設定使用者的電子郵件地址。例如:
await user?.updateEmail("janeq@example.com");
向使用者傳送驗證電子郵件
您可以使用 sendEmailVerification()
方法將電子郵件地址驗證電子郵件傳送給使用者。例如:
await user?.sendEmailVerification();
您可以在 Firebase 控制台的「電子郵件範本」頁面中,自訂用於「驗證」部分的電子郵件範本。請參閱 Firebase 說明中心的「電子郵件範本」一文。
您也可以在傳送驗證電子郵件時,透過繼續網址傳遞狀態,將狀態重新導向回應用程式。
此外,您也可以在傳送電子郵件前更新驗證執行個體上的語言代碼,將驗證電子郵件本地化。例如:
await FirebaseAuth.instance.setLanguageCode("fr");
await user?.sendEmailVerification();
設定使用者密碼
您可以使用 updatePassword()
方法設定使用者的密碼。例如:
await user?.updatePassword(newPassword);
傳送重設密碼電子郵件
您可以使用 sendPasswordResetEmail()
方法將密碼重設電子郵件傳送給使用者。例如:
await FirebaseAuth.instance
.sendPasswordResetEmail(email: "user@example.com");
您可以在 Firebase 控制台的「電子郵件範本」頁面中,自訂用於「驗證」部分的電子郵件範本。請參閱 Firebase 說明中心的「電子郵件範本」一文。
您也可以在傳送密碼重設電子郵件時,透過繼續網址傳遞狀態,將狀態重新導向回應用程式。
此外,您也可以在傳送電子郵件前更新驗證執行個體上的語言代碼,將密碼重設電子郵件本地化。例如:
await FirebaseAuth.instance.setLanguageCode("fr");
您也可以透過 Firebase 控制台傳送密碼重設電子郵件。
刪除使用者
您可以使用 delete()
方法刪除使用者帳戶。例如:
await user?.delete();
您也可以前往 Firebase 控制台的「使用者」頁面,從「驗證」專區刪除使用者。
重新驗證使用者
某些攸關安全的動作 (例如刪除帳戶、設定主要電子郵件地址,以及變更密碼) 使用者必須最近才登入,如果您執行上述其中一項操作,但使用者登入的時間太長,該動作就會失敗,並擲回含有程式碼 requires-recent-login
的 FirebaseAuthException
。在這種情況下,請從使用者取得新的登入憑證,並將憑證傳遞至 reauthenticate
,重新驗證使用者。例如:
// Prompt the user to re-provide their sign-in credentials.
// Then, use the credentials to reauthenticate:
await user?.reauthenticateWithCredential(credential);
匯入使用者帳戶
您可以使用 Firebase CLI 的 auth:import
指令,將檔案中的使用者帳戶匯入 Firebase 專案。例如:
firebase auth:import users.json --hash-algo=scrypt --rounds=8 --mem-cost=14