Ein Flutter-Paket für das hochladen von Dateien in Teilen mit Wiederaufnahme, Fortschrittsverfolgung und Warteschlangenmanagement. Unterstützt Pause, Fortsetzung, Abbruch und dauerhafte Speicherung großer Dateien.
Aus öffentlichen Paketdaten erstellte Orientierung.
Ein Flutter-Paket zur Aufteilung großer Dateien zum Hochladen in Teilen mit Wiederaufnahme-Funktion, Echtzeit-Progress-Tracking und effizienter Warteschlangenverwaltung. Unterstützt Pausieren, Fortsetzen und Abbrechen von Uploads mit dauerhaftem Speicher, um den Upload-Zustand nach Neustarts der App beizubehalten. Ideal für zuverlässige Übertragung großer Dateien auf mehreren Plattformen wie Android, iOS, macOS, Windows und Linux.
Anwendungsfälle
Große Videodateien hochladen
Unterbrochene Uploads fortsetzen
Verwaltung mehrerer Dateiuploads in einer Warteschlange
Ungestabilisierte Netzwerkverbindungen behandeln
Offline-first-Dateiübertragungsworkflows
Hauptmerkmale
Unterstützung für chunked Datei-Uploads
Unterbrochene Hochläufe fortsetzen
Echtzeit-Verfolgung des Fortschritts
Pause- und Fortsetzfunktion
Persistente Speicherung des Upload-Zustands
Plattformübergreifende Kompatibilität
Geeignet für
Apps, die große Dateiuploads erfordern
netzwerkintensive Anwendungen
Offline-fähige Daten-Synchronisierungsfunktionen
Dateifreigabe- oder Sicherungsdienste
Anwendungen mit unzuverlässiger Verbindung
Hinweise
Erfordert sorgfältige Behandlung von Speicherberechtigungen
Kann bei großen Dateien erheblichen Speicher verbrauchen
Erforderliche ordnungsgemäße Fehlerbehandlung bei Netzwerkfehlern
Nicht ideal für den Transfer kleiner Dateien
Hängt von stabiler Hintergrundausführung auf einigen Plattformen ab
Original-README
Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.
flutter_chunked_upload
A Flutter package for handling chunked file uploads with resume capability, progress tracking, and queue management.
🚀 Demo
Android Demo
iOS Demo
🌟 Features
Chunked File Uploads: Split large files into manageable chunks for reliable uploads
Resume Capability: Automatically resume uploads from where they left off
Queue Management: Manage multiple uploads with priority support
Progress Tracking: Real-time progress updates with callbacks
Pause/Resume/Cancel: Full control over upload operations
Automatic Connectivity Handling: Pause uploads when internet is lost, resume when restored
Persistent Storage: Upload progress saved using Hive for app restarts
Cross-Platform: Works on iOS, Android, Web, and Desktop
Backend Agnostic: Works with any server that supports chunked uploads
Notifications: Built-in success, retry, and failure notifications
Error Handling: Comprehensive error handling with automatic retries
The package automatically handles internet connectivity changes:
Internet Lost: All active uploads are automatically paused
Internet Restored: All paused uploads are automatically resumed
No Manual Intervention: Works seamlessly in the background
Progress Preserved: No data loss during connectivity changes
// The connectivity handling is automatic - no additional code needed!// Uploads will pause when internet is lost and resume when restored
Managing Uploads
// Pause an upload
queueManager.pauseJob('job_id');
// Resume an upload
queueManager.resumeJob('job_id');
// Cancel an upload
queueManager.cancelJob('job_id');
// Get all pending jobsfinal pendingJobs = await queueManager.getPendingJobs();
// Get paused jobsfinal pausedJobs = await queueManager.getPausedJobs();
// Clear all jobs
queueManager.clearAllJobs();
Using the Debug Panel
import'package:flutter/material.dart';
import'package:flutter_chunked_upload/flutter_chunked_upload.dart';
classMyAppextendsStatelessWidget{
@overrideWidgetbuild(BuildContext context) {
returnMaterialApp(
home: Scaffold(
appBar: AppBar(title: Text('Upload Manager')),
body: UploadJobsDebugPanel(), // Shows all upload jobs with controls
),
);
}
}
Custom Storage Adapters
You can implement custom storage adapters for different persistence needs:
classCustomJobStorageAdapterimplementsUploadJobStorageAdapter{
// Implement the required methods@overrideFuture<void> saveJob(UploadJob job) async {
// Your custom implementation
}
// ... implement other methods
}
// Use custom adaptersawait queueManager.initAsync(
jobStorage: CustomJobStorageAdapter(),
chunkStorage: CustomChunkStorageAdapter(),
);
API Reference
UploadJob
The main class representing an upload job.
classUploadJob{
String id; // Unique identifierString filePath; // Path to fileString url; // Upload endpointint chunkSize; // Size of each chunkUploadJobStatus status; // Current statusint retryCount; // Number of retriesint maxRetries; // Maximum retriesbool isPaused; // Pause stateint priority; // Queue prioritydouble progress; // Upload progress (0.0-1.0)// CallbacksProgressCallback? onProgress;
UploadCompleteCallback? onComplete;
UploadFailedCallback? onFailed;
HeaderBuilder? headerBuilder;
}
UploadJobStatus
enumUploadJobStatus {
pending, // Waiting in queue
uploading, // Currently uploading
success, // Upload completed
failed, // Upload failed
}