패키지, 저장소 및 앱 카테고리 검색

패키지 상세v4.13.2

cached_network_image_ce

네트워크 이미지를 로드하고 캐시하는 커뮤니티 에디션 플러터 라이브러리입니다. 플레이스홀더 및 오류 위젯과 함께 사용할 수도 있습니다.

AndroidiOSmacOSWindowsLinux
30일 다운로드
18.7만
좋아요
109
Pub 점수
160

패키지 설치

flutter pub add cached_network_image_ce

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

네트워크 이미지를 효율적으로 로드하고 캐시하는 커뮤니티 에디션 플러터 패키지입니다. 로딩 중에는 자리 표시자와 이미지 가져오기 실패 시 오류 위젯을 지원합니다. 이미지를 로컬에 저장함으로써 중복된 네트워크 요청을 줄이고 성능을 향상시키도록 설계되었습니다. Android, iOS, macOS, Windows, Linux 등 여러 플랫폼과 호환됩니다. 소셜 미디어 피드나 제품 카탈로그처럼 수많은 원격 이미지를 표시하는 앱에 적합합니다.

사용 사례

  • 목록 보기에서 URL에서 이미지 로드
  • 이미지가 로드되는 동안 자리 표시자 표시
  • 이미지 로드 실패를 유연하게 처리하기
  • 대역폭 사용량을 줄이기 위해 이미지를 캐시합니다
  • 로컬 이미지 저장을 통한 앱 성능 향상

주요 기능

  • 성능 향상을 위한 이미지 캐싱
  • 플레이스홀더 및 오류 위젯 지원
  • 크로스 플랫폼 호환성
  • 효율적인 메모리 관리
  • 사용자 정의 옵션이 있는 간단한 API

적합한 대상

  • 자주 이미지를 로드하는 앱
  • 소셜 미디어 또는 전자상거래 애플리케이션
  • 경량 이미지 캐싱을 찾는 개발자
  • 신뢰할 수 있는 백업 UI가 필요한 프로젝트
  • 커뮤니티 유지 관리 패키지를 사용하는 팀

고려 사항

  • 모바일 플랫폼에서는 인터넷 권한이 필요합니다
  • 시간이 지남에 따라 장치 스토리지가 소모될 수 있습니다
  • 기본 사용에서는 캐시 크기를 구성할 수 없습니다
  • 제한된 고급 캐시 제어 기능
  • 업데이트를 위해 외부 저장소에 의존합니다

원본 README

연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.

cached_network_image_ce banner

pub package Listed on Flutter Gems CI status License: MIT GitHub stars GitHub Sponsors

Powered by hive_ce 8x faster cache reads Platform support

Zero-jank image caching for Flutter

cached_network_image_ce is the actively maintained fork of cached_network_image, rebuilt around a caching engine that doesn't block your UI thread. Same widget and provider API you already use.


Table of contents

Why this fork exists

cached_network_image by Baseflow is one of the most widely used packages in the Flutter ecosystem. It has also been effectively unmaintained since August 2024, sitting on 300+ open issues, including memory leaks and scroll-performance bugs that never got fixed.

Under the hood it leans on sqflite for cache metadata: a full SQL engine routed through a platform channel just to answer "have I already downloaded this image?" On image-heavy lists, that overhead shows up as jank you can feel.

We didn't fork this just to merge dependabot PRs. We rebuilt the caching layer.

We swapped sqflite for hive_ce, a pure-Dart, non-blocking key-value store. It skips the platform channel round trip and the SQL parser entirely, so there's no jank left to fix.

How we stack up

vs. the original cached_network_image:

Original (cached_network_image) This fork (cached_network_image_ce)
Cache backend sqflite (platform channel) ✅ hive_ce (pure Dart)
Maintenance ❌ stale since Aug 2024 ✅ active, regular releases
Web caching ⚠️ browser cache only ✅ full persistent IndexedDB cache
HTTP / cache interceptors ❌ ✅ full chains (auth, logging, custom responses)
Cache eviction ❌ fixed ✅ pluggable — TTL or LRU
Cache read (10 KB) 16 ms ✅ 2 ms — 8x faster
Unsupported formats (SVG/AVIF/HEIC) ❌ opaque decode error ✅ unsupportedImageBuilder hook

vs. other popular alternatives, checked live against pub.dev, so this is current rather than a guess:

Package Cache backend Web support Interceptors Cleanup strategy Maintenance
cached_network_image_ce (this) hive_ce ✅ full IndexedDB ✅ HTTP + cache ✅ TTL / LRU ✅ active
cached_network_image sqflite ⚠️ browser only ❌ ❌ fixed ❌ stale
flutter_cache_manager sqflite / plain JSON ✅ ❌ ❌ fixed ✅ active
extended_image undisclosed ✅ ⚠️ headers/retry only ⚠️ manual clear ✅ active
fast_cached_network_image hive (plain) ✅ (claimed) ❌ ⚠️ TTL only ⚠️ stale (17mo)

Worth saying plainly: flutter_cache_manager and extended_image are both actively maintained by reputable teams. They're solving different problems than we are: a generic file cache, and a broad image/gesture toolkit, respectively. The "actively maintained fork" pitch applies specifically against the original cached_network_image, which this package is a drop-in replacement for.

Architecture

flowchart LR
    W[CachedNetworkImage widget] --> P[CachedNetworkImageProvider]
    P --> M[DefaultCacheManager]
    M --> H[("Hive CE<br/>metadata: URL, path,<br/>validTill, eTag")]
    M --> FS[("Native filesystem<br/>raw image bytes")]
    H -.cache hit.-> P
    FS -.cache hit.-> P

    subgraph Original[Original package, for comparison]
        direction LR
        W2[CachedNetworkImage] --> M2[CacheManager]
        M2 --> PC[Platform Channel]
        PC --> SQL[(SQLite via sqflite)]
    end
  • Old way: Dart → platform channel → native SQLite → disk. Slow, blocking.
  • New way: Dart → Hive CE (pure Dart, non-blocking) → disk. Instant.

That difference is what gets you zero-jank scrolling, even in image-dense lists.

🚀 Benchmarks

Measured cache metadata operations (check, write, delete) on an iPhone Simulator:

Operation Payload Original (sqflite) CE (hive_ce) Improvement
Read (Hit Check) 10 KB 16 ms 2 ms 8.00x faster
Write (New Image) 10 KB 116 ms 29 ms 4.00x faster
Delete (Cleanup) 10 KB 55 ms 19 ms 2.89x faster
Read (Large) 1 MB 8 ms 1 ms 8.00x faster

"Read" matters most for scroll performance, since every list item checks the cache before rendering.

Benchmark results on iPhone Simulator

Used by

Real apps shipping with cached_network_image_ce, found via a live GitHub code search for pubspec.yaml files that depend on it, sorted by stars:

Project Stars What it is
Kazumi stars Rule-based anime scraper and streaming app with danmaku and real-time super-resolution.
PiliPlus stars Third-party Bilibili client built with Flutter.
plezy stars Cross-platform Plex and Jellyfin client.
conduit stars Native iOS/Android client for Open WebUI, OpenAI-compatible APIs, Ollama, and OpenRouter.
haka_comic stars Third-party, ad-free client for the PicACG (Bika/Pica) comics platform.
MusicPod stars Music, radio, TV, and podcast player for Ubuntu and macOS.
Fluxer stars Official mobile client for Fluxer.
jd_mall_flutter stars Flutter clone of a major Chinese e-commerce marketplace app.
BoxBox stars Unofficial Formula 1 and Formula E companion app.

Shipping something with it? Open a PR and add yours, or check the full, current list yourself.

Features

  • Drop-in replacement — 99% API compatible with the original package.
  • hive_ce powered — instant, non-blocking cache lookups.
  • Real web support — persistent IndexedDB caching, not just browser HTTP cache.
  • HTTP & cache interceptors — inject auth headers, logging, or synthetic responses without forking anything.
  • Pluggable eviction — TTL (default) or LRU cleanup strategies.
  • Pre-caching API — CachedNetworkImage.preCache() downloads and caches images before they hit the screen, for instant navigation.
  • Graceful unsupported-format handling — SVG/AVIF/HEIC decode failures route to unsupportedImageBuilder instead of a bare exception.
  • Actively maintained — regular releases, community-driven roadmap.

Quick start

flutter pub add cached_network_image_ce
import 'package:cached_network_image_ce/cached_network_image.dart';

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

Full docs and advanced usage

The quick start above covers the basics. For interceptors, cleanup strategies, connection timeouts, custom cache and metadata directories, web render modes, and unsupported-format handling, see the full reference:

cached_network_image/README.md

FAQ

Q: Will I lose my users' existing cache if I migrate? A: Yes. Because we switched the storage engine from SQLite to Hive, the old cache files will be ignored. Users will re-download images once as they browse. This is a one-time migration cost for a permanent performance gain.

Q: My app crashes/pauses on errors? A: In Debug mode, Flutter may pause on exceptions even if they are caught. This is expected behavior for network errors (404s). In Release mode, these are handled silently by the errorWidget.

Q: Why is web caching slower, or why does it use Hive for image bytes? A: On Mobile & Desktop (IO), this package stores image bytes directly on the native file system and uses Hive only for metadata. Web lacks a native file system, so hive_ce stores both metadata and image bytes in IndexedDB there. Serializing large byte arrays in and out of IndexedDB carries overhead that doesn't exist on IO. Alternative: if persistent caching across sessions isn't critical for your web users, consider conditionally using Image.network on web, which relies on the browser's built-in caching.

Contributing

We welcome contributions! If you want to help maintain this package, check CONTRIBUTING.md.

License

MIT. See LICENSE for details.

카테고리

의존성

의존성 목록 11 개

소스 저장소

이 패키지를 사용하는 프로젝트

순위