firebase_user_stream 是一个用于在 Flutter 应用中实时同步 Firebase 用户数据的插件。它允许你监听 Firebase 用户数据的变化，并在数据发生变化时自动更新 UI。以下是如何使用 firebase_user_stream 插件的步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 firebase_user_stream 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  firebase_core: latest_version
  firebase_auth: latest_version
  firebase_user_stream: latest_version

然后运行 flutter pub get 来安装依赖。

2. 初始化 Firebase

在使用 firebase_user_stream 之前，你需要初始化 Firebase。通常，你可以在 main.dart 文件中进行初始化：

import 'package:firebase_core/firebase_core.dart';
import 'package:flutter/material.dart';

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

3. 使用 firebase_user_stream

firebase_user_stream 提供了一个 FirebaseUserStream 类，你可以使用它来监听 Firebase 用户数据的变化。

以下是一个简单的示例，展示如何使用 FirebaseUserStream 来监听用户数据的变化并更新 UI：

import 'package:flutter/material.dart';
import 'package:firebase_auth/firebase_auth.dart';
import 'package:firebase_user_stream/firebase_user_stream.dart';

class UserProfilePage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('User Profile'),
      ),
      body: FirebaseUserStream(
        builder: (BuildContext context, User? user) {
          if (user == null) {
            return Center(child: Text('No user logged in.'));
          }

          return Center(
            child: Column(
              mainAxisAlignment: MainAxisAlignment.center,
              children: [
                Text('User ID: ${user.uid}'),
                Text('Email: ${user.email ?? 'No email'}'),
                Text('Display Name: ${user.displayName ?? 'No display name'}'),
                Text('Phone Number: ${user.phoneNumber ?? 'No phone number'}'),
              ],
            ),
          );
        },
      ),
    );
  }
}

4. 解释代码

• FirebaseUserStream 是一个 StreamBuilder 的封装，它监听 Firebase 用户数据的变化。
• builder 方法接收一个 BuildContext 和一个 User? 对象。User? 对象是当前登录的用户，如果用户未登录，则为 null。
• 在 builder 方法中，你可以根据用户数据的变化来更新 UI。

5. 处理用户登录和登出

你可以使用 FirebaseAuth 来处理用户的登录和登出操作。例如：

import 'package:firebase_auth/firebase_auth.dart';

Future<void> signInWithEmailAndPassword(String email, String password) async {
  try {
    await FirebaseAuth.instance.signInWithEmailAndPassword(
      email: email,
      password: password,
    );
  } catch (e) {
    print('Failed to sign in: $e');
  }
}

Future<void> signOut() async {
  await FirebaseAuth.instance.signOut();
}

6. 完整示例

以下是一个完整的示例，展示了如何使用 firebase_user_stream 和 FirebaseAuth 来管理用户登录和登出：

import 'package:flutter/material.dart';
import 'package:firebase_auth/firebase_auth.dart';
import 'package:firebase_user_stream/firebase_user_stream.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: 'Firebase User Stream Example',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: UserProfilePage(),
    );
  }
}

class UserProfilePage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('User Profile'),
      ),
      body: FirebaseUserStream(
        builder: (BuildContext context, User? user) {
          if (user == null) {
            return Center(child: Text('No user logged in.'));
          }

          return Center(
            child: Column(
              mainAxisAlignment: MainAxisAlignment.center,
              children: [
                Text('User ID: ${user.uid}'),
                Text('Email: ${user.email ?? 'No email'}'),
                Text('Display Name: ${user.displayName ?? 'No display name'}'),
                Text('Phone Number: ${user.phoneNumber ?? 'No phone number'}'),
                ElevatedButton(
                  onPressed: () async {
                    await FirebaseAuth.instance.signOut();
                  },
                  child: Text('Sign Out'),
                ),
              ],
            ),
          );
        },
      ),
      floatingActionButton: FloatingActionButton(
        onPressed: () async {
          await signInWithEmailAndPassword('user@example.com', 'password');
        },
        child: Icon(Icons.login),
      ),
    );
  }
}

Future<void> signInWithEmailAndPassword(String email, String password) async {
  try {
    await FirebaseAuth.instance.signInWithEmailAndPassword(
      email: email,
      password: password,
    );
  } catch (e) {
    print('Failed to sign in: $e');
  }
}