Реализация скачивания файлов (Download) в мобильном приложении
Скачивание файлов разделяется на два принципиально разных сценария: быстрое скачивание небольших ресурсов (изображения, документы до 10 МБ) прямо в памяти, и загрузка крупных файлов (видео, архивы) с отображением прогресса и возможностью возобновить. Смешивать подходы — частая ошибка, которая выражается в OOM-крашах или висящем индикаторе без обратной связи.
Реализация по платформам
Android. Для загрузки в память — OkHttp или Retrofit с ResponseBody.byteStream(), данные пишем в файл в IO-корутине. Для крупных файлов системный DownloadManager с уведомлением в статусбаре — пользователь видит прогресс даже после выхода из приложения. Альтернатива — WorkManager + кастомный Worker, если нужно больше контроля над логикой.
Сохранение в папку Downloads на Android 10+: используем MediaStore API для общедоступных файлов, getExternalFilesDir() — для приватных. Попытка писать напрямую в /sdcard/Download/ без MediaStore на Android 11 даст SecurityException.
val request = DownloadManager.Request(Uri.parse(url))
.setTitle(fileName)
.setDestinationInExternalPublicDir(Environment.DIRECTORY_DOWNLOADS, fileName)
.setNotificationVisibility(DownloadManager.Request.VISIBILITY_VISIBLE_NOTIFY_COMPLETED)
val downloadId = downloadManager.enqueue(request)
iOS. URLSession.downloadTask сохраняет временный файл, после чего нужно переместить его в FileManager.default.urls(for: .documentDirectory). Для фоновых загрузок — URLSessionConfiguration.background(withIdentifier:) с делегатом URLSessionDownloadDelegate. Без фоновой сессии загрузка прерывается при уходе приложения в background.
let config = URLSessionConfiguration.background(withIdentifier: "com.app.download")
let session = URLSession(configuration: config, delegate: self, delegateQueue: nil)
let task = session.downloadTask(with: URL(string: url)!)
task.resume()
Реализация urlSession(_:downloadTask:didFinishDownloadingTo:) для перемещения файла и urlSession(_:downloadTask:didWriteData:totalBytesWritten:totalBytesExpectedToWrite:) для прогресса.
Flutter: пакет dio с onReceiveProgress, сохранение через path_provider. Для фонового скачивания — flutter_downloader, который оборачивает нативные DownloadManager (Android) и URLSession (iOS).
Нюансы, которые часто пропускают
Файл может скачаться частично из-за обрыва. Resumable download через Range заголовок (Range: bytes=1048576-) работает только если сервер отдаёт Accept-Ranges: bytes и Content-Range. Если сервер не поддерживает — скачивание начинается заново. Перед реализацией resume стоит проверить поведение бэкенда.
Также важно показывать реальный прогресс, а не детерминированный. Если Content-Length в заголовке отсутствует — прогресс-бар будет «крутиться» без процентов.
Что входит в работу
Выбираем подход под задачу (in-memory vs файл, foreground vs background), реализуем прогресс, сохранение в нужную директорию, обработку ошибок сети и очистку временных файлов.
Срок: 1–3 дня в зависимости от требований к resumable и background-поведению.