benxu.AppPlatform.Firebase.Auth 3.0.2

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