flutter_hi_cache_c3 是一个用于 Flutter 应用的缓存管理插件，它可以帮助你在应用中存储和读取缓存数据。使用这个插件，你可以轻松地在本地存储键值对数据、对象等。

以下是如何使用 flutter_hi_cache_c3 插件的步骤：

1. 添加依赖

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

dependencies:
  flutter:
    sdk: flutter
  flutter_hi_cache_c3: ^1.0.0  # 请确保使用最新版本

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

2. 初始化缓存

在使用缓存之前，你需要初始化缓存管理器。通常你可以在应用的 main 函数中进行初始化：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await HiCache.preInit(); // 预初始化缓存
  runApp(MyApp());
}

3. 使用缓存

初始化之后，你就可以在应用中使用缓存了。以下是一些常见的操作：

存储数据

你可以使用 HiCache.getInstance() 来获取缓存实例，然后使用 setString, setInt, setBool, setDouble, setObject 等方法来存储数据。

import 'package:flutter_hi_cache_c3/flutter_hi_cache_c3.dart';

void storeData() {
  var cache = HiCache.getInstance();
  
  // 存储字符串
  cache.setString('key_string', 'Hello, World!');
  
  // 存储整数
  cache.setInt('key_int', 123);
  
  // 存储布尔值
  cache.setBool('key_bool', true);
  
  // 存储对象
  cache.setObject('key_object', {'name': 'John', 'age': 30});
}

读取数据

你可以使用 getString, getInt, getBool, getDouble, getObject 等方法来读取缓存中的数据。

import 'package:flutter_hi_cache_c3/flutter_hi_cache_c3.dart';

void readData() {
  var cache = HiCache.getInstance();
  
  // 读取字符串
  String? stringValue = cache.getString('key_string');
  print('String Value: $stringValue');
  
  // 读取整数
  int? intValue = cache.getInt('key_int');
  print('Int Value: $intValue');
  
  // 读取布尔值
  bool? boolValue = cache.getBool('key_bool');
  print('Bool Value: $boolValue');
  
  // 读取对象
  Map<String, dynamic>? objectValue = cache.getObject('key_object');
  print('Object Value: $objectValue');
}

删除数据

你可以使用 remove 方法来删除缓存中的某个键值对。

import 'package:flutter_hi_cache_c3/flutter_hi_cache_c3.dart';

void deleteData() {
  var cache = HiCache.getInstance();
  
  // 删除某个键值对
  cache.remove('key_string');
}

清空缓存

你可以使用 clear 方法来清空所有缓存数据。

import 'package:flutter_hi_cache_c3/flutter_hi_cache_c3.dart';

void clearCache() {
  var cache = HiCache.getInstance();
  
  // 清空所有缓存
  cache.clear();
}

4. 其他注意事项

• flutter_hi_cache_c3 插件是基于 shared_preferences 实现的，因此它的存储方式与 shared_preferences 类似，适合存储小量的数据。
• 如果你需要存储大量的数据或复杂的结构，可能需要考虑使用其他存储方式，如 SQLite 或文件存储。

5. 示例代码

以下是一个完整的示例代码，展示了如何使用 flutter_hi_cache_c3 插件进行缓存管理：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await HiCache.preInit();
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Cache Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: CacheDemo(),
    );
  }
}

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

class _CacheDemoState extends State<CacheDemo> {
  var cache = HiCache.getInstance();

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Cache Demo'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            ElevatedButton(
              onPressed: () {
                cache.setString('key_string', 'Hello, World!');
                cache.setInt('key_int', 123);
                cache.setBool('key_bool', true);
                cache.setObject('key_object', {'name': 'John', 'age': 30});
              },
              child: Text('Store Data'),
            ),
            ElevatedButton(
              onPressed: () {
                String? stringValue = cache.getString('key_string');
                int? intValue = cache.getInt('key_int');
                bool? boolValue = cache.getBool('key_bool');
                Map<String, dynamic>? objectValue = cache.getObject('key_object');
                print('String Value: $stringValue');
                print('Int Value: $intValue');
                print('Bool Value: $boolValue');
                print('Object Value: $objectValue');
              },
              child: Text('Read Data'),
            ),
            ElevatedButton(
              onPressed: () {
                cache.remove('key_string');
              },
              child: Text('Delete Data'),
            ),
            ElevatedButton(
              onPressed: () {
                cache.clear();
              },
              child: Text('Clear Cache'),
            ),
          ],
        ),
      ),
    );
  }
}