Flutter如何实现background_download功能

在Flutter中如何实现后台下载功能？我尝试使用workmanager和flutter_downloader插件，但下载任务在应用进入后台或锁屏时经常被系统中断。需要实现以下功能：

  1. 支持大文件断点续传
  2. 应用退到后台仍能持续下载
  3. 能显示下载进度通知
  4. 支持Android和iOS双平台

请问有没有成熟的解决方案或最佳实践？特别关心如何解决iOS后台模式限制和Android省电策略对下载任务的影响。

2 回复

使用Flutter实现后台下载，可通过flutter_downloader或workmanager插件。配置后台任务权限，处理下载状态回调，确保应用在后台或关闭时仍能执行下载任务。

更多关于Flutter如何实现background_download功能的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


在Flutter中实现后台下载功能，可以通过以下步骤实现：

1. 使用flutter_downloader插件

这是最常用的后台下载解决方案：

dependencies:
  flutter_downloader: ^1.10.2
  permission_handler: ^10.2.0  # 用于权限处理

2. 配置原生平台

Android配置：

  • 在AndroidManifest.xml中添加权限：
<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
  • 在Application标签内注册下载服务：
<service android:name="vn.hunghd.flutterdownloader.DownloadService"/>

iOS配置：

  • 在Info.plist中添加：
<key>UIBackgroundModes</key>
<array>
  <string>fetch</string>
  <string>processing</string>
</array>

3. 核心代码实现

import 'package:flutter_downloader/flutter_downloader.dart';

class DownloadManager {
  static Future<void> initialize() async {
    await FlutterDownloader.initialize(debug: true);
  }

  static Future<String> startDownload(String url, String savedDir) async {
    final taskId = await FlutterDownloader.enqueue(
      url: url,
      savedDir: savedDir,
      showNotification: true,
      openFileFromNotification: true,
    );
    return taskId;
  }

  static void listenDownloadProgress() {
    FlutterDownloader.registerCallback(downloadCallback);
  }

  static void downloadCallback(String id, DownloadTaskStatus status, int progress) {
    // 处理下载进度和状态更新
    print('Task ($id) is in status ($status) and process ($progress)');
  }
}

4. 使用示例

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

// 开始下载
void startBackgroundDownload() async {
  final dir = await getExternalStorageDirectory();
  await DownloadManager.startDownload(
    'https://example.com/file.zip',
    dir.path,
  );
}

5. 注意事项

  • 需要处理存储权限（Android）
  • iOS需要配置后台模式
  • 下载大文件时注意设备存储空间
  • 考虑网络状态变化时的处理

这个方案可以实现在应用进入后台时继续下载，并在下载完成后通过通知提醒用户。

回到顶部