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

downloadable 是一个用于 Flutter 的文件下载管理插件，它允许你在应用中下载文件并管理下载任务。以下是如何使用 downloadable 插件的基本步骤：

1. 添加依赖

首先，在你的 pubspec.yaml 文件中添加 downloadable 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  downloadable: ^0.0.1  # 请检查最新版本

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

2. 初始化插件

在你的 main.dart 文件中初始化 Downloadable 插件：

import 'package:downloadable/downloadable.dart';

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

3. 下载文件

你可以使用 Downloadable.download 方法来下载文件。以下是一个简单的例子：

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

class DownloadPage extends StatelessWidget {
  Future<void> downloadFile() async {
    String url = 'https://example.com/path/to/file.zip';
    String savePath = '/path/to/save/file.zip';

    try {
      await Downloadable.download(url, savePath);
      print('File downloaded successfully');
    } catch (e) {
      print('Failed to download file: $e');
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Download File'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: downloadFile,
          child: Text('Download File'),
        ),
      ),
    );
  }
}

4. 管理下载任务

downloadable 插件还提供了管理下载任务的功能。你可以获取下载任务的状态、暂停、恢复或取消下载。

获取下载状态

DownloadStatus status = await Downloadable.getStatus(url);
print('Download status: $status');

暂停下载

await Downloadable.pause(url);

恢复下载

await Downloadable.resume(url);

取消下载

await Downloadable.cancel(url);

5. 监听下载进度

你可以使用 Downloadable.onProgress 来监听下载进度：

Downloadable.onProgress.listen((DownloadProgress progress) {
  print('Downloaded: ${progress.downloaded}, Total: ${progress.total}');
});

6. 处理下载完成事件

你可以使用 Downloadable.onComplete 来处理下载完成事件：

Downloadable.onComplete.listen((DownloadComplete complete) {
  print('Download complete: ${complete.savePath}');
});

7. 错误处理

你可以使用 Downloadable.onError 来处理下载过程中发生的错误：

Downloadable.onError.listen((DownloadError error) {
  print('Download error: ${error.message}');
});

8. 清理下载缓存

你可以使用 Downloadable.clearCache 来清理下载缓存：

await Downloadable.clearCache();

9. 注意事项

• 确保你有正确的网络权限和存储权限。
• 如果你在 Android 上使用，请确保在 AndroidManifest.xml 文件中添加了必要的权限。

10. 完整示例

以下是一个完整的示例，展示了如何使用 downloadable 插件下载文件并管理下载任务：

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

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

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

class DownloadPage extends StatelessWidget {
  Future<void> downloadFile() async {
    String url = 'https://example.com/path/to/file.zip';
    String savePath = '/path/to/save/file.zip';

    try {
      await Downloadable.download(url, savePath);
      print('File downloaded successfully');
    } catch (e) {
      print('Failed to download file: $e');
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Download File'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: downloadFile,
          child: Text('Download File'),
        ),
      ),
    );
  }
}