fire_api_dart 是一个用于 Flutter 的综合性 API 服务插件，它提供了与 Firebase 和其他后端服务进行交互的便捷方式。通过 fire_api_dart，开发者可以轻松地集成 Firebase 认证、Firestore 数据库、云存储、云函数等功能，并且还可以与其他 RESTful API 进行交互。

1. 安装 fire_api_dart

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

dependencies:
  flutter:
    sdk: flutter
  fire_api_dart: ^1.0.0  # 请使用最新版本

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

2. 初始化 fire_api_dart

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

import 'package:fire_api_dart/fire_api_dart.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  
  // 初始化 FireApiDart
  await FireApiDart.initialize(
    apiKey: 'YOUR_API_KEY',
    projectId: 'YOUR_PROJECT_ID',
    authDomain: 'YOUR_AUTH_DOMAIN',
    storageBucket: 'YOUR_STORAGE_BUCKET',
    messagingSenderId: 'YOUR_MESSAGING_SENDER_ID',
    appId: 'YOUR_APP_ID',
  );

  runApp(MyApp());
}

3. 使用 fire_api_dart 进行认证

fire_api_dart 提供了与 Firebase 认证的集成。你可以使用它来注册、登录、注销用户等。

import 'package:fire_api_dart/fire_api_dart.dart';

class AuthService {
  final FireApiDart _fireApi = FireApiDart.instance;

  Future<void> signUp(String email, String password) async {
    try {
      await _fireApi.auth.signUpWithEmailAndPassword(email, password);
    } catch (e) {
      print('Sign up failed: $e');
    }
  }

  Future<void> signIn(String email, String password) async {
    try {
      await _fireApi.auth.signInWithEmailAndPassword(email, password);
    } catch (e) {
      print('Sign in failed: $e');
    }
  }

  Future<void> signOut() async {
    try {
      await _fireApi.auth.signOut();
    } catch (e) {
      print('Sign out failed: $e');
    }
  }
}

4. 使用 fire_api_dart 进行 Firestore 操作

fire_api_dart 还提供了与 Firestore 数据库的集成。你可以使用它来读取、写入和更新数据。

import 'package:fire_api_dart/fire_api_dart.dart';

class FirestoreService {
  final FireApiDart _fireApi = FireApiDart.instance;

  Future<void> addData(String collection, Map<String, dynamic> data) async {
    try {
      await _fireApi.firestore.collection(collection).add(data);
    } catch (e) {
      print('Failed to add data: $e');
    }
  }

  Future<void> updateData(String collection, String docId, Map<String, dynamic> data) async {
    try {
      await _fireApi.firestore.collection(collection).doc(docId).update(data);
    } catch (e) {
      print('Failed to update data: $e');
    }
  }

  Future<void> deleteData(String collection, String docId) async {
    try {
      await _fireApi.firestore.collection(collection).doc(docId).delete();
    } catch (e) {
      print('Failed to delete data: $e');
    }
  }

  Future<Map<String, dynamic>> getData(String collection, String docId) async {
    try {
      var doc = await _fireApi.firestore.collection(collection).doc(docId).get();
      return doc.data();
    } catch (e) {
      print('Failed to get data: $e');
      return null;
    }
  }
}

5. 使用 fire_api_dart 进行云存储操作

fire_api_dart 还支持与 Firebase 云存储的集成。你可以使用它来上传和下载文件。

import 'package:fire_api_dart/fire_api_dart.dart';

class StorageService {
  final FireApiDart _fireApi = FireApiDart.instance;

  Future<void> uploadFile(String path, File file) async {
    try {
      await _fireApi.storage.ref(path).putFile(file);
    } catch (e) {
      print('Failed to upload file: $e');
    }
  }

  Future<File> downloadFile(String path) async {
    try {
      var url = await _fireApi.storage.ref(path).getDownloadURL();
      var response = await http.get(url);
      return File.fromRawPath(response.bodyBytes);
    } catch (e) {
      print('Failed to download file: $e');
      return null;
    }
  }
}

6. 使用 fire_api_dart 调用云函数

fire_api_dart 还支持调用 Firebase 云函数。

import 'package:fire_api_dart/fire_api_dart.dart';

class CloudFunctionService {
  final FireApiDart _fireApi = FireApiDart.instance;

  Future<void> callFunction(String functionName, Map<String, dynamic> data) async {
    try {
      await _fireApi.functions.call(functionName, data);
    } catch (e) {
      print('Failed to call function: $e');
    }
  }
}

7. 使用 fire_api_dart 进行 RESTful API 调用

fire_api_dart 还支持与其他 RESTful API 进行交互。

import 'package:fire_api_dart/fire_api_dart.dart';

class ApiService {
  final FireApiDart _fireApi = FireApiDart.instance;

  Future<Map<String, dynamic>> get(String url) async {
    try {
      var response = await _fireApi.http.get(url);
      return response.data;
    } catch (e) {
      print('Failed to get data: $e');
      return null;
    }
  }

  Future<Map<String, dynamic>> post(String url, Map<String, dynamic> data) async {
    try {
      var response = await _fireApi.http.post(url, data: data);
      return response.data;
    } catch (e) {
      print('Failed to post data: $e');
      return null;
    }
  }
}