res_client 是一个 Flutter 插件，用于在 Flutter 应用中管理和访问资源文件。它提供了一种简单的方式来加载、缓存和使用资源文件，如图片、JSON 文件、文本文件等。以下是一些常见的功能和使用方法：

1. 安装插件

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

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

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

2. 初始化 ResClient

在使用 res_client 之前，你需要初始化 ResClient 实例。通常，你可以在应用的 main 函数中进行初始化：

import 'package:res_client/res_client.dart';

void main() {
  final resClient = ResClient();
  runApp(MyApp(resClient: resClient));
}

3. 加载资源文件

res_client 提供了多种方法来加载不同类型的资源文件。

加载图片

你可以使用 loadImage 方法来加载图片资源：

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

class MyApp extends StatelessWidget {
  final ResClient resClient;

  MyApp({required this.resClient});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('ResClient Example')),
        body: Center(
          child: FutureBuilder<Image>(
            future: resClient.loadImage('assets/images/my_image.png'),
            builder: (context, snapshot) {
              if (snapshot.connectionState == ConnectionState.done) {
                if (snapshot.hasData) {
                  return snapshot.data!;
                } else {
                  return Text('Failed to load image');
                }
              } else {
                return CircularProgressIndicator();
              }
            },
          ),
        ),
      ),
    );
  }
}

加载 JSON 文件

你可以使用 loadJson 方法来加载 JSON 文件：

Future<void> loadJsonExample() async {
  final json = await resClient.loadJson('assets/data/my_data.json');
  print(json);
}

加载文本文件

你可以使用 loadText 方法来加载文本文件：

Future<void> loadTextExample() async {
  final text = await resClient.loadText('assets/texts/my_text.txt');
  print(text);
}

4. 缓存资源

res_client 提供了缓存机制，可以避免重复加载相同的资源文件。你可以通过 ResClient 的构造函数来配置缓存策略：

final resClient = ResClient(
  cacheMaxSize: 100,  // 缓存的最大大小
  cacheExpiry: Duration(minutes: 30),  // 缓存的过期时间
);

5. 清除缓存

你可以使用 clearCache 方法来清除缓存：

resClient.clearCache();

6. 错误处理

在加载资源时，可能会遇到各种错误，如文件不存在、网络错误等。你可以使用 try-catch 来捕获和处理这些错误：

try {
  final image = await resClient.loadImage('assets/images/my_image.png');
} catch (e) {
  print('Error loading image: $e');
}

7. 自定义资源加载器

如果你需要自定义资源加载逻辑，你可以实现 ResourceLoader 接口，并将其传递给 ResClient：

class MyCustomLoader implements ResourceLoader {
  @override
  Future<Uint8List> load(String path) async {
    // 自定义加载逻辑
  }
}

final resClient = ResClient(loader: MyCustomLoader());

8. 使用网络资源

res_client 也支持从网络加载资源。你可以直接传递一个 URL 来加载网络资源：

final image = await resClient.loadImage('https://example.com/my_image.png');

9. 使用本地文件系统

你还可以使用 res_client 来加载本地文件系统中的资源：

final image = await resClient.loadImage('/path/to/local/image.png');

10. 监听资源加载进度

res_client 提供了进度监听功能，你可以通过 onProgress 回调来监听资源加载的进度：

final image = await resClient.loadImage(
  'https://example.com/my_image.png',
  onProgress: (received, total) {
    print('Progress: $received / $total');
  },
);