在Flutter中，budgeting_module 是一个用于预算管理的插件，它可以帮助你管理用户的收入和支出，跟踪预算，并提供相关的统计信息。以下是如何使用 budgeting_module 的基本步骤：

1. 添加依赖

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

dependencies:
  flutter:
    sdk: flutter
  budgeting_module: ^1.0.0  # 请使用最新的版本号

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

2. 导入插件

在你的 Dart 文件中导入 budgeting_module：

import 'package:budgeting_module/budgeting_module.dart';

3. 初始化插件

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await BudgetingModule.initialize();
  runApp(MyApp());
}

4. 添加收入和支出

你可以使用 BudgetingModule 来添加用户的收入和支出：

// 添加收入
await BudgetingModule.addIncome(Income(
  amount: 1000.0,
  category: 'Salary',
  date: DateTime.now(),
  description: 'Monthly salary',
));

// 添加支出
await BudgetingModule.addExpense(Expense(
  amount: 200.0,
  category: 'Groceries',
  date: DateTime.now(),
  description: 'Weekly groceries',
));

5. 获取预算数据

你可以获取用户的预算数据，例如总收入和总支出：

// 获取总收入
double totalIncome = await BudgetingModule.getTotalIncome();

// 获取总支出
double totalExpense = await BudgetingModule.getTotalExpense();

// 获取剩余预算
double remainingBudget = totalIncome - totalExpense;

6. 获取分类统计

你可以获取按类别统计的收入和支出：

// 获取按类别的收入统计
Map<String, double> incomeByCategory = await BudgetingModule.getIncomeByCategory();

// 获取按类别的支出统计
Map<String, double> expenseByCategory = await BudgetingModule.getExpenseByCategory();

7. 删除记录

你可以删除特定的收入或支出记录：

// 删除收入记录
await BudgetingModule.deleteIncome(incomeId);

// 删除支出记录
await BudgetingModule.deleteExpense(expenseId);

8. 更新记录

你可以更新现有的收入或支出记录：

// 更新收入记录
await BudgetingModule.updateIncome(Income(
  id: incomeId,
  amount: 1200.0,
  category: 'Salary',
  date: DateTime.now(),
  description: 'Updated monthly salary',
));

// 更新支出记录
await BudgetingModule.updateExpense(Expense(
  id: expenseId,
  amount: 250.0,
  category: 'Groceries',
  date: DateTime.now(),
  description: 'Updated weekly groceries',
));

9. 监听数据变化

你可以监听收入或支出数据的变化：

BudgetingModule.onIncomeChanged.listen((List<Income> incomes) {
  // 处理收入数据变化
});

BudgetingModule.onExpenseChanged.listen((List<Expense> expenses) {
  // 处理支出数据变化
});

10. 使用示例

以下是一个简单的示例，展示如何使用 budgeting_module 来管理预算：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await BudgetingModule.initialize();
  runApp(BudgetApp());
}

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

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

class _BudgetScreenState extends State<BudgetScreen> {
  double totalIncome = 0.0;
  double totalExpense = 0.0;

  [@override](/user/override)
  void initState() {
    super.initState();
    _loadBudgetData();
  }

  Future<void> _loadBudgetData() async {
    totalIncome = await BudgetingModule.getTotalIncome();
    totalExpense = await BudgetingModule.getTotalExpense();
    setState(() {});
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Budget Management'),
      ),
      body: Column(
        children: [
          Text('Total Income: \$${totalIncome.toStringAsFixed(2)}'),
          Text('Total Expense: \$${totalExpense.toStringAsFixed(2)}'),
          Text('Remaining Budget: \$${(totalIncome - totalExpense).toStringAsFixed(2)}'),
        ],
      ),
    );
  }
}