ds_cache 是一个用于 Flutter 的本地缓存管理插件，它可以帮助你在应用中轻松地管理本地缓存数据。以下是如何使用 ds_cache 插件的基本步骤：

1. 添加依赖

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

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

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

2. 初始化缓存

在使用 ds_cache 之前，你需要先初始化缓存。通常你可以在 main.dart 中初始化：

import 'package:ds_cache/ds_cache.dart';

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

3. 使用缓存

ds_cache 提供了多种方法来管理缓存数据，包括存储、获取、删除等操作。

存储数据

你可以使用 set 方法将数据存储到缓存中：

await DsCache.set('key', 'value');  // 存储字符串
await DsCache.set('key', 123);      // 存储整数
await DsCache.set('key', true);     // 存储布尔值
await DsCache.set('key', {'a': 1}); // 存储Map
await DsCache.set('key', [1, 2, 3]);// 存储List

获取数据

你可以使用 get 方法来获取缓存中的数据：

String? stringValue = await DsCache.get<String>('key');
int? intValue = await DsCache.get<int>('key');
bool? boolValue = await DsCache.get<bool>('key');
Map<String, dynamic>? mapValue = await DsCache.get<Map<String, dynamic>>('key');
List<int>? listValue = await DsCache.get<List<int>>('key');

删除数据

你可以使用 remove 方法来删除缓存中的数据：

await DsCache.remove('key');

清空缓存

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

await DsCache.clear();

检查缓存是否存在

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

bool exists = await DsCache.containsKey('key');

4. 其他功能

ds_cache 还提供了其他一些功能，例如设置缓存的过期时间、获取所有缓存的键等。

设置缓存过期时间

你可以使用 setWithExpiry 方法来设置缓存的过期时间：

await DsCache.setWithExpiry('key', 'value', Duration(minutes: 10));  // 10分钟后过期

获取所有缓存的键

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

List<String> keys = await DsCache.getKeys();

5. 示例代码

以下是一个完整的示例代码，展示了如何使用 ds_cache 插件：

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

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

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

class CacheExample extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('ds_cache Example'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: () async {
                await DsCache.set('key', 'Hello, ds_cache!');
                print('Data stored in cache');
              },
              child: Text('Store Data'),
            ),
            ElevatedButton(
              onPressed: () async {
                String? value = await DsCache.get<String>('key');
                print('Data from cache: $value');
              },
              child: Text('Get Data'),
            ),
            ElevatedButton(
              onPressed: () async {
                await DsCache.remove('key');
                print('Data removed from cache');
              },
              child: Text('Remove Data'),
            ),
            ElevatedButton(
              onPressed: () async {
                await DsCache.clear();
                print('Cache cleared');
              },
              child: Text('Clear Cache'),
            ),
          ],
        ),
      ),
    );
  }
}