Flutter文件下载管理插件easy_downloader的使用

简介

easy_downloader 是一个快速的下载管理器，允许在多个隔离环境中进行下载，文件被分割成多个片段并使用不同的连接下载每个片段。

特性

• ✅ 支持恢复、暂停、下载
• ✅ 支持队列下载
• ✅ 使用多个连接和进度条在多个隔离环境中下载
• ✅ 支持通知
• ✅ 支持下载后打开文件（仅限安卓和iOS）

入门指南

添加依赖

在 pubspec.yaml 文件中添加 easy_downloader 依赖：

dependencies:
  easy_downloader: ^0.0.16

激活 easy_downloader：

dart pub global activate easy_downloader

初始化插件

Flutter

添加 easy_downloader_flutter_lib 到 pubspec.yaml 中：

dependencies:
  easy_downloader_flutter_lib: ^0.0.1

初始化插件：

await EasyDownloader().initFlutter(
      allowNotification: true,
      //notification icon present in android/res/drawable
      defaultIconAndroid: 'download',
);

Dart

EasyDownloader().init();

创建新任务

var url = "https://github.com/linkkader/zanime/releases/download/39/zanime_39.apk";
var name = "test10MB$i";
var path = (await getApplicationDocumentsDirectory()).path;
var task = await downloader.download(
  url: url,
  autoStart: false,
  path: path,
  maxSplit: 1,
  fileName: "${name}easyDownloader",
);

task.addListener((task) {
  //监听所有任务更新
  setState(() {
    // 更新UI
  });
});

task.addSpeedListener((length) {
  //监听速度
  speedTask[task.downloadId] = length;
  setState(() {
    // 更新UI
  });
});

///显示通知（仅在安卓上测试）
task.showNotification();

完整示例代码

以下是一个完整的示例代码，展示如何使用 easy_downloader 进行文件下载：

import 'dart:io';
import 'package:easy_downloader/easy_downloader.dart';
import 'package:path_provider/path_provider.dart';

void main() async {
  var file = File("test.mp4");
  if (file.existsSync()) {
    file.deleteSync();
  }

  await Isar.initializeIsarCore(download: true);
  var isar = await Isar.open(EasyDownloader.schemas, directory: ".");
  var easyDownloader = await EasyDownloader().init(isar: isar);
  
  var dir = Directory("download");
  if (dir.existsSync()) {
    dir.deleteSync(recursive: true);
  }

  var downloadDir = await getApplicationDocumentsDirectory();
  var task = await easyDownloader.download(
    url: "https://www.learningcontainer.com/wp-content/uploads/2020/05/sample-mp4-file.mp4",
    maxSplit: 10,
    path: downloadDir.path,
  );

  task.addListener((task) {
    print(
        "status: ${task.status} ${task.totalDownloaded.toHumanReadableSize()} / ${task.totalLength.toHumanReadableSize()}");
  });

  task.start();
}

额外信息

• 仅在安卓、iOS 和 macOS 上测试。
• 如果您的文件较小，有时下载长度可能会超过总长度，这并不是问题。

许可证

Copyright (c) 2021 linkkader

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

这段Markdown文档详细介绍了如何使用 `easy_downloader` 插件进行文件下载，并提供了一个完整的示例代码来帮助开发者快速上手。