Flutter简化Firebase认证插件firebase_auth_simplify的使用

Flutter简化Firebase认证插件firebase_auth_simplify的使用

1. 简介

firebase_auth_simplify 是一个简化 Firebase 认证流程的包装包。它将多个步骤的代码简化为一行，使得第三方登录（如 Google、Facebook、Kakao 等）更加容易实现。如果你希望减少代码量并简化集成过程，这个插件非常适合你。

2. 适用场景

• 谁应该使用这个插件？

  • 如果你需要快速集成多种第三方登录方式，并且不希望编写冗余的代码，那么 firebase_auth_simplify 是一个不错的选择。
  • 如果你只使用 Firebase 提供的原生登录方式（如邮箱、电话），建议直接使用 firebase_auth 包。

• 谁不应该使用这个插件？

  • 如果你的项目只需要 Firebase 提供的原生登录方式（如邮箱、电话），直接使用 firebase_auth 包会更轻量。
  • 如果你只使用部分第三方登录方式（如仅使用 Google 和 Facebook），但不想引入其他不必要的依赖包，建议手动集成这些登录方式。

3. 目前支持的登录方式

• ✅ 邮箱
• ✅ 电话
• ✅ Google
• ❌ Google Play Games
• ✅ Facebook
• ✅ Kakao
• ✅ Apple
• ❌ GameCenter
• ❌ Twitter
• ❌ Github
• ❌ Line

4. 使用示例

4.1 初始化 Firebase

首先，确保你已经按照 Firebase 官方文档 的说明完成了 Firebase 的初始化配置。你需要在 Android/build.gradle 和 iOS/Runner/Info.plist 中添加必要的配置。

import 'package:firebase_core/firebase_core.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  runApp(MyApp());
}

4.2 简单的登录/注册/登出示例

4.2.1 邮箱登录/注册

import 'package:firebase_auth_simplify/firebase_auth_simplify.dart';

// 注册
FirebaseEmailAuthAPI(email: "user@example.com", password: "password123").signUp();

// 登录
FirebaseEmailAuthAPI(email: "user@example.com", password: "password123").signIn();

4.2.2 Google 登录

import 'package:firebase_auth_simplify/firebase_auth_simplify.dart';

// 登录
FirebaseGoogleAuthAPI().signIn();

4.2.3 Facebook 登录

import 'package:firebase_auth_simplify/firebase_auth_simplify.dart';

// 登录
FirebaseFacebookAuthAPI().signIn();

4.2.4 Kakao 登录

import 'package:firebase_auth_simplify/firebase_auth_simplify.dart';

// 登录
FirebaseKakaoAuthAPI().signIn();

4.2.5 登出

// 使用 FirebaseAuthProvider 进行登出，它会同时从 Firebase 和第三方提供商中登出
FirebaseAuthProvider.instance.signOut();

4.3 使用包装器（推荐）

FirebaseAuthProvider 提供了更高级的功能，例如自动管理第三方提供商的登出和账户链接。

4.3.1 登录/注册

// 使用包装器进行登录
FirebaseAuthProvider.instance.signInWith(FirebaseGoogleAuthAPI());

// 使用包装器进行注册（仅适用于 Firebase 提供的登录方式，如邮箱）
FirebaseAuthProvider.instance.signUpWith(FirebaseEmailAuthAPI(email: "user@example.com", password: "password123"));

4.3.2 账户链接

// 将当前用户与新的登录方式链接
FirebaseAuthProvider.instance.linkCurrentUserWith(FirebaseGoogleAuthAPI());

4.3.3 账户解绑

// 解绑当前用户的某个登录方式
FirebaseAuthProvider.instance.unlinkCurrentUserFrom(FirebaseGoogleAuthAPI());

4.4 完整示例 Demo

以下是一个完整的示例应用，展示了如何使用 firebase_auth_simplify 实现登录、注册和登出功能。

import 'package:flutter/material.dart';
import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_auth/firebase_auth.dart';
import 'package:provider/provider.dart';
import 'package:firebase_auth_simplify/firebase_auth_simplify.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await Firebase.initializeApp();
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Firebase Auth Simplify Example',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: AppPage(),
    );
  }
}

class AppPage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    print(">>> Build [App] Page");

    return Scaffold(
      appBar: AppBar(title: Text("Firebase Auth Example")),
      body: _buildBody(),
    );
  }

  Widget _buildBody() {
    return StreamBuilder<User>(
      stream: FirebaseAuth.instance.authStateChanges(),
      builder: (_, snapshot) {
        if (snapshot.connectionState == ConnectionState.active) {
          if (snapshot.data == null) {
            return LoginPage();
          } else {
            return LandingPage();
          }
        } else {
          return _buildLoadingIndicator();
        }
      },
    );
  }

  Widget _buildLoadingIndicator() {
    return Center(
      child: SizedBox(
        child: CircularProgressIndicator(),
        height: 25,
        width: 25,
      ),
    );
  }
}

class LoginPage extends StatelessWidget {
  final TextEditingController _emailController = TextEditingController();
  final TextEditingController _passwordController = TextEditingController();

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Padding(
      padding: const EdgeInsets.all(16.0),
      child: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: [
          TextField(
            controller: _emailController,
            decoration: InputDecoration(labelText: "Email"),
          ),
          TextField(
            controller: _passwordController,
            decoration: InputDecoration(labelText: "Password"),
            obscureText: true,
          ),
          SizedBox(height: 20),
          ElevatedButton(
            onPressed: () async {
              try {
                await FirebaseEmailAuthAPI(
                  email: _emailController.text,
                  password: _passwordController.text,
                ).signIn();
                ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: Text("Login successful")));
              } catch (e) {
                ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: Text("Login failed: $e")));
              }
            },
            child: Text("Login"),
          ),
          ElevatedButton(
            onPressed: () async {
              try {
                await FirebaseEmailAuthAPI(
                  email: _emailController.text,
                  password: _passwordController.text,
                ).signUp();
                ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: Text("Sign up successful")));
              } catch (e) {
                ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: Text("Sign up failed: $e")));
              }
            },
            child: Text("Sign Up"),
          ),
          ElevatedButton(
            onPressed: () async {
              try {
                await FirebaseAuthProvider.instance.signInWith(FirebaseGoogleAuthAPI());
                ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: Text("Google Login successful")));
              } catch (e) {
                ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: Text("Google Login failed: $e")));
              }
            },
            child: Text("Login with Google"),
          ),
          ElevatedButton(
            onPressed: () async {
              try {
                await FirebaseAuthProvider.instance.signInWith(FirebaseFacebookAuthAPI());
                ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: Text("Facebook Login successful")));
              } catch (e) {
                ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: Text("Facebook Login failed: $e")));
              }
            },
            child: Text("Login with Facebook"),
          ),
        ],
      ),
    );
  }
}

class LandingPage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Center(
      child: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: [
          Text("Welcome! You are logged in."),
          ElevatedButton(
            onPressed: () async {
              try {
                await FirebaseAuthProvider.instance.signOut();
                ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: Text("Logout successful")));
              } catch (e) {
                ScaffoldMessenger.of(context).showSnackBar(SnackBar(content: Text("Logout failed: $e")));
              }
            },
            child: Text("Logout"),
          ),
        ],
      ),
    );
  }
}