搜索插件、代码仓与 APP 分类

插件详情v1.2.1

disposable_cached_images

一个用于从内存中显示和释放图像的 Flutter 包。

近 30 天下载
155
喜欢数
36
Pub 分数
60

安装插件

flutter pub add disposable_cached_images

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

一个专为高效显示图像而设计的Flutter包,通过在不再需要时自动管理内存来释放图像。它通过临时缓存图像并在使用后及时释放,优化性能,减少图像密集型应用中的内存开销。非常适合动态加载大量图像的应用程序,如画廊或社交媒体动态流。该包可无缝集成到Flutter的图像加载管道中,支持本地和网络图像。有助于防止内存泄漏并提高应用程序的响应速度。

适合场景

  • 图像画廊
  • 社交媒体动态
  • 动态图像显示
  • 内存高效的图像加载
  • 实时照片预览

主要特点

  • 自动内存释放
  • 临时图像缓存
  • 支持网络和本地图片
  • 防止内存泄漏
  • 与 Flutter 的无缝集成

适合对象

  • 高图像密度的应用程序
  • 性能关键的UI
  • 内存受限环境
  • 开发人员优先考虑资源管理
  • 需要快速处理图像的应用程序

使用建议

  • 仅限基本缓存需求
  • 没有高级缓存淘汰策略
  • 不适用于持久图像存储
  • 在复杂情况下需要手动处理
  • 无内置图像压缩

原始 README

以下为关联源码仓库的 README 原文快照,最新内容请访问源码仓库。

A flutter package for downloading, caching, displaying and releasing images from memory.

Features

Display images from the Internet and/or local files (assets and device storage).

Caching images in the cache directory.

Cancel the download if the image widget has been disposed to reduce bandwidth usage.

Remove the image from memory if the image widget has been disposed to reduce device memory usage.

High performance due to the use of dart:isolate

Usage

Setting up

All you have to do is Initializing the cache and wrap the root widget with DisposableImages.

void main() {
  await DisposableImages.init();

  runApp(const DisposableImages(MyApp()));
}

Now your app is ready to use the package.

initialization options
maximumDecodedImagesCount

The maximum number of decoded images that should be kept in memory when using DisposableImages.decodedImages

maximumDecode

The maximum number of images to be decoded simultaneously

maximumDownload

The maximum number of images to be downloaded simultaneously

Displaying images

Use DisposableCachedImage named constructors to display images.

Obtaining an image from a URL
DisposableCachedImage.network(imageUrl: 'https://picsum.photos/id/23/200/300');
Obtaining a local image from assets using path
DisposableCachedImage.asset(imagePath: 'assets/images/a_dot_burr.jpeg');
Obtaining a local image from device storage using path
DisposableCachedImage.local(imagePath: 'assets/images/a_dot_burr.jpeg');
Obtaining an image from Uint8List
DisposableCachedImage.bytes(bytes: bytes);
Display dynamic height images

If you are using dynamic height images, you should declare this as shown below to avoid UI jumping

DisposableCachedImage.network(
  imageUrl: imageUrl,
  isDynamicHeight: true,
  width: MediaQuery.of(context).size.width * 0.3,
),

width required when displaying dynamic height images


You can display your custom widgets while the image is loading, downloading, has an error and when it is ready as shown below

DisposableCachedImage.network(
  imageUrl: 'https://picsum.photos/id/23/200/300',
  onLoading: (context) => const Center(
    child: Icon(Icons.downloading),
  ),
  progressBuilder: (context, progress) => Center(
    child: LinearProgressIndicator(value: progress),
  ),
  onError: (context, error, stackTrace, retryCall) => Center(
    child: IconButton(
      onPressed: retryCall,
      icon: const Icon(Icons.download),
    ),
  ),
  onImage: (context, imageWidget, height, width) => Stack(
    children: [
      imageWidget,
      MyWidget(),
    ],
  ),
);
Resize images

You can change the image size to the provided width and \ or height by enabling resizeImage (disabled by default) to reduce raster thread usage when using high resolution images, if this option is enabled the same provider instance would be used for the number of images that share the same url \ path with a different image size for each widget to have a gallery like experience.

To change the size of the images in bytes before they are saved to the storage, provide maxCacheWidth and \ or maxCacheHeight.

DisposableCachedImage.network(
 imageUrl: imageUrl,
 maxCacheWidth: 300,
 width: 200,
 resizeImage: true,
),
Clipping

You can clip the image either with rounded corners by providing BorderRadius

DisposableCachedImage.network(
  imageUrl: imageUrl,
  borderRadius: const BorderRadius.all(Radius.circular(20)),
),

Or by setting BoxShape to get oval image

DisposableCachedImage.network(
  imageUrl: imageUrl,
  shape: BoxShape.circle,
),
Keeping images alive

By default each image is removed from memory when it is not being used by any widget, however you can keep some images in memory for the entire application lifecycle as shown below

DisposableCachedImage.network(
  imageUrl: imageUrl,
  keepAlive: true,
),

The other arguments are similar if not quite the same as Image Widget


Decode images before displaying

You can use DisposableImages.decodedImages to decode images before displaying them in case you need to show images immediately without loading

  // decode network images
  DisposableImages.decodedImages.addNetwork(url);

  // decode loacl images
  DisposableImages.decodedImages.addLocal(path);

  // decode assets images
  DisposableImages.decodedImages.addAssets(path);

If you decode the images in this way, you will have to dispose the images manually or set the maximum number of decoded images

// set the maximum number of decoded images, old images will be removed if this number is exeeded
// this is optional and can be null
DisposableImages.init(maximumDecodedImagesCount: 100);


// dispose an image by key
// the key is path if the image is local or assets, if it's a network image the key is the url
DisposableImages.decodedImages.dispose(key);

// dispose all images
DisposableImages.decodedImages.disposeAll();
Remove all cached images from the device storage
DisposableCachedImage.clearCache();

How it works

The package uses RawImage with dart-ui-Image directly without the need for ImageProvider

Stores and retrieves files using dart:io.

Disposing and changing image state using flutter_riverpod with state_notifier.

Downloading images with dart:_http on other platforms.

Example app

The example directory has a sample application that uses this plugin.

Roadmap

Improve package documentation

Further improvements

所属分类

依赖

依赖清单 4 项

源码仓库

使用此插件的项目

暂无相关数据。