Реализация скачивания файлов (Download) в мобильном приложении

Реализация скачивания файлов (Download) в мобильном приложении

Скачивание файлов — не просто вызов API. Разделяйте два принципиально разных сценария: быстрое скачивание небольших ресурсов (изображения, документы до 10 МБ) прямо в памяти, и загрузка крупных файлов (видео, архивы до 10 ГБ) с отображением прогресса и возможностью возобновить. Смешивать подходы — частая ошибка, которая выражается в OOM-крашах или висящем индикаторе без обратной связи. Мы реализовали эту логику в 50+ проектах за 10 лет на рынке — гарантируем стабильную работу даже на слабых устройствах.

Как избежать OOM при загрузке больших файлов?

Основная причина OOM — попытка загрузить весь файл в память. Для файлов >10 МБ всегда используйте потоковую запись на диск. На Android — OkHttp с ResponseBody.byteStream() и запись в файл через FileOutputStream в фоновой корутине. На iOS — URLSession.downloadTask сохраняет во временный файл автоматически. Для Flutter — dio с опцией receiveTimeout и запись через File. На практике OOM возникает при скачивании файлов >50 МБ без буферизации.

Почему прогресс-бар может не работать?

Прогресс-бар показывает корректные проценты только если сервер возвращает заголовок Content-Length. Если его нет — индикатор будет «крутиться» без числового значения. В таких случаях можно показывать неопределённый прогресс (activity indicator) или загружать файл частями через Range-запросы, если сервер поддерживает докачку. Более 30% серверов не отдают Content-Length, поэтому тестируйте на реальном бэкенде.

Реализация по платформам

Сравним подходы на трёх основных платформах:

Android. Для загрузки в память — OkHttp или Retrofit с ResponseBody.byteStream(), данные пишем в файл в IO-корутине. Для крупных файлов системный DownloadManager с уведомлением в статусбаре — пользователь видит прогресс даже после выхода из приложения. Альтернатива — WorkManager + кастомный Worker, если нужно больше контроля над логикой.

Сохранение в папку Downloads на Android 10+: используем MediaStore API для общедоступных файлов, getExternalFilesDir() — для приватных. Попытка писать напрямую в /sdcard/Download/ без MediaStore на современных версиях даст 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 стоит проверить поведение бэкенда — это экономит до 30% времени загрузки при нестабильном соединении.

Также важно показывать реальный прогресс, а не детерминированный. Если Content-Length в заголовке отсутствует — прогресс-бар будет «крутиться» без процентов. В этом случае лучше использовать неопределённый индикатор.

Процесс работы

1. Анализ требований: какие файлы, максимальный размер, нужен ли resume и фоновая загрузка.
2. Выбор стека: DownloadManager или URLSession background с конфигурацией.
3. Проектирование: схема сохранения, обработка ошибок, диалог прогресса.
4. Реализация: написание кода с учётом платформенных особенностей (ProGuard/R8, App Transport Security).
5. Тестирование: на реальных устройствах с разной скоростью сети и прерываниями.
6. Деплой: публикация в App Store и Google Play с отладкой crash logs.

Типичные ошибки при скачивании файлов

• Загрузка в main thread — гарантированный ANR на Android.
• Игнорирование Content-Type — файл может сохраниться без расширения.
• Не очищаются временные файлы — растёт Documents & Data.
• На iOS не снимается URLSession после фоновой задачи — утечка памяти.

Что входит в работу

Выбираем подход под задачу (in-memory vs файл, foreground vs background), реализуем прогресс, сохранение в нужную директорию, обработку ошибок сети и очистку временных файлов. Мы под ключ реализуем скачивание с учётом всех платформенных особенностей — от App Store Review Guidelines до ProGuard правил.

Срок: 1–3 дня в зависимости от требований к resumable и background-поведению. Свяжитесь с нами, чтобы оценить ваш проект — пишите, мы предложим оптимальное решение с учётом вашего стека. Закажите консультацию, и мы разберём ваш кейс.

Документация: URLSession Programming Guide, DownloadManager Reference

Интеграция API в мобильное приложение: с чего начать

Запрос уходит, ответ не приходит, timeout — 30 секунд. Пользователь смотрит на спиннер. Сети нет — мобильная карта в метро. Или сеть есть, но сервер вернул 200 с HTML-страницей ошибки вместо JSON — и приложение крашит при JSONDecoder.decode(). Мы видим такие кейсы на каждом втором проекте. Поэтому интеграция API в мобильное приложение — это не просто вызов endpoint'а, а проектирование надёжного сетевого слоя: обработка ошибок, кэширование, offline-режим, certificate pinning. Закажите аудит текущего сетевого слоя — оценим проект за 1 день.

Почему стандартные библиотеки недостаточны? URLSession и OkHttp предоставляют базовый HTTP-клиент, но для production нужны retry с exponential backoff, валидация статус-кодов, типизированная десериализация и мониторинг состояния сети. Без этого приложение теряет данные и пользователей. Мы уже 5 лет занимаемся мобильной разработкой и реализовали более 30 проектов с интеграцией API на iOS, Android и Flutter — от стартапов до enterprise-решений.

Как выбрать протокол для интеграции API?

REST остаётся стандартом для большинства проектов. Но когда на экране профиля нужно 5 полей из 40, GraphQL исключает over-fetching и сокращает трафик на 30–60%. gRPC оправдан при тысячах запросов в минуту (trading, IoT) — бинарная сериализация в 3–5 раз быстрее JSON. WebSocket — единственный выбор для real-time без polling (сообщения, уведомления).

Пример из практики: для финтех-приложения мы заменили REST (40 полей) на GraphQL — размер ответа сократился с 12 КБ до 2,5 КБ, время рендера экрана упало на 70%. Экономия трафика составила около 15 000 ₽ в месяц при 100 000 активных пользователей.

Как обеспечить надёжность соединения и offline-first

Пользователи теряют сеть в метро, лифте, тоннеле. Мобильное приложение обязано работать без интернета — хотя бы в read-only режиме. Мы внедряем паттерн offline-first:

1. При открытии экрана сначала показываем данные из локального кеша (Core Data / Room).
2. Параллельно выполняем сетевой запрос, обновляем UI после ответа.
3. Если сеть недоступна — показываем кешированные данные и метку «нет соединения».
4. При восстановлении сети автоматически синхронизируем изменения.

Для кэширования HTTP-ответов используем URLCache (iOS) и OkHttp Cache (Android) с поддержкой Cache-Control. Для структурированных данных — SwiftData / Room. NWPathMonitor / ConnectivityManager.NetworkCallback отслеживают состояние сети и триггерят обновление.

REST и выбор клиентской библиотеки

Alamofire (iOS) — де-факто стандарт для Swift-проектов. Поверх URLSession добавляет request chaining, response validation, automatic retry, certificate pinning через ServerTrustManager. AF.request() с .validate() возвращает ошибку для любого статус-кода вне 200–299. Без .validate() Alamofire считает 404 и 500 успешными ответами. С Swift Concurrency — async-версия через serializingDecodable.

Retrofit (Android) — аннотационный HTTP-клиент поверх OkHttp. Интерфейс с аннотациями компилируется в реализацию. @GET, @POST, @Path, @Query, @Body — декларативное описание API. OkHttp под капотом: connection pooling, transparent gzip, HTTP/2 multiplex. HttpLoggingInterceptor — логирование в debug-сборке. Authenticator — автоматический refresh токена при 401.

Ktor (KMM/Flutter) — мультиплатформенный HTTP-клиент. На iOS работает через Darwin engine (URLSession), на Android — через OkHttp. Единый код для обеих платформ при KMM-архитектуре.

GraphQL: когда REST не справляется

REST возвращает фиксированную структуру. Экран профиля требует name, avatar, email — сервер отдаёт 40 полей. Over-fetching. GraphQL решает это: клиент запрашивает ровно нужные поля. Это критично для мобайла, где трафик и время парсинга — реальные ограничения. Apollo iOS и Apollo Kotlin генерируют типизированные классы по схеме: schema.graphql + query-файлы → строгие типы на этапе компиляции. Subscriptions через WebSocket — real-time без polling. Ограничение: GraphQL сложнее кешировать на уровне HTTP. Apollo использует нормализованный in-memory кеш InMemoryNormalizedCache — запросы с пересекающимися данными обновляют кеш без дублирования. Apollo GraphQL Documentation

WebSocket: real-time без лишнего трафика

Polling (setInterval каждые 5 секунд) — трата батареи и трафика. WebSocket — постоянное двунаправленное соединение. iOS: URLSessionWebSocketTask (нативный, iOS 13+). Android: OkHttp WebSocket. Обязательная обработка reconnect: при onFailure — экспоненциальный backoff (1с → 2с → 4с → 8с → максимум 60с). Socket.IO — надстройка с автоматическим reconnect, но для новых проектов предпочтительнее нативный WebSocket (меньше зависимостей).

gRPC: для высоконагруженных сервисов

gRPC с protobuf — бинарная сериализация: меньше размер, быстрее парсинг. grpc-swift для iOS, grpc-kotlin для Android. Protobuf-схема компилируется в типизированные классы. Streaming (server-side, client-side, bidirectional) — нативная возможность. Порог применения: высокая частота запросов (trading, IoT) или критичная latency. Для обычного CRUD REST проще в дебаге и мониторинге.

Certificate Pinning и безопасность

Корпоративный proxy может перехватить HTTPS через подмену сертификата. Certificate pinning предотвращает это: приложение принимает только конкретный сертификат или публичный ключ. Alamofire: ServerTrustManager с PinnedCertificatesTrustEvaluator. OkHttp: CertificatePinner с SHA-256 хешем. Операционная сложность: при ротации сертификата старые версии приложения перестают работать. Решение — pinning на публичный ключ CA или поддержка нескольких пинов с grace period. Подробнее о certificate pinning на Wikipedia

Что входит в работу

Мы передаём: исходный код сетевого слоя, документацию по используемым библиотекам, инструкцию по ротации сертификатов, поддержку в течение 2 недель после сдачи.

Сроки и стоимость

Реализация сетевого слоя с REST, retry, кэшированием и offline-режимом — 1–2 недели. Добавление GraphQL или WebSocket — ещё 1–2 недели. gRPC — 2–3 недели, включая кодогенерацию. Стоимость рассчитывается индивидуально после анализа API и требований к offline-поведению. Оценим проект за 1 день — свяжитесь для консультации.