universal_downloader 1.0.5

A Flutter package for downloading files on all platforms (Android, iOS, Web, Windows, macOS, Linux) with progress tracking and comprehensive error handling.

Universal Downloader

A Flutter package for downloading files on all platforms: Android, iOS, Web, Windows, macOS, and Linux.

Supports ALL file types - PDFs, music, videos, documents, archives, images, and any other format without restrictions.

Features

✅ Universal Compatibility: Works on all Flutter platforms
✅ All File Types Supported: PDFs, music, videos, documents, archives, images, and any format
✅ Progress Tracking: Real-time download progress callbacks
✅ Platform-Optimized Storage: Uses appropriate directories for each platform
✅ Automatic Permissions: Handles storage permissions for mobile platforms
✅ Error Handling: Comprehensive error reporting and recovery
✅ Simple API: Easy-to-use interface with intuitive callbacks

Installation

Add this to your package's pubspec.yaml file:

dependencies:
  universal_downloader: ^1.0.5

Then run:

flutter pub get

Usage

🚀 RECOMMENDED: downloadFromUrlStream() (Best for all use cases)

Use downloadFromUrlStream() for all downloads - it's memory efficient, reliable, and works perfectly across all platforms:

import 'package:universal_downloader/universal_downloader.dart';

// RECOMMENDED: Use this for all downloads
final result = await UniversalDownloader.downloadFromUrlStream(
  url: "https://example.com/file.zip",
  filename: "file.zip",
  onProgress: (progress) {
    print("Progress: ${progress.percentage.toStringAsFixed(1)}%");
    print("Downloaded: ${progress.downloadedBytes}/${progress.totalBytes} bytes");
  },
  onComplete: (filePath) {
    print("✅ Download completed: $filePath");
  },
  onError: (error) {
    print("❌ Download failed: $error");
  },
);

if (result.isSuccess) {
  print("File saved at: ${result.filePath}");
} else {
  print("Error: ${result.errorMessage}");
}

Simple Download (Basic)

import 'package:universal_downloader/universal_downloader.dart';

// Basic download without progress tracking
await UniversalDownloader.downloadFile(
  url: "https://example.com/file.pdf",
  fileName: "document.pdf",
);

Web Download (Enhanced for PDFs/Music)

import 'package:universal_downloader/universal_downloader.dart';

// Better for PDFs, music files, and media content
final result = await UniversalDownloader.downloadWebFile(
  url: "https://example.com/song.mp3",
  fileName: "song.mp3",
  onComplete: (filePath) {
    print("File downloaded: $filePath");
  },
  onError: (error) {
    print("Download failed: $error");
  },
);

Platform Support

Platform	Storage Location	Progress Tracking
Android	Downloads/Documents directory	✅
iOS	Documents directory	✅
Web	Browser downloads	✅
Windows	Downloads folder	✅
macOS	Downloads folder	✅
Linux	Downloads folder	✅

Mobile Permissions

The package automatically handles storage permissions for mobile platforms. Add these permissions to your android/app/src/main/AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
<uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
<uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
<uses-permission android:name="android.permission.READ_MEDIA_AUDIO" />

API Reference

Core Methods

downloadFromUrlStream() - Recommended

Downloads files with streaming for better memory efficiency.

downloadFile()

Simple file download with optional progress tracking.

downloadWebFile()

Enhanced web download for PDFs, music, and media files.

Models

DownloadProgress

class DownloadProgress {
  final int totalBytes;
  final int downloadedBytes;
  final double percentage;
  final double? speed;
}

DownloadResult

class DownloadResult {
  final String filePath;
  final String url;
  final String fileName;
  final int totalBytes;
  final bool isSuccess;
  final String? errorMessage;
}

Error Handling

try {
  await UniversalDownloader.downloadFromUrlStream(
    url: "https://example.com/file.zip",
    filename: "file.zip",
  );
} on NetworkDownloadException catch (e) {
  print("Network error: $e");
} on PermissionDownloadException catch (e) {
  print("Permission error: $e");
} on DownloadException catch (e) {
  print("Download error: $e");
}

Example

Check out the example directory for a complete Flutter app:

cd example
flutter pub get
flutter run

Changelog

1.0.5

• Release: Documentation update with enhanced README
• Updated: README.md with clearer method recommendations
• Improved: downloadFromUrlStream() prominently featured as recommended method
• Enhanced: Usage examples and platform support documentation

1.0.4

• Release: Enhanced documentation with clear recommendations
• Updated: downloadFromUrlStream() prominently featured as recommended method
• Improved: README structure and examples for better user experience
• Fixed: Version consistency across all documentation

1.0.3

• Release: Proper 1.0.3 release with complete platform support
• Fixed: All platform support issues resolved for pub.dev scoring
• Updated: Documentation and changelog for proper release
• Verified: All 6 platforms (Android, iOS, Web, Windows, macOS, Linux) fully supported

1.0.2

• Release: Platform support fixes and documentation updates
• Fixed: Added explicit platform declarations for better pub.dev detection
• Updated: CHANGELOG.md and README.md with platform support details
• Improved: Package metadata and documentation

1.0.1

• Fixed: Web downloader supports all file types without restrictions
• Fixed: Resolved CORS detection issues in web downloads
• Fixed: Corrected filename corruption in web downloads
• Improved: Enhanced error handling for web download failures
• Improved: Simplified download logic for better reliability

1.0.0

• Initial Release with full platform support
• Support for all Flutter platforms (Android, iOS, Web, Windows, macOS, Linux)
• Real-time download progress tracking
• Platform-optimized storage locations
• Comprehensive error handling
• Web support with enhanced CORS handling
• Easy-to-use API with callback support

License

This project is licensed under the MIT License - see the LICENSE file for details.