nanc_api_firebase 是一个用于在 Flutter 应用中集成 Firebase 的插件。它提供了一种简单的方式来与 Firebase 服务进行交互，例如 Firestore、Authentication、Storage 等。以下是如何在 Flutter 项目中使用 nanc_api_firebase 插件的步骤。

1. 添加依赖

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

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

然后运行 flutter pub get 来获取依赖。

2. 配置 Firebase

在使用 nanc_api_firebase 之前，你需要在 Firebase 控制台中创建一个项目，并按照以下步骤配置 Firebase。

2.1 添加 Firebase 配置文件

1. 在 Firebase 控制台中，进入你的项目。
2. 点击“项目设置”。
3. 在“常规”选项卡中，向下滚动到“你的应用”部分。
4. 点击“添加应用”并选择“Flutter”。
5. 按照指示下载 google-services.json 文件。
6. 将 google-services.json 文件放在你的 Flutter 项目的 android/app 目录下。

2.2 配置 Android 项目

在 android/app/build.gradle 文件中，添加以下内容：

apply plugin: 'com.android.application'
apply plugin: 'com.google.gms.google-services'  // 添加这一行

android {
    // 其他配置
}

dependencies {
    // 其他依赖
    implementation platform('com.google.firebase:firebase-bom:30.3.1')  // 添加这一行
    implementation 'com.google.firebase:firebase-analytics'  // 添加这一行
}

在 android/build.gradle 文件中，添加以下内容：

buildscript {
    dependencies {
        classpath 'com.google.gms:google-services:4.3.10'  // 添加这一行
    }
}

2.3 配置 iOS 项目

在 ios/Runner/Info.plist 文件中，添加以下内容：

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleTypeRole</key>
        <string>Editor</string>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>YOUR_REVERSED_CLIENT_ID</string>
        </array>
    </dict>
</array>

3. 初始化 Firebase

在你的 Flutter 应用的 main.dart 文件中，初始化 Firebase。

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

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Firebase Demo',
      home: HomeScreen(),
    );
  }
}

4. 使用 nanc_api_firebase 插件

现在你可以使用 nanc_api_firebase 插件来与 Firebase 服务进行交互。以下是一些常见的用例。

4.1 使用 Firestore

import 'package:nanc_api_firebase/nanc_api_firebase.dart';

Future<void> addDataToFirestore() async {
  final firestore = FirebaseFirestore.instance;
  await firestore.collection('users').doc('user1').set({
    'name': 'John Doe',
    'age': 30,
  });
}

Future<void> getDataFromFirestore() async {
  final firestore = FirebaseFirestore.instance;
  final doc = await firestore.collection('users').doc('user1').get();
  print(doc.data());
}

4.2 使用 Authentication

import 'package:nanc_api_firebase/nanc_api_firebase.dart';

Future<void> signInWithEmailAndPassword() async {
  final auth = FirebaseAuth.instance;
  final userCredential = await auth.signInWithEmailAndPassword(
    email: 'user@example.com',
    password: 'password123',
  );
  print(userCredential.user);
}

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

4.3 使用 Storage

import 'package:nanc_api_firebase/nanc_api_firebase.dart';

Future<void> uploadFile() async {
  final storage = FirebaseStorage.instance;
  final ref = storage.ref().child('images/image1.jpg');
  final uploadTask = ref.putFile(File('path/to/image.jpg'));
  await uploadTask.whenComplete(() => print('File uploaded'));
}

Future<void> downloadFile() async {
  final storage = FirebaseStorage.instance;
  final ref = storage.ref().child('images/image1.jpg');
  final url = await ref.getDownloadURL();
  print(url);
}

5. 处理错误

在使用 Firebase 服务时，可能会遇到各种错误。确保你正确处理这些错误，以提供更好的用户体验。

try {
  await FirebaseAuth.instance.signInWithEmailAndPassword(
    email: 'user@example.com',
    password: 'wrongpassword',
  );
} on FirebaseAuthException catch (e) {
  if (e.code == 'user-not-found') {
    print('No user found for that email.');
  } else if (e.code == 'wrong-password') {
    print('Wrong password provided.');
  }
}