save_projects 是一个用于 Flutter 项目的插件，它可以帮助开发者保存和管理项目状态。通过这个插件，你可以轻松地保存和恢复项目的状态，以便在应用重启或页面切换时保持数据的持久性。

安装插件

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

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

然后运行 flutter pub get 来安装插件。

基本用法

1. 初始化插件

在使用 save_projects 之前，你需要在应用的入口处初始化插件。通常可以在 main.dart 文件中进行初始化：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await SaveProjects.init();  // 初始化插件
  runApp(MyApp());
}

2. 保存项目状态

你可以使用 SaveProjects.save 方法来保存项目状态。这个方法接受一个 key 和一个 value，value 可以是任何可序列化的数据（如 Map, List, String, int, double, bool 等）。

void saveProject() async {
  await SaveProjects.save('project_key', {
    'name': 'My Project',
    'progress': 0.75,
    'last_updated': DateTime.now().toString(),
  });
}

3. 读取项目状态

你可以使用 SaveProjects.load 方法来读取之前保存的项目状态。这个方法接受一个 key，并返回一个 Future，解析为保存的数据。

void loadProject() async {
  var projectData = await SaveProjects.load('project_key');
  if (projectData != null) {
    print('Project Name: ${projectData['name']}');
    print('Progress: ${projectData['progress']}');
    print('Last Updated: ${projectData['last_updated']}');
  } else {
    print('No project data found.');
  }
}

4. 删除项目状态

如果你不再需要某个保存的项目状态，可以使用 SaveProjects.delete 方法来删除它。

void deleteProject() async {
  await SaveProjects.delete('project_key');
}

高级用法

1. 保存多个项目

你可以使用不同的 key 来保存多个项目状态。例如：

void saveMultipleProjects() async {
  await SaveProjects.save('project_1', {'name': 'Project 1'});
  await SaveProjects.save('project_2', {'name': 'Project 2'});
}

2. 列出所有保存的项目

你可以使用 SaveProjects.listKeys 方法来获取所有保存的项目的 key。

void listProjects() async {
  var keys = await SaveProjects.listKeys();
  print('Saved Projects: $keys');
}

3. 清除所有保存的项目

你可以使用 SaveProjects.clear 方法来清除所有保存的项目状态。

void clearAllProjects() async {
  await SaveProjects.clear();
}

注意事项

• save_projects 插件使用本地存储来保存数据，因此数据是持久化的，即使应用重启也不会丢失。
• 由于数据是存储在设备上的，因此请确保不要保存敏感信息，或者对敏感信息进行加密处理。
• 插件的性能取决于存储的数据量和设备的存储性能，因此建议不要保存过大的数据。

示例代码

以下是一个完整的示例，展示了如何使用 save_projects 插件来保存、读取和删除项目状态：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await SaveProjects.init();
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Save Projects Example')),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              ElevatedButton(
                onPressed: saveProject,
                child: Text('Save Project'),
              ),
              ElevatedButton(
                onPressed: loadProject,
                child: Text('Load Project'),
              ),
              ElevatedButton(
                onPressed: deleteProject,
                child: Text('Delete Project'),
              ),
            ],
          ),
        ),
      ),
    );
  }

  void saveProject() async {
    await SaveProjects.save('project_key', {
      'name': 'My Project',
      'progress': 0.75,
      'last_updated': DateTime.now().toString(),
    });
    print('Project saved.');
  }

  void loadProject() async {
    var projectData = await SaveProjects.load('project_key');
    if (projectData != null) {
      print('Project Name: ${projectData['name']}');
      print('Progress: ${projectData['progress']}');
      print('Last Updated: ${projectData['last_updated']}');
    } else {
      print('No project data found.');
    }
  }

  void deleteProject() async {
    await SaveProjects.delete('project_key');
    print('Project deleted.');
  }
}