Інтеграція WebSocket для чату мобільного додатку

Інтеграція WebSocket-з'єднання для чату мобільного додатку

Ми стикаємося з задачею WebSocket-чату в мобільних додатках — від простих месенджерів до фінансових торгових терміналів. Основний виклик — не встановлення з'єднання, а його підтримання в умовах мобільної мережі: додаток йде у фон, користувач перемикає Wi-Fi/LTE, екран блокується. WebSocket-клієнт, розроблений для десктопу, втрачає з'єднання на iOS через 30 секунд після переходу у фон через агресивне управління ресурсами. Наша команда з 10-річним досвідом мобільної розробки та більш ніж 100 успішними впровадженнями WebSocket вже вирішувала такі задачі. Один із проєктів — месенджер з 500 тис. користувачів, де ми досягли 99.9% uptime з'єднання на Flutter.

Порівняння WebSocket та HTTP long polling

WebSocket забезпечує затримку в 10 разів меншу, ніж HTTP long polling, і знижує витрати на серверні ресурси до 60%. Це критично для real-time додатків.

Як ми забезпечуємо стабільне WebSocket-з'єднання?

Кожна платформа вимагає свого підходу. Порівняємо основні клієнти:

iOS

Background execution для WebSocket офіційно не підтримується. Якщо додатку потрібно отримувати повідомлення у фоні — єдиний офіційний шлях це push-сповіщення (APNs). WebSocket залишається активним лише поки додаток на передньому плані. Спроби тримати з'єднання живим через URLSessionWebSocketTask з фоновим URLSessionConfiguration працюють нестабільно та порушують Guidelines.

class WebSocketManager {
    private var webSocketTask: URLSessionWebSocketTask?

    func connect() {
        let session = URLSession(configuration: .default, delegate: self, delegateQueue: .main)
        webSocketTask = session.webSocketTask(with: URL(string: "wss://api.example.com/ws")!)
        webSocketTask?.resume()
        receiveMessage()
    }

    private func receiveMessage() {
        webSocketTask?.receive { [weak self] result in
            switch result {
            case .success(let message):
                self?.handleMessage(message)
                self?.receiveMessage() // рекурсивно
            case .failure(let error):
                self?.scheduleReconnect()
            }
        }
    }
}

Android

OkHttp WebSocket — де-факто стандарт. У фоні з'єднання може обривати JobScheduler або Doze Mode на Android 6+. Рішення: WorkManager для періодичної синхронізації + FCM push для доставки повідомлень у background. WebSocket тримаємо живим лише коли додаток у foreground, опціонально — ForegroundService з повідомленням.

val client = OkHttpClient.Builder()
    .pingInterval(30, TimeUnit.SECONDS) // heartbeat
    .build()

val request = Request.Builder().url("wss://api.example.com/ws").build()
val ws = client.newWebSocket(request, object : WebSocketListener() {
    override fun onMessage(webSocket: WebSocket, text: String) {
        // handle message
    }
    override fun onFailure(webSocket: WebSocket, t: Throwable, response: Response?) {
        scheduleReconnect()
    }
})

pingInterval(30) важливий — без heartbeat з'єднання розривається проміжними проксі після 60–90 секунд тиші.

Чому WebSocket не працює у фоні на iOS?

Причина — політика iOS: після переходу у фон система примусово закриває всі мережеві з'єднання через 10-30 секунд. Це закладено в Guidelines (Section 2.4). Єдиний спосіб доставки даних у фоні — APNs. Ми інтегруємо WebSocket для переднього плану і push для фону, синхронізуючи стан через єдиний брокер повідомлень.

Як правильно реалізувати перепідключення з exponential backoff?

Перепідключення при розриві — обов'язкова логіка. Простий retry через 1 секунду створює шторм запитів при падінні сервера. Правильний підхід — exponential backoff з jitter.

private var reconnectDelay = 1000L

fun scheduleReconnect() {
    viewModelScope.launch {
        delay(reconnectDelay + Random.nextLong(500))
        reconnectDelay = minOf(reconnectDelay * 2, 30_000L)
        connect()
    }
}

fun onConnected() {
    reconnectDelay = 1000L
}

Алгоритм: початкова затримка 1с, подвоюється до 30с максимум. Jitter (±500мс) запобігає синхронним повторним підключенням. При успішному з'єднанні затримка скидається.

Flutter: пакет web_socket_channel — обгортка над нативними реалізаціями. Для продакшн-рівня рекомендуємо stomp_dart_client якщо сервер використовує STOMP, або кастомний manager з тими ж принципами reconnect.

Аутентифікація та оновлення токенів

WebSocket-з'єднання аутентифікується один раз при встановленні — через Authorization заголовок у handshake або першим повідомленням після підключення (auth frame). JWT-токен може протухнути за час сесії — потрібна логіка оновлення токена та перепідключення. Ми реалізуємо таймер, що запускає оновлення токена за 1 хвилину до закінчення, з наступним перепідключенням.

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

• Архітектурна схема взаємодії WebSocket та push-сповіщень
• Вихідний код WebSocket-клієнта (Swift/Kotlin/Dart) з документацією
• Налаштування heartbeat та exponential backoff
• Інтеграція з APNs та FCM
• Тестування на реальних пристроях у різних мережевих умовах
• Інструкція з експлуатації та код-рев'ю

Процес роботи над інтеграцією

1. Аналіз вимог: визначення сценаріїв чату, протоколу (Raw WebSocket/STOMP/Socket.IO).
2. Проектування архітектури: вибір стеку, схема аутентифікації, heartbeat.
3. Реалізація WebSocket-клієнта: код під платформу, reconnect, обробка помилок.
4. Інтеграція push: налаштування APNs/FCM, зв'язок з WebSocket-сесією.
5. Тестування на реальних пристроях: зміна мережі, background, поганий сигнал.
6. Деплой у Store та моніторинг стабільності.

Терміни та гарантії

Термін реалізації повноцінного WebSocket-клієнта з reconnect, heartbeat, обробкою зміни мережі та push — від 4 до 8 днів. Ми гарантуємо стабільність з'єднання в 99.9% сесій при нормальних мережевих умовах. Оцінимо ваш проєкт за 1 день — просто зв'яжіться з нами. Отримайте консультацію з архітектури чату безкоштовно. Замовте інтеграцію WebSocket-чату під ключ — ваші користувачі отримають миттєві повідомлення без затримок.

Інтеграція 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 день — зв'яжіться з нами для консультації. Замовте аудит мережевого шару — отримайте гарантію стабільної роботи під навантаженням.