套件詳情v1.8.4

al_downloader

一個基於URL的Flutter下載器，支援下載任何類型的檔案，並自動管理許多事項。

AndroidiOS

pub.dev API 文件原始碼

近 30 天下載: 333
喜歡數: 104
Pub 分數: 120

安裝套件

flutter pub add al_downloader

套件介紹

根據套件公開資料產生的選型評估，僅供參考。

al_downloader 是一個 Flutter 套件，可在 Android 與 iOS 平台上實現基於 URL 的檔案下載。它支援下載任何類型的檔案，並自動處理常見任務，例如管理下載佇列、追蹤進度以及管理儲存權限。此套件簡化了在 Flutter 應用中實作強大下載功能的過程，非常適合需要可靠背景下載功能的應用程式。透過 pub add 進行最少設定，開發者即可輕鬆整合強大的下載功能。

適用情境

從URL下載檔案
背景檔案下載
處理大檔案傳輸
管理下載進度
自動下載佇列管理

主要特色

支援所有檔案類型
自動下載管理
跨平台（Android 與 iOS）
進度追蹤
後台下載支援

適合對象

需要檔案下載的應用
媒體內容分發
離線資料快取
教育或生產力應用
具有大型資產庫的應用程式

使用建議

Android 需要互聯網權限
可能需要在 iOS 上啟用背景執行權限
大檔案需要仔細的記憶體管理
檔案路徑處理可能因平台而異
未提及內建的恢復功能

原始 README

以下為關聯原始碼儲存庫的 README 原文快照，最新內容請造訪原始碼儲存庫。

al_downloader

A URL-based flutter downloader that supports to download any type of file and automatically manages a lot of things.

If you need Chinese Document, click here.

Features

manage download tasks by url
simple download status
I/O infrequently
provide convenient download handle
support batch download
manage automatically files without requiring to be specified a download path
based on flutter_downloader

Integration

Native Config: same as flutter_downloader native config

add the following line to your pubspec.yaml

dependencies:
  al_downloader: ^1.8.4

run the following line with your command line

flutter packages get

import the following line, then you can use al_downloader

import 'package:al_downloader/al_downloader.dart';

Usage

ALDownloader

Initialize

ALDownloader.initialize();

Configure print

ALDownloader.configurePrint(true, frequentEnabled: false);

Download

ALDownloader.download(url,
    directoryPath: directoryPath,
    fileName: fileName,
    handlerInterface:
        ALDownloaderHandlerInterface(progressHandler: (progress) {
      debugPrint(
          'ALDownloader | download progress = $progress, url = $url\n');
    }, succeededHandler: () {
      debugPrint('ALDownloader | download succeeded, url = $url\n');
    }, failedHandler: () {
      debugPrint('ALDownloader | download failed, url = $url\n');
    }, pausedHandler: () {
      debugPrint('ALDownloader | download paused, url = $url\n');
    }));

Add a handler interface

ALDownloader.addHandlerInterface(
    ALDownloaderHandlerInterface(progressHandler: (progress) {
      debugPrint(
          'ALDownloader | download progress = $progress, url = $url\n');
    }, succeededHandler: () {
      debugPrint('ALDownloader | download succeeded, url = $url\n');
    }, failedHandler: () {
      debugPrint('ALDownloader | download failed, url = $url\n');
    }, pausedHandler: () {
      debugPrint('ALDownloader | download paused, url = $url\n');
    }),
    url);

Add a forever handler interface

ALDownloader.addForeverHandlerInterface(
    ALDownloaderHandlerInterface(progressHandler: (progress) {
      debugPrint(
          'ALDownloader | download progress = $progress, url = $url\n');
    }, succeededHandler: () {
      debugPrint('ALDownloader | download succeeded, url = $url\n');
    }, failedHandler: () {
      debugPrint('ALDownloader | download failed, url = $url\n');
    }, pausedHandler: () {
      debugPrint('ALDownloader | download paused, url = $url\n');
    }),
    url);

Remove handler interface

ALDownloader.removeHandlerInterfaceForUrl(url);

Pause download

/// Stop download, but the incomplete data will not be deleted.
ALDownloader.pause(url);

Cancel download

/// Stop download, and the incomplete data will be deleted.
ALDownloader.cancel(url);

Remove download

/// Remove download, and all the data will be deleted.
ALDownloader.remove(url);

Get download status

final status = await ALDownloader.getStatusForUrl(url);

Get download progress

final progress = await ALDownloader.getProgressForUrl(url);

Get task

final task = await ALDownloader.getTaskForUrl(url);

Get all tasks

final tasks = await ALDownloader.tasks;

ALDownloaderBatcher

Batch download

ALDownloaderBatcher.download(urls,
    handlerInterface:
        ALDownloaderHandlerInterface(progressHandler: (progress) {
      debugPrint('ALDownloader | batch | download progress = $progress\n');
    }, succeededHandler: () {
      debugPrint('ALDownloader | batch | download succeeded\n');
    }, failedHandler: () {
      debugPrint('ALDownloader | batch | download failed\n');
    }, pausedHandler: () {
      debugPrint('ALDownloader | batch | download paused\n');
    }));

Add a handler interface for batch

ALDownloaderBatcher.addHandlerInterface(
    ALDownloaderHandlerInterface(progressHandler: (progress) {
      debugPrint('ALDownloader | batch | download progress = $progress\n');
    }, succeededHandler: () {
      debugPrint('ALDownloader | batch | download succeeded\n');
    }, failedHandler: () {
      debugPrint('ALDownloader | batch | download failed\n');
    }, pausedHandler: () {
      debugPrint('ALDownloader | batch | download paused\n');
    }),
    urls);

Get download status for a set of urls

final status = await ALDownloaderBatcher.getStatusForUrls(urls);

Get tasks

final tasks = await ALDownloaderBatcher.getTasksForUrls(urls);

ALDownloaderFileManager - A manager that manages file by url

final physicalFilePath =
    await ALDownloaderFileManager.getPhysicalFilePathForUrl(url);
debugPrint(
    'ALDownloader | get physical file path for [url], url = $url, path = $physicalFilePath\n');

Note:

1. If the persistent file was removed by exceptional means, such as the cache folder being deleted by some business code, call [remove] and then call [download] to re-download for fixing the problem.