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

flutter_easy_downloader_lib 是一个用于在 Flutter 应用中管理文件下载的插件。它提供了简单的 API 来下载文件、管理下载任务、监听下载进度等。以下是使用 flutter_easy_downloader_lib 的基本步骤：

1. 添加依赖

首先，在 pubspec.yaml 文件中添加 flutter_easy_downloader_lib 依赖：

dependencies:
  flutter:
    sdk: flutter
  flutter_easy_downloader_lib: ^版本号 # 请使用最新版本

然后运行 flutter pub get 来安装依赖。

2. 初始化插件

在应用的入口文件（通常是 main.dart）中初始化插件：

import 'package:flutter_easy_downloader_lib/flutter_easy_downloader_lib.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await FlutterEasyDownloaderLib.initialize();
  runApp(MyApp());
}

3. 下载文件

使用 FlutterEasyDownloaderLib 提供的 API 来下载文件。以下是一个简单的示例：

import 'package:flutter/material.dart';
import 'package:flutter_easy_downloader_lib/flutter_easy_downloader_lib.dart';

class DownloadPage extends StatefulWidget {
  [@override](/user/override)
  _DownloadPageState createState() => _DownloadPageState();
}

class _DownloadPageState extends State<DownloadPage> {
  String _downloadUrl = 'https://example.com/file.zip';
  String _savePath = '/storage/emulated/0/Download/file.zip';
  double _progress = 0.0;
  bool _isDownloading = false;

  Future<void> _startDownload() async {
    setState(() {
      _isDownloading = true;
    });

    await FlutterEasyDownloaderLib.download(
      url: _downloadUrl,
      savePath: _savePath,
      onProgress: (progress) {
        setState(() {
          _progress = progress;
        });
      },
      onComplete: () {
        setState(() {
          _isDownloading = false;
        });
        print('Download complete');
      },
      onError: (error) {
        setState(() {
          _isDownloading = false;
        });
        print('Download error: $error');
      },
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('File Download'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text('Progress: ${(_progress * 100).toStringAsFixed(2)}%'),
            SizedBox(height: 20),
            _isDownloading
                ? CircularProgressIndicator()
                : ElevatedButton(
                    onPressed: _startDownload,
                    child: Text('Download'),
                  ),
          ],
        ),
      ),
    );
  }
}

4. 管理下载任务

flutter_easy_downloader_lib 还提供了管理下载任务的功能，例如暂停、恢复、取消下载等。以下是一些常用的方法：

// 暂停下载
await FlutterEasyDownloaderLib.pauseDownload(downloadId);

// 恢复下载
await FlutterEasyDownloaderLib.resumeDownload(downloadId);

// 取消下载
await FlutterEasyDownloaderLib.cancelDownload(downloadId);

5. 监听下载状态

你可以通过 FlutterEasyDownloaderLib 提供的回调来监听下载状态，例如下载开始、暂停、完成、错误等。

6. 处理权限

在 Android 设备上，下载文件可能需要存储权限。你可以使用 permission_handler 插件来请求存储权限：

import 'package:permission_handler/permission_handler.dart';

Future<void> _requestPermission() async {
  var status = await Permission.storage.status;
  if (!status.isGranted) {
    await Permission.storage.request();
  }
}

7. 处理下载路径

确保指定的下载路径是可写的，并且路径中包含文件名。

8. 处理后台下载

如果你需要在后台下载文件，可以使用 workmanager 或 flutter_downloader 等插件来实现后台任务。

9. 处理下载完成后的操作

下载完成后，你可以通过 onComplete 回调来处理文件，例如打开文件、移动文件等。

10. 错误处理

在 onError 回调中处理下载过程中可能出现的错误，例如网络错误、文件系统错误等。

11. 示例代码

以下是一个完整的示例代码，展示了如何使用 flutter_easy_downloader_lib 下载文件并显示下载进度：

import 'package:flutter/material.dart';
import 'package:flutter_easy_downloader_lib/flutter_easy_downloader_lib.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await FlutterEasyDownloaderLib.initialize();
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Easy Downloader',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: DownloadPage(),
    );
  }
}

class DownloadPage extends StatefulWidget {
  [@override](/user/override)
  _DownloadPageState createState() => _DownloadPageState();
}

class _DownloadPageState extends State<DownloadPage> {
  String _downloadUrl = 'https://example.com/file.zip';
  String _savePath = '/storage/emulated/0/Download/file.zip';
  double _progress = 0.0;
  bool _isDownloading = false;

  Future<void> _startDownload() async {
    setState(() {
      _isDownloading = true;
    });

    await FlutterEasyDownloaderLib.download(
      url: _downloadUrl,
      savePath: _savePath,
      onProgress: (progress) {
        setState(() {
          _progress = progress;
        });
      },
      onComplete: () {
        setState(() {
          _isDownloading = false;
        });
        print('Download complete');
      },
      onError: (error) {
        setState(() {
          _isDownloading = false;
        });
        print('Download error: $error');
      },
    );
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('File Download'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            Text('Progress: ${(_progress * 100).toStringAsFixed(2)}%'),
            SizedBox(height: 20),
            _isDownloading
                ? CircularProgressIndicator()
                : ElevatedButton(
                    onPressed: _startDownload,
                    child: Text('Download'),
                  ),
          ],
        ),
      ),
    );
  }
}