Flutter如何使用flutter_cache_manager插件

我在Flutter项目中需要使用flutter_cache_manager插件来管理网络图片缓存，但不太清楚具体如何实现。能否详细说明以下操作步骤：

  1. 如何正确安装和配置这个插件？
  2. 缓存的基本使用方法是什么？
  3. 如何设置缓存过期时间和最大缓存数量？
  4. 有没有清除特定缓存或全部缓存的方法？
  5. 在使用过程中有哪些需要注意的常见问题？
2 回复

使用flutter_cache_manager缓存网络图片或文件：

  1. 添加依赖到pubspec.yaml：
dependencies:
  flutter_cache_manager: ^3.3.0
  1. 基本用法：
import 'package:flutter_cache_manager/flutter_cache_manager.dart';

// 获取文件
var file = await DefaultCacheManager().getSingleFile(url);

// 清除缓存
await DefaultCacheManager().emptyCache();

支持自定义缓存策略、缓存大小限制等配置。

更多关于Flutter如何使用flutter_cache_manager插件的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


Flutter 中使用 flutter_cache_manager 插件可以方便地缓存网络文件（如图片、PDF 等），提升加载速度和离线访问能力。以下是使用步骤和示例代码：

1. 添加依赖

在 pubspec.yaml 文件中添加依赖：

dependencies:
  flutter_cache_manager: ^3.3.0

运行 flutter pub get 安装。

2. 基本用法

获取文件并缓存

通过 DefaultCacheManager() 获取单例实例，调用 getSingleFile(url) 下载并缓存文件：

import 'package:flutter_cache_manager/flutter_cache_manager.dart';

void loadFile() async {
  var cacheManager = DefaultCacheManager();
  var file = await cacheManager.getSingleFile(
    'https://example.com/image.jpg',
  );
  // 使用 file（类型为 File）
}

与 Image 组件结合

配合 cached_network_image 插件（需单独安装）显示缓存图片：

CachedNetworkImage(
  imageUrl: 'https://example.com/image.jpg',
  cacheManager: DefaultCacheManager(),
  placeholder: (context, url) => CircularProgressIndicator(),
  errorWidget: (context, url, error) => Icon(Icons.error),
),

3. 高级配置

自定义缓存管理器（例如调整缓存时长）：

class CustomCacheManager extends BaseCacheManager {
  static const key = 'customCache';
  static const Duration maxAgeCache = Duration(days: 30); // 缓存30天

  CustomCacheManager()
      : super(
          key,
          maxAgeCache: maxAgeCache,
          fileService: HttpFileService(),
        );

  @override
  Future<String> getFilePath() async {
    var directory = await getTemporaryDirectory();
    return '${directory.path}/$key';
  }
}

// 使用自定义管理器
var customManager = CustomCacheManager();
var file = await customManager.getSingleFile('https://example.com/file.pdf');

4. 常用方法

  • 清除缓存：await cacheManager.emptyCache();
  • 移除单个文件：await cacheManager.removeFile(url);
  • 获取缓存信息：await cacheManager.getFileFromCache(url);

注意事项

  • 缓存文件默认存储在设备临时目录，应用卸载时自动清除。
  • 支持通过 maxAge 参数控制缓存有效期（默认 30 天）。

通过以上步骤，可高效管理网络资源缓存，优化用户体验。

回到顶部