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

isolated_download_manager_flutter 是一个用于在Flutter中异步下载文件的插件。它通过隔离（isolate）来处理下载任务，以避免阻塞主线程，从而提高应用的性能和响应速度。

预览

开始使用

首先，在 pubspec.yaml 文件中添加 isolated_download_manager_flutter 插件：

dependencies:
  flutter:
    sdk: flutter
  isolated_download_manager_flutter: ^latest_version

请确保将 ^latest_version 替换为最新的版本号，可以从 pub.dev 获取。

使用方法

该插件提供了两个主要的小部件：DownloadWidget 和 DownloadUrlWidget。

DownloadWidget

用于表示 DownloadRequest 对象的状态。

DownloadWidget(
  request: request, 
  builder: (context, state, progress, error) {
    // UI goes here 
  }
)

完整示例代码可以参考 GitHub 示例。

DownloadUrlWidget

简化版，其中 DownloadRequest 内部存储（通过构建器访问）。

DownloadUrlWidget(
  url: url, 
  path: path, 
  controller: controller, // optional
  builder: (context, controller, state, progress, error, request) {
    // UI goes here 
  }
);

控制器允许在小部件构建器体外访问任务。 完整示例代码可以参考 GitHub 示例。

功能丰富的示例可以在 复杂示例目录 中找到。

完整示例Demo

以下是一个完整的示例应用程序，演示如何使用 DownloadWidget 来下载文件并显示进度。

import 'package:flutter/material.dart';
import 'package:isolated_download_manager_flutter/isolated_download_manager_flutter.dart';
import 'package:isolated_download_manager/isolated_download_manager.dart';
import 'dart:io' show File;

void main() {
  runApp(const ExampleApp());
}

class ExampleApp extends StatefulWidget {
  const ExampleApp({Key? key}) : super(key: key);

  @override
  State<ExampleApp> createState() => _ExampleAppState();
}

class _ExampleAppState extends State<ExampleApp> {
  static const String url =
      "http://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4";
  static const String path = "./BigBuckBunny.mp4";

  DownloadRequest? _request;

  @override
  void initState() {
    super.initState();
    DownloadManager.instance.init(isolates: 2);
  }

  @override
  void dispose() {
    DownloadManager.instance.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
        home: Scaffold(
            appBar: AppBar(
              title: const Text("DownloadWidget"),
              actions: [
                IconButton(
                    onPressed: _reset,
                    icon: const Icon(Icons.replay_rounded))
              ],
            ),
            body: Center(
                child: DownloadWidget(
                    request: _request,
                    builder: (context, state, progress, error) {
                      switch (state) {
                        case DownloadWidgetState.initial:
                          return IconButton(
                              onPressed: _download,
                              icon: const Icon(Icons.download_rounded));
                        case DownloadWidgetState.queued:
                        case DownloadWidgetState.downloading:
                          return Stack(alignment: Alignment.center, children: [
                            CircularProgressIndicator(
                                value: 1.0,
                                color: Colors.grey.withOpacity(0.2)),
                            CircularProgressIndicator(value: progress),
                            IconButton(
                                onPressed: _cancel,
                                icon: const Icon(Icons.close_rounded)),
                          ]);
                        case DownloadWidgetState.failed:
                          return IconButton(
                              onPressed: _download,
                              icon: const Icon(Icons.restart_alt_rounded));
                        case DownloadWidgetState.downloaded:
                          return const Icon(Icons.done_rounded);
                        default:
                          return const SizedBox();
                      }
                    }))));
  }

  void _download() {
    setState(() =>
        _request = DownloadManager.instance.download(url, path: path));
  }

  void _cancel() {
    _request?.cancel();
  }

  void _reset() async {
    _cancel();
    setState(() => _request = null);
    final file = File(path);
    if (await file.exists()) await file.delete();
  }
}

此示例展示了如何初始化下载管理器、下载文件、取消下载以及重置下载状态。希望这个示例能帮助你理解如何在你的Flutter应用中使用 isolated_download_manager_flutter 插件。