Skip to content
pubscout

flutter_downloader

1.12.1, released 3 months ago by fluttercommunity.dev

Plugin to create and manage background download tasks on Android and iOS.

$ flutter pub add flutter_downloader
Source repository

What it does

It schedules downloads using WorkManager on Android and NSURLSessionDownloadTask on iOS, supports concurrent tasks, notifications, and optional HTTP configuration. Files are saved to external storage on Android and the Documents directory on iOS.

AI-written summary of version 1.12.1, based on the package's README and metadata. Report an inaccuracy

Use it when

  • You need reliable background downloads on mobile devices
  • You want to limit concurrent downloads and get system notifications

Skip it when

  • You require cross‑platform download support for web or desktop
  • You need fine‑grained download control beyond what WorkManager provides

Strengths

  • Runs downloads in background even when app is closed
  • Handles iOS and Android native download APIs
  • Configurable concurrent task limit

Weaknesses

  • Requires native setup on both platforms
  • Limited to Android and iOS only
  • Past versions had SQL injection vulnerabilities

Setup

Kind
Plugin (native code)
Effort
Medium
Code generation
No
Direct dependencies
0

iOS: enable background mode, add sqlite library, configure AppDelegate. Android: add provider entry in AndroidManifest, ensure external storage permission. May need to adjust Info.plist for ATS or concurrent task limits.

import 'package:flutter_downloader/flutter_downloader.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();
  await FlutterDownloader.initialize(debug: true);
  final taskId = await FlutterDownloader.enqueue(
    url: 'https://example.com/file.pdf',
    savedDir: '/sdcard/Download',
    showNotification: true,
    openFileFromNotification: true,
  );
}

Alternatives

Packages that do the same job and could replace flutter_downloader.

Works with

Packages commonly used together with flutter_downloader: ones it builds on, ones built on it, and its own family.