Um pacote Flutter para upload de arquivos em partes com resumo, rastreamento de progresso e gerenciamento de fila. Suporta pausa, retomada, cancelamento e armazenamento persistente para arquivos grandes.
Orientação gerada a partir de informações públicas. Apenas para referência.
Um pacote Flutter projetado para upload de arquivos grandes em partes, permitindo capacidade de retomada, acompanhamento em tempo real do progresso e gerenciamento eficiente da fila. Suporta operações de pausa, retomada e cancelamento, com armazenamento persistente para manter o estado do upload após reinícios do aplicativo. Ideal para transferências de arquivos grandes de forma confiável em múltiplas plataformas, incluindo Android, iOS, macOS, Windows e Linux.
Casos de uso
Carregar arquivos de vídeo grandes
Retomando uploads interrompidos
Gerenciando vários uploads de arquivos em uma fila
Gerenciando conexões de rede instáveis
Fluxos de trabalho de transferência de arquivos primeiro offline
Principais recursos
Suporte para upload de arquivos em partes
Retomar uploads interrompidos
Monitoramento em tempo real do progresso
Funcionalidade de pausa e retomada
Armazenamento persistente de estado de upload
Compatibilidade multiplataforma
Indicado para
Aplicativos que exigem grandes uploads de arquivos
aplicações intensivas em rede
Recursos de sincronização de dados com capacidade offline
Serviços de compartilhamento de arquivos ou backup
Aplicações com conectividade instável
Considerações
Requer manipulação cuidadosa das permissões de armazenamento
Pode consumir memória significativa para arquivos grandes
Necessita de tratamento adequado de erros para falhas de rede
Não ideal para transferência de arquivos pequenos
Depende da execução estável em segundo plano em algumas plataformas
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
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
}