Реалізація завантаження файлів (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. Гарантуємо стабільну роботу навіть при нестабільному з'єднанні — замовте аудит поточного мережевого шару.

Стандартних бібліотек (URLSession, OkHttp) недостатньо для production: вони надають лише базовий HTTP-клієнт. Для реальної експлуатації потрібні retry з exponential backoff, валідація статус-кодів, типізована десеріалізація та моніторинг стану мережі. Без цього додаток втрачає дані та користувачів. Ми маємо понад 5 років досвіду в мобільній розробці, реалізували 30+ проєктів з інтеграцією API на iOS, Android та Flutter — від стартапів до enterprise-рішень. Сертифіковані iOS/Android розробники гарантують якість коду.

Як вибрати протокол для інтеграції 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%. Економія трафіку була значною при 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 відстежують стан мережі та тригерять оновлення. Connection Pooling і HTTP/2 multiplexing зменшують latency при паралельних запитах.

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. Згідно з OkHttp Official Guide, правильна конфігурація кешу зменшує кількість мережевих запитів на 40%.

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 — запити з перетинаючимися даними оновлюють кеш без дублювання.

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 (менше залежностей). TLS 1.3 забезпечує безпеку з'єднання.

Чому важливий certificate pinning?

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

Що входить у роботу

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

Терміни та вартість

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