Flutter框架跨平台鸿蒙开发——文件下载器综合应用

一、功能概述

文件下载器综合展示了Future、Stream、async/await的协同使用。
否
是
是
否
开始下载
创建下载任务
Stream通知进度
更新UI显示
下载完成?
标记完成
还有文件?
全部完成

二、下载管理

dart 复制代码

Future<void> _downloadAll() async {
  if (_isDownloading) return;

  setState(() {
    _isDownloading = true;
    _downloads.clear();
  });

  final files = [
    '文件1.pdf',
    '文件2.docx',
    '文件3.jpg',
    '文件4.mp4',
    '文件5.zip',
  ];

  for (int i = 0; i < files.length; i++) {
    final item = DownloadItem(
      name: files[i],
      progress: 0,
      status: DownloadStatus.downloading,
    );
    _downloads.add(item);
    _controller.add(item);

    if (mounted) setState(() {});

    // 模拟下载进度
    for (int progress = 0; progress <= 100; progress += 10) {
      await Future.delayed(const Duration(milliseconds: 100));
      item.progress = progress;
      _controller.add(item);
      if (mounted) setState(() {});
    }

    item.status = DownloadStatus.completed;
    _controller.add(item);
    if (mounted) setState(() {});
  }

  setState(() {
    _isDownloading = false;
  });
}

三、进度显示

下载进度时间线（单文件） 0% 10% 20% 30% 40% 50% 60% 70% 80% 90% 100% 100 90 80 70 60 50 40 30 20 10 0 进度(%)

四、下载状态

状态	图标	颜色	说明
下载中	downloading	蓝色	正在下载
已完成	check_circle	绿色	下载成功
失败	error	红色	下载失败

五、工作流程

下载项 StreamController 界面用户下载项 StreamController 界面用户 loop [每100ms] loop [每个文件] 点击开始下载创建任务列表创建下载项显示下载中进度+10% add事件更新进度重绘列表状态改为完成 add事件全部完成

六、综合特性

30% 25% 25% 20% 使用的技术栈 Stream async/await Future StreamController

技术	应用场景	作用
Stream	实时更新进度	持续通知UI
async/await	顺序下载	控制执行顺序
Future	延迟模拟	模拟网络请求
StreamController	事件管理	控制数据流

七、最佳实践

否
是
是
否
开始下载
检查下载状态
创建下载项
通知UI
循环更新进度
完成?
标记完成
还有文件?
结束下载

要点：

使用Stream通知实时进度
及时更新UI状态
检查mounted避免内存泄漏
支持取消操作
提供清晰的状态反馈

欢迎加入开源鸿蒙跨平台社区：https://openharmonycrossplatform.csdn.net