storagebox 是一个用于 Flutter 的轻量级数据存储插件，适用于在本地存储小型数据。它提供了一个简单的 API 来存储和读取数据，类似于键值对存储。以下是如何在 Flutter 项目中使用 storagebox 插件的详细步骤。

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 storagebox 依赖：

dependencies:
  flutter:
    sdk: flutter
  storagebox: ^1.0.0  # 请根据最新版本替换

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

2. 初始化 StorageBox

在你的 Dart 文件中，导入 storagebox 并初始化一个 StorageBox 实例：

import 'package:storagebox/storagebox.dart';

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

3. 存储数据

使用 StorageBox 实例来存储数据。你可以存储字符串、整数、布尔值、列表、Map 等类型的数据。

void storeData() async {
  await StorageBox.put('key1', 'value1');  // 存储字符串
  await StorageBox.put('key2', 42);        // 存储整数
  await StorageBox.put('key3', true);      // 存储布尔值
  await StorageBox.put('key4', [1, 2, 3]); // 存储列表
  await StorageBox.put('key5', {'name': 'Flutter', 'version': 3.0}); // 存储 Map
}

4. 读取数据

使用 StorageBox 实例来读取存储的数据：

void readData() async {
  String? value1 = await StorageBox.get('key1');
  int? value2 = await StorageBox.get('key2');
  bool? value3 = await StorageBox.get('key3');
  List<int>? value4 = await StorageBox.get('key4');
  Map<String, dynamic>? value5 = await StorageBox.get('key5');
  
  print('key1: $value1');
  print('key2: $value2');
  print('key3: $value3');
  print('key4: $value4');
  print('key5: $value5');
}

5. 删除数据

你可以使用 StorageBox 实例来删除存储的数据：

void deleteData() async {
  await StorageBox.delete('key1');  // 删除指定的键值对
}

6. 清除所有数据

如果你想清除所有存储的数据，可以使用 clear 方法：

void clearAllData() async {
  await StorageBox.clear();  // 清除所有数据
}

7. 检查是否存在某个键

你可以检查某个键是否存在于 StorageBox 中：

void checkKeyExists() async {
  bool exists = await StorageBox.containsKey('key1');
  print('key1 exists: $exists');
}

8. 监听数据变化

StorageBox 还支持监听数据的变化：

void listenToChanges() {
  StorageBox.listen('key1', (value) {
    print('key1 changed: $value');
  });
}

9. 使用示例

以下是一个完整的示例，展示了如何在 Flutter 应用中使用 StorageBox：

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('StorageBox Example')),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              ElevatedButton(
                onPressed: storeData,
                child: Text('Store Data'),
              ),
              ElevatedButton(
                onPressed: readData,
                child: Text('Read Data'),
              ),
              ElevatedButton(
                onPressed: deleteData,
                child: Text('Delete Data'),
              ),
              ElevatedButton(
                onPressed: clearAllData,
                child: Text('Clear All Data'),
              ),
            ],
          ),
        ),
      ),
    );
  }

  void storeData() async {
    await StorageBox.put('key1', 'value1');
    await StorageBox.put('key2', 42);
    await StorageBox.put('key3', true);
    await StorageBox.put('key4', [1, 2, 3]);
    await StorageBox.put('key5', {'name': 'Flutter', 'version': 3.0});
  }

  void readData() async {
    String? value1 = await StorageBox.get('key1');
    int? value2 = await StorageBox.get('key2');
    bool? value3 = await StorageBox.get('key3');
    List<int>? value4 = await StorageBox.get('key4');
    Map<String, dynamic>? value5 = await StorageBox.get('key5');
    
    print('key1: $value1');
    print('key2: $value2');
    print('key3: $value3');
    print('key4: $value4');
    print('key5: $value5');
  }

  void deleteData() async {
    await StorageBox.delete('key1');
  }

  void clearAllData() async {
    await StorageBox.clear();
  }
}