Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev4.1.0

download_assets

Recupere os recursos e adicione-os ao repositório do aplicativo para uso.

AndroidiOSmacOSWindowsLinux
Downloads em 30 dias
2,9 mil
Curtidas
71
Pontos Pub
160

Instalar pacote

flutter pub add download_assets

Visão geral do pacote

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

O pacote download_assets permite que aplicativos Flutter recuperem e armazenem ativos localmente no repositório do aplicativo, tornando-os disponíveis para uso offline. Ele suporta o download de arquivos a partir de URLs remotas e seu salvamento no sistema de arquivos do dispositivo, sendo especialmente útil para cache de recursos como imagens, documentos ou arquivos de configuração. O pacote funciona em múltiplas plataformas, incluindo Android, iOS, macOS, Windows e Linux, garantindo comportamento consistente. Simplifica a gestão de ativos ao lidar com downloads assíncronos e gerenciar caminhos de arquivos automaticamente.

Casos de uso

  • Acesso a conteúdo offline
  • Armazenar em cache recursos remotos
  • Pré-carregar ativos do aplicativo
  • Atualizações de conteúdo dinâmico
  • Mecanismos de fallback de recurso

Principais recursos

  • Suporte multiplataforma
  • Downloads assíncronos
  • Armazenamento de arquivos locais
  • Gerenciamento automático de caminhos
  • Suporte para vários tipos de arquivos

Indicado para

  • Aplicativos que precisam de funcionalidade offline
  • Aplicativos com conteúdo intenso
  • Aplicativos com entrega dinâmica de recursos
  • Desenvolvedores gerenciando ativos remotos
  • Projetos que exigem dados em cache

Considerações

  • Requer permissão de internet no mobile
  • Gerenciamento de espaço em disco necessário
  • Conflitos de nome de arquivo possíveis
  • Sem lógica de retry embutida
  • Limpeza manual de arquivos baixados

README original

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

style: lint

Download_assets

About

The download_assets package is a powerful library that facilitates the process of downloading assets into the application. With this library, you can easily download files, images, videos, and other resources in your app, providing a smooth and efficient user experience.

Features

init

Init method for setting up the assetsDir, which is required to be called during app initialization.

await downloadAssetsController.init();
startDownload

Starts the asset download process.

  • assetsUrls: A list of [AssetUrl] objects representing each file to be downloaded.
  • uncompressDelegates: A list of custom decompression delegates for different types of files, such as ZIP, RAR, etc (optional).
  • onStartUnzipping: Called right before the start of the uncompressing process (optional).
  • onProgress: Called after each iteration returning the current progress (optional). The double parameter ranges from 0 to 1, where 1 indicates the completion of the download process.
  • onDone: Called when all files have been downloaded and uncompressed (optional).
  • onCancel: Cancels the ongoing download (optional).
  • requestQueryParams: Query params to be used in the request (optional).
  • requestExtraHeaders: Extra headers to be added in the request (optional).
  • checkSize: Specifies if the size of the file should be checked first before starting download (optional).
await downloadAssetsController.startDownload(
    onCancel: () {
        //TODO: implement cancel here
    },
    assetsUrls: [
      AssetUrl(url: 'https://github.com/edjostenes/download_assets/raw/main/download/image_1.png'),
      AssetUrl(url: 'https://github.com/edjostenes/download_assets/raw/main/download/assets.zip'),
      AssetUrl(url: 'https://github.com/edjostenes/download_assets/raw/main/download/image_2.png'),
      AssetUrl(url: 'https://github.com/edjostenes/download_assets/raw/main/download/image_3.png'),
    ],
    onProgress: (progressValue) {
        //TODO: Implement progress here
    },
    onDone: () {
      //TODO: Implement progress here
    }
);
AssetUrl

You can now specify the file name and extension with the AssetUrl class in case you don't have control over the URL format.

class AssetUrl {
  final String url;
  final String? fileName;

  const AssetUrl({
    required this.url,
    this.fileName,
  });
}
clearAssets

Removes all downloaded assets from local storage.

await downloadAssetsController.clearAssets();
getAssetFromWeb
await downloadAssetsController.getAssetFromWeb('<file_name>.<file_extension>');

Note: This method is only available on web version

assetsDir

Path to the files.

File('${downloadAssetsController.assetsDir}/<file_name>.<file_extension>');
assetsDirAlreadyExists

Returns true if the assetsDir path exists.

return await downloadAssetsController.assetsDirAlreadyExists();
assetsFileExists

Returns true if the file exists.

return await downloadAssetsController.assetsFileExists(<file_name>);

Uncompress delegate

Uncompress delegates are responsible for implementing the logic to uncompress different types of files, such as ZIP, RAR, etc. By providing a list of delegates, it becomes possible to support multiple file formats during the download.

To implement your own uncompression delegate, you should implement the interface below.

/// Abstract class representing a delegate for asset decompression.
abstract class UncompressDelegate {
  const UncompressDelegate();

  /// Gets the file extension associated with the delegate.
  String get extension;

  /// uncompress the asset located at [compressedFilePath] to the specified [assetsDir].
  /// [compressedFilePath] -> The path to the compressed asset file.
  /// [assetsDir] -> The directory where the uncompressed asset should be stored.
  Future uncompress(String compressedFilePath, String assetsDir);
}

Note: This kind of delegate is essential for enabling the download process to handle various file formats by implementing the necessary decompression logic. This flexibility allows users to download and work with a wide range of compressed file types effortlessly. UnzipDelegate() is already included, which handles the decompression of ZIP files.

Example

You can find an example here: https://github.com/edjostenes/download_assets/tree/master/example

Contributing

Contributions are welcome! If you encounter any issues or have suggestions for improvement, please create an issue on the GitHub repository.

Categorias

Dependências

Lista de dependências 6 itens

Repositório-fonte

Projetos que usam este pacote

Ainda não há dados.