Flutter Firebase认证插件query_stack_firebase_authentication的使用

Query Stack Firebase Authentication

A Firebase Authentication service for Query Stack。

使用

只需在您的环境中注册 AuthenticationService：

@immutable
class DevelopmentEnvironment extends Environment {
  const DevelopmentEnvironment();

  [@override](/user/override)
  void registerDependencies(RegisterDependenciesDelegate when, PlatformInfo platformInfo) {
    when<AuthenticationService>(
      (get) => AuthenticationService(
        appleRedirectUrl: platformInfo.nativePlatform.when(
          onAndroid: () => "redirect url when using android", // 当使用Android时的重定向URL
          onWeb: () => "redirect url when using web",         // 当使用Web时的重定向URL
          orElse: () => null,                                 // 其他平台返回null
        ),
        appleServiceId: "apple sign in service id",           // Apple Sign In服务ID
        googleClientId: platformInfo.nativePlatform.when(
          onAndroid: () => "google client id for android",    // Android上的Google客户端ID
          oniOS: () => "google client id for ios",            // iOS上的Google客户端ID
          onWeb: () => "google client id for web",            // Web上的Google客户端ID
          orElse: () => throw UnsupportedError("${platformInfo.nativePlatform} is not supported"), // 不支持其他平台
        ),
      ),
    );

    // 注册其他依赖项
  }
}

您可以继承 AuthenticationService 并覆盖方法 fetchPesistedPrincipal 和 persistPrincipal，例如将已认证的用户保存到数据库中。

Principal

已认证的用户称为 Principal，其属性与Firebase Authentication用户相同：id, displayName, email, avatarURL（Firebase中的 photoURL），creationTime 和 lastLogin。

lastLogin 是一个 PrincipalLogin 类，包含 authProvider（Google或Apple）、当前设备的 id, model, device, version（如：Android 13）、platform（如：iOS、Android等）以及最后登录时间。

完整示例代码

以下是一个完整的示例，展示如何使用 query_stack_firebase_authentication 插件进行用户认证。

1. 配置环境

首先，确保您已经在Firebase控制台中配置了Google和Apple登录，并获取相应的客户端ID和服务ID。

import 'package:flutter/material.dart';
import 'package:query_stack/query_stack.dart';
import 'package:query_stack_firebase_authentication/query_stack_firebase_authentication.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: EnvironmentSetup(),
    );
  }
}

class EnvironmentSetup extends StatefulWidget {
  [@override](/user/override)
  _EnvironmentSetupState createState() => _EnvironmentSetupState();
}

class _EnvironmentSetupState extends State<EnvironmentSetup> {
  final DevelopmentEnvironment _environment = DevelopmentEnvironment();

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text("Firebase Authentication Example")),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            // 初始化Query Stack环境
            QueryStack.init(environment: _environment);
            Navigator.pushReplacement(
              context,
              MaterialPageRoute(builder: (_) => HomePage()),
            );
          },
          child: Text("Initialize Environment"),
        ),
      ),
    );
  }
}

2. 创建环境配置类

@immutable
class DevelopmentEnvironment extends Environment {
  const DevelopmentEnvironment();

  [@override](/user/override)
  void registerDependencies(RegisterDependenciesDelegate when, PlatformInfo platformInfo) {
    when<AuthenticationService>(
      (get) => AuthenticationService(
        appleRedirectUrl: platformInfo.nativePlatform.when(
          onAndroid: () => "com.example.app:/oauth2redirect",
          onWeb: () => "https://example.com/oauth2callback",
          orElse: () => null,
        ),
        appleServiceId: "com.example.apple-signin-service",
        googleClientId: platformInfo.nativePlatform.when(
          onAndroid: () => "your-google-client-id-android",
          oniOS: () => "your-google-client-id-ios",
          onWeb: () => "your-google-client-id-web",
          orElse: () => throw UnsupportedError("${platformInfo.nativePlatform} is not supported"),
        ),
      ),
    );
  }
}

3. 登录页面

class HomePage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text("Home Page")),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: () async {
                try {
                  // 调用登录方法
                  await AuthenticationService.instance.signInWithGoogle();
                  print("User signed in successfully!");
                } catch (e) {
                  print("Error signing in: $e");
                }
              },
              child: Text("Sign in with Google"),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: () async {
                try {
                  // 调用登录方法
                  await AuthenticationService.instance.signInWithApple();
                  print("User signed in successfully!");
                } catch (e) {
                  print("Error signing in: $e");
                }
              },
              child: Text("Sign in with Apple"),
            ),
          ],
        ),
      ),
    );
  }
}

4. 获取当前用户信息

class UserInfoPage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text("User Info")),
      body: FutureBuilder<Principal?>(
        future: AuthenticationService.instance.fetchCurrentUser(),
        builder: (context, snapshot) {
          if (snapshot.connectionState == ConnectionState.waiting) {
            return Center(child: CircularProgressIndicator());
          }
          if (!snapshot.hasData || snapshot.data == null) {
            return Center(child: Text("No user logged in"));
          }
          final user = snapshot.data!;
          return Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              Text("User ID: ${user.id}"),
              Text("Display Name: ${user.displayName ?? "N/A"}"),
              Text("Email: ${user.email ?? "N/A"}"),
              Text("Avatar URL: ${user.avatarURL ?? "N/A"}"),
              Text("Last Login: ${user.lastLogin?.lastSignInTime?.toString() ?? "N/A"}"),
            ],
          );
        },
      ),
    );
  }
}