benxu.AppPlatform.Firebase.Auth 3.2.7

benxu.AppPlatform.Firebase.Auth

Firebase Authentication 實作套件 - 使用 Plugin.Firebase.Auth v4.0.0 提供各平台的原生認證功能。

特色

• 真實 Firebase 整合:使用 Plugin.Firebase.Auth v4.0.0 進行原生 API 呼叫。
• Google 登入:整合原生 Firebase SDK 實現跨平台 Google 登入(Android: Xamarin.Firebase.Auth,iOS: AdamE.Firebase.iOS.Auth)。
• Email/Password 登入:完整支援 Firebase Email/Password 認證,包含註冊、登入、密碼重設流程。
• 自動 Token 刷新:背景服務自動刷新 Access Token,確保無縫使用體驗。
• 狀態同步:自動將認證狀態同步至 IAppStateManager,與應用程式狀態管理整合。
• 狀態持久化:應用程式重啟後自動恢復登入狀態。

支援平台

• ✅ Android (完整支援 Email/Password,Google 登入使用原生 SDK)
• ✅ iOS (完整支援 Email/Password,Google 登入使用原生 SDK,最低版本 iOS 15.0)

安裝

1. 安裝套件:

   dotnet add package benxu.AppPlatform.Firebase.Auth
   

2. 平台設定:

   • Android: 需將 google-services.json 放置於 Platforms/Android 並設定 Build Action 為 GoogleServicesJson。
   • iOS: 需將 GoogleService-Info.plist 放置於 Platforms/iOS 並設定 Build Action 為 BundleResource,且必須指定 LogicalName="GoogleService-Info.plist"。
   • iOS 初始化: 在 AppDelegate.cs 的 FinishedLaunching 方法中呼叫 Firebase.Core.App.Configure()。

使用方式

1. 註冊服務

在 MauiProgram.cs 中:

using benxu.AppPlatform.MAUI.Bootstrap.Extensions;
builder.UseAppPlatform(options =>
{
 options.UseFirebaseAuth(auth =>
 {
 auth.EnableAutoTokenRefresh = true;
 
 // Android Google 登入設定
 auth.GoogleWebClientId = "YOUR_WEB_CLIENT_ID.apps.googleusercontent.com";
 auth.GoogleRedirectUri = "com.googleusercontent.apps.YOUR_CLIENT_ID:/oauth2redirect";
 });
});

2. 使用認證功能

@inject IAuthService AuthService
@code {
 private async Task Login()
 {
 // Google 登入 (Android)
 var result = await AuthService.SignInWithGoogleAsync();
 
 // 或 Email 登入
 // var result = await AuthService.SignInWithEmailAsync("user@example.com", "123456");
 if (result.IsSuccess)
 {
 Console.WriteLine($"使用者: {result.Data.User.Email}");
 }
 }
}

注意事項

• Plugin.Firebase.Auth v4.0.0 變更:Google/Facebook/Apple 認證提供者已移除內建支援,本套件已整合原生 Firebase SDK 實現 Google 登入功能。
• Google 登入:Android 與 iOS 皆已實作,使用 WebAuthenticator 進行 OAuth 流程,並透過原生 SDK 完成 Firebase 認證。
• iOS 最低版本:iOS 15.0+(Plugin.Firebase v4.0.0 要求)

依賴項目

• Plugin.Firebase.Auth (v4.0.0)
• Plugin.Firebase.Core (v4.0.0)
• Xamarin.Firebase.Auth (Android 原生 SDK)
• AdamE.Firebase.iOS.Auth (iOS 原生 SDK)
• benxu.AppPlatform.Core

授權

MIT License - Copyright (c) 2025 benxu