Buscar pacotes, repositórios e categorias de apps

ducafecatGuia do ecossistema Flutter
Detalhes do pacotev4.0.6

cached_network_image

Biblioteca Flutter para carregar e armazenar em cache imagens de rede. Também pode ser usada com widgets de espaço reservado e de erro.

AndroidiOSWebmacOSWindowsLinux
pub.dev Documentação da API Código-fonte
Downloads em 30 dias
3,7 mi
Curtidas
7 mil
Pontos Pub
150

Instalar pacote

flutter pub add cached_network_image

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Um pacote Flutter para carregar e armazenar em cache imagens de rede de forma eficiente, com suporte a placeholders e widgets de erro. Reduz downloads redundantes armazenando imagens localmente, melhorando o desempenho do aplicativo e reduzindo o uso de largura de banda. Ideal para aplicativos que exibem muitas imagens de fontes remotas, como feeds de mídias sociais ou catálogos de produtos. A biblioteca lida com o carregamento assíncrono de imagens e fornece UI personalizável para estados de carregamento e falhas.

Casos de uso

  • Exibindo conteúdo de imagem dinâmico em aplicativos
  • Carregando imagens de servidores remotos de forma eficiente
  • Mostrando imagens de espaço reservado durante o carregamento
  • Tratar falhas no carregamento de imagens com elegância
  • Reduzindo o uso de dados por meio do armazenamento em cache local
  • Construindo interfaces de usuário com muitas imagens

Principais recursos

  • Cache automático de imagens
  • Widgets de espaço reservado e erro personalizáveis
  • Suporte para todas as principais plataformas
  • Gerenciamento eficiente de memória e disco
  • Carregamento assíncrono de imagem
  • Tamanho e duração de cache configuráveis

Indicado para

  • Aplicativos com busca frequente de imagens
  • Desenvolvedores priorizando desempenho e UX
  • Projetos que exigem acesso offline a imagens
  • Aplicações de mídia social e comércio eletrônico
  • Aplicativos direcionados para múltiplas plataformas

Considerações

  • Requer gerenciamento adequado de cache para evitar problemas de armazenamento
  • Pode precisar de ajustes para grandes conjuntos de imagens
  • O comportamento específico da plataforma pode variar ligeiramente
  • A configuração inicial exige compreensão das estratégias de cache
  • Não é ideal para coleções muito pequenas de imagens estáticas

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

Cached network image

pub package codecov Build Status

A flutter library to show images from the internet and keep them in the cache directory.

Sponsors


Try the Flutter Chat Tutorial 💬

How to use

The CachedNetworkImage can be used directly or through the ImageProvider. Both the CachedNetworkImage as CachedNetworkImageProvider have minimal support for web. It currently doesn't include caching.

With a placeholder:

CachedNetworkImage(
        imageUrl: "http://via.placeholder.com/350x150",
        placeholder: (context, url) => CircularProgressIndicator(),
        errorWidget: (context, url, error) => Icon(Icons.error),
     ),

Or with a progress indicator:

CachedNetworkImage(
       imageUrl: "http://via.placeholder.com/350x150",
       progressIndicatorBuilder: (context, url, downloadProgress) => 
               CircularProgressIndicator(value: downloadProgress.progress),
       errorWidget: (context, url, error) => Icon(Icons.error),
    ),

Image(image: CachedNetworkImageProvider(url))

When you want to have both the placeholder functionality and want to get the imageprovider to use in another widget you can provide an imageBuilder:

CachedNetworkImage(
  imageUrl: "http://via.placeholder.com/200x150",
  imageBuilder: (context, imageProvider) => Container(
    decoration: BoxDecoration(
      image: DecorationImage(
          image: imageProvider,
          fit: BoxFit.cover,
          colorFilter:
              ColorFilter.mode(Colors.red, BlendMode.colorBurn)),
    ),
  ),
  placeholder: (context, url) => CircularProgressIndicator(),
  errorWidget: (context, url, error) => Icon(Icons.error),
),

How it works

The cached network images stores and retrieves files using the flutter_cache_manager.

FAQ

My app crashes when the image loading failed. (I know, this is not really a question.)

Does it really crash though? The debugger might pause, as the Dart VM doesn't recognize it as a caught exception; the console might print errors; even your crash reporting tool might report it (I know, that really sucks). However, does it really crash? Probably everything is just running fine. If you really get an app crashes you are fine to report an issue, but do that with a small example so we can reproduce that crash.

See for example this or this answer on previous posted issues.

Categorias

Cache e Armazenamento TemporárioImagem

Dependências

Lista de dependências 5 itens

Repositório-fonte

Projetos que usam este pacote