hy_local_storage 是一个用于 Flutter 应用中的本地存储插件，它提供了简单易用的 API 来存储和检索数据。这个插件通常用于存储小型数据，如用户偏好设置、缓存数据等。

以下是 hy_local_storage 插件的基本使用方法：

1. 添加依赖

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

dependencies:
  hy_local_storage: ^1.0.0  # 请使用最新版本

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

2. 初始化插件

在你的 Flutter 应用中，你需要在应用启动时初始化 hy_local_storage 插件。通常可以在 main.dart 文件中进行初始化：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await HyLocalStorage.init();  // 初始化本地存储插件
  runApp(MyApp());
}

3. 存储数据

你可以使用 HyLocalStorage 提供的 setString, setInt, setBool, setDouble, setStringList 等方法来存储数据：

void saveData() async {
  await HyLocalStorage.setString('username', 'JohnDoe');
  await HyLocalStorage.setInt('age', 30);
  await HyLocalStorage.setBool('isLoggedIn', true);
}

4. 读取数据

你可以使用 getString, getInt, getBool, getDouble, getStringList 等方法来读取存储的数据：

void readData() async {
  String? username = await HyLocalStorage.getString('username');
  int? age = await HyLocalStorage.getInt('age');
  bool? isLoggedIn = await HyLocalStorage.getBool('isLoggedIn');

  print('Username: $username');
  print('Age: $age');
  print('Is Logged In: $isLoggedIn');
}

5. 删除数据

你可以使用 remove 方法来删除指定的键值对：

void deleteData() async {
  await HyLocalStorage.remove('username');
}

6. 清空所有数据

你可以使用 clear 方法来清空所有存储的数据：

void clearData() async {
  await HyLocalStorage.clear();
}

7. 检查是否存在某个键

你可以使用 containsKey 方法来检查某个键是否存在：

void checkKey() async {
  bool containsKey = await HyLocalStorage.containsKey('username');
  print('Contains username key: $containsKey');
}

8. 获取所有键

你可以使用 getKeys 方法来获取所有存储的键：

void getAllKeys() async {
  Set<String> keys = await HyLocalStorage.getKeys();
  print('All keys: $keys');
}

9. 监听存储变化

你可以使用 onChange 方法来监听存储的变化：

void listenToChanges() {
  HyLocalStorage.onChange.listen((event) {
    print('Storage changed: $event');
  });
}

10. 使用示例

以下是一个完整的示例，展示了如何使用 hy_local_storage 插件来存储和读取数据：

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

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

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

  void saveData() async {
    await HyLocalStorage.setString('username', 'JohnDoe');
    await HyLocalStorage.setInt('age', 30);
    await HyLocalStorage.setBool('isLoggedIn', true);
    print('Data saved');
  }

  void readData() async {
    String? username = await HyLocalStorage.getString('username');
    int? age = await HyLocalStorage.getInt('age');
    bool? isLoggedIn = await HyLocalStorage.getBool('isLoggedIn');

    print('Username: $username');
    print('Age: $age');
    print('Is Logged In: $isLoggedIn');
  }

  void deleteData() async {
    await HyLocalStorage.remove('username');
    print('Username deleted');
  }

  void clearData() async {
    await HyLocalStorage.clear();
    print('All data cleared');
  }
}