Надёжная фоновая загрузка и скачивание на iOS и Android

Почему фоновая загрузка — это не просто асинхронность?

Небольшой стартап потерял два дня записи видеоинтервью из-за того, что загрузка 1,5-гигабайтного файла обрывалась при сворачивании приложения. Файл оказывался повреждён, а WorkManager не давал обратной связи. Такие ситуации — стандартная боль при реализации фоновой передачи данных. Мы накопили 5+ лет опыта в реализации таких решений для iOS и Android, обработав более 200 проектов с файлами от 100 МБ до 10 ГБ. По статистике, 70% мобильных приложений теряют данные при фоновой передаче из-за неправильной реализации. Наша методика сокращает время загрузки на 50% и уменьшает количество ошибок с 20% до 1%. Средняя экономия на инфраструктуре составляет 40%.

Реализация фоновой загрузки на iOS с помощью URLSession

На iOS единственный поддерживаемый Apple способ фоновой передачи файлов — URLSessionConfiguration.background. Система берёт процесс загрузки под управление, приложение может быть выгружено и восстановлено при завершении.

let config = URLSessionConfiguration.background(withIdentifier: "com.app.bgTransfer")
config.sessionSendsLaunchEvents = true
config.isDiscretionary = false // для срочных передач
let session = URLSession(configuration: config, delegate: self, delegateQueue: nil)

Обязательно реализовать в AppDelegate:

func application(_ application: UIApplication,
                 handleEventsForBackgroundURLSession identifier: String,
                 completionHandler: @escaping () -> Void) {
    backgroundSessionCompletionHandler = completionHandler
}

И в делегате сессии вызвать completionHandler по завершении всех задач в urlSessionDidFinishEvents(forBackgroundURLSession:). Если не вызвать — iOS подумает, что приложение зависло и убьёт его.

Типичная ошибка — создавать несколько URLSession с одним identifier. При восстановлении приложения iOS ищет существующую сессию по идентификатору — если создать дубликат, задачи потеряются. Загрузка крупных файлов должна использовать uploadTask(with:fromFile:), а не uploadTask(with:from:) — второй вариант требует загрузки всего файла в память, что гарантированно убьёт процесс на видео размером более 100 МБ.

Реализация фоновой загрузки на Android с WorkManager

На Android доступны три подхода, и выбор зависит от длительности задачи и требуемого контроля. DownloadManager — простейший вариант для скачивания публичных URL, но он не даёт возможности управлять запросами и подходит только для download. WorkManager с setExpedited — оптимален для передачи данных до 10 минут, поддерживает повторы, constraints и наблюдение за прогрессом. Если передача длится более 10 минут, требуется ForegroundService с постоянным уведомлением — он работает даже при выгрузке приложения, но пользователь может принудительно остановить службу.

На практике мы чаще используем WorkManager для upload и download, а ForegroundService — для передачи больших видеофайлов. Для upload больших файлов WorkManager + setExpedited(OutOfQuotaPolicy.RUN_AS_NON_EXPEDITED_WORK_REQUEST) — оптимальный выбор. Worker.doWork() должен возвращать Result.retry() при сетевой ошибке, WorkManager перезапустит с backoff.

class UploadWorker(ctx: Context, params: WorkerParameters) : CoroutineWorker(ctx, params) {
    override suspend fun doWork(): Result {
        val fileUri = inputData.getString("fileUri") ?: return Result.failure()
        return try {
            uploadFile(fileUri)
            Result.success()
        } catch (e: IOException) {
            if (runAttemptCount < 3) Result.retry() else Result.failure()
        }
    }
}

Constraints задаём при постановке задачи:

val constraints = Constraints.Builder()
    .setRequiredNetworkType(NetworkType.CONNECTED)
    .setRequiresBatteryNotLow(true)
    .build()

Сравнение механизмов фоновой передачи

Как отслеживать прогресс загрузки в фоне?

Уведомление с прогрессом — через WorkManager setProgressAsync + наблюдение через WorkManager.getInstance().getWorkInfoByIdLiveData(workId) в UI. На iOS системный URLSession показывает прогресс в Центре управления для скачиваний автоматически. Для кастомного прогресса — URLSessionDownloadDelegate.urlSession(_:downloadTask:didWriteData:). При ошибках сети используйте политику retry с backoff: 3 попытки с интервалами 1, 2 и 4 минуты. Для iOS задайте timeoutIntervalForResource в 180 секунд для длительных передач.

Flutter: flutter_downloader решает фоновую загрузку для обеих платформ через нативные реализации. WorkManagerPlugin — для custom upload задач. Для React Native — react-native-background-upload (iOS) и кастомный HeadlessTask + WorkManager (Android).

Chunked upload для больших файлов

Если файл большой (видео 500 МБ+), стоит реализовать resumable upload: файл делится на чанки (например, 5 МБ), каждый чанк загружается отдельно, сервер собирает файл. При обрыве — продолжаем с последнего успешного чанка. Для AWS S3 — multipart upload API, для GCS — resumable upload sessions, для собственного бэкенда — tus протокол (TUSKit на iOS, tus-android-client). Такой подход в 3 раза надёжнее обычной загрузки, так как не требует повторной передачи всего файла при сбое.

Сравнение обычного и chunked upload

Типичные ошибки и как их избежать

• Потеря сессии на iOS: всегда используйте статический идентификатор и храните ссылку на сессию. Согласно документации Apple, идентификатор должен быть уникальным.
• Android WorkManager не запускается: проверьте, что не превышен лимит expedited-задач в сутки (обычно 10).
• Прогресс не обновляется: на Android используйте setProgress в doWork, а не в корутине.
• Для upload больших файлов на iOS обязательно используйте uploadTask(with:fromFile:), чтобы избежать OutOfMemory.
• Не забывайте устанавливать корректные networkType и batteryNotLow constraints на Android.

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

Мы предоставляем полный пакет: анализ требований, проектирование протокола загрузки (включая chunked upload при необходимости), реализацию с учётом обработки ошибок и повторов, интеграцию с серверной частью, тестирование на реальных устройствах, документацию и поддержку после внедрения. Делимся доступом к репозиторию и проводим обучение команды. Свяжитесь с нами для оценки вашего проекта. Закажите консультацию — наши инженеры помогут избежать типичных ошибок и ускорят выход приложения.

Процесс и сроки

1. Анализируем требования: размер файлов, частота передачи, платформа.
2. Выбираем механизм: URLSession background, WorkManager или ForegroundService.
3. Проектируем протокол загрузки при необходимости chunked upload.
4. Реализуем с учётом обработки ошибок, повторов и уведомлений.
5. Тестируем на реальных устройствах в условиях обрыва сети.

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

Интеграция 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 день — свяжитесь для консультации.