Flutter 使用 Dio 实现文件下载并监听进度

2024-01-12 14:48:51

引言

Flutter 是一个用于创建跨平台移动应用程序的出色框架。它的强大功能和用户友好性使其在开发人员中深受喜爱。Dio 是一个用于向服务器发送 HTTP 请求的流行 Flutter 包。它提供了丰富的功能，包括文件下载和进度监听。

Dio 文件下载

使用 Dio 下载文件非常简单。只需执行以下步骤：

导入 Dio 包：

import 'package:dio/dio.dart';

创建一个 Dio 对象：

Dio dio = Dio();

使用 download() 方法下载文件：

await dio.download(url, savePath);

其中：

url 是要下载的文件的 URL。
savePath 是下载文件的保存路径。

进度监听

下载过程中，可以使用 onReceiveProgress 回调函数监听进度。此函数接受两个参数：

received：已下载的字节数。
total：总字节数。

要使用进度监听，请将 onReceiveProgress 回调函数传递给 download() 方法：

await dio.download(url, savePath, onReceiveProgress: (received, total) {
  // 在此处理进度更新
});

使用示例

以下是一个使用 Dio 下载文件并监听进度的示例：

import 'package:dio/dio.dart';
import 'package:flutter/foundation.dart';

void main() async {
  // 创建一个 Dio 对象
  Dio dio = Dio();

  // 下载文件
  await dio.download(
    'https://example.com/file.zip',
    '/path/to/file.zip',
    onReceiveProgress: (received, total) {
      if (kDebugMode) {
        print('已下载 ${((received / total) * 100).toStringAsFixed(0)}%');
      }
    },
  );

  // 下载完成后，处理文件
  print('文件下载完成！');
}