Розробка gRPC API для мобільних застосунків під ключ

При розробці мобільних застосунків з високою частотою запитів або real-time оновленнями REST/JSON часто виявляється вузьким місцем. Ми інтегруємо gRPC API як альтернативу — з бінарним протоколом, строгою типізацією та вбудованим стрімінгом. Наша команда має багаторічний досвід у мобільній розробці та гарантує коректну роботу gRPC на будь-яких мережевих умовах.

Чому gRPC ефективніший за REST/JSON для мобільних?

gRPC виграє у REST у трьох сценаріях: високочастотні запити з передбачуваною схемою (трекінг, телеметрія), real-time streaming (чати, оновлення) та мікросервісна архітектура, де mobile gateway вже на gRPC. JSON-over-REST простіший у налагодженні та не вимагає HTTP/2, але програє в розмірі переданих даних — бінарний Protobuf у 3-4 рази компактніший за JSON. Крім того, gRPC забезпечує типобезпеку контракту, що виключає помилки серіалізації на стороні клієнта. Підвищення продуктивності особливо помітне при великому обсязі даних: типовий REST-відповідь 8-10 КБ стискається до 1-2 КБ у gRPC.

Як проектується .proto контракт?

Контракт — єдине джерело правди. Зміна файлу .proto призводить до перегенерації клієнтів на всіх платформах:

syntax = "proto3";
package mobile.api.v1;

service ProductService {
  rpc GetProduct (GetProductRequest) returns (Product);
  rpc ListProducts (ListProductsRequest) returns (stream Product);
  rpc WatchInventory (WatchInventoryRequest) returns (stream InventoryUpdate);
}

message Product {
  string id = 1;
  string name = 2;
  int64 price_cents = 3;
  repeated string image_urls = 4;
}

message GetProductRequest {
  string id = 1;
}

stream Product у ListProducts — server-side streaming: сервер надсилає продукти по одному в міру готовності, не чекає всіх. WatchInventory — серверний стрім для real-time оновлень. Для двонаправленого стрімінгу використовуйте rpc BiDirectionalStream(stream Request) returns (stream Response).

Як gRPC вирішує проблему серіалізації на мобільних?

Бінарний формат Protobuf не лише компактний, але й строго типізований. Клієнтська кодогенерація створює з файлу .proto класи з методами get/set, що виключає помилки в іменах полів. На Android це Kotlin-датакласи з fromProto/toProto, на iOS — структури Swift з Codable. Кодогенерація вбудовується в CI: Gradle задача generateProto і Swift Package Manager плагін swift-protobuf. Це гарантує, що версії .proto на клієнті та сервері синхронізовані.

Android: gRPC-Kotlin з Coroutines та Interceptor

На Android використовуємо OkHttp-транспорт — він легший за Netty (приріст APK ~1.5 МБ проти 3 МБ) і швидше ініціалізується.

// build.gradle
implementation 'io.grpc:grpc-android:1.x.x'
implementation 'io.grpc:grpc-okhttp:1.x.x'

val channel = ManagedChannelBuilder
    .forAddress("api.example.com", 443)
    .useTransportSecurity()
    .intercept(AuthInterceptor(tokenProvider))
    .build()

val stub = ProductServiceGrpcKt.ProductServiceCoroutineStub(channel)

// Unary виклик
val product = stub.getProduct(getProductRequest { id = productId })

// Server streaming
stub.listProducts(listProductsRequest { categoryId = "electronics" })
    .collect { product -> /* обробляємо по мірі надходження */ }

AuthInterceptor реалізує ClientInterceptor і додає метадані Authorization до кожного виклику. Deadline та keepalive налаштовуються через ManagedChannelBuilder:

.keepAliveTime(30, TimeUnit.SECONDS)
.keepAliveTimeout(10, TimeUnit.SECONDS)
.keepAliveWithoutCalls(false)

Кожен виклик повинен мати deadline — інакше завислий запит висить вічно:

stub.withDeadlineAfter(10, TimeUnit.SECONDS).getProduct(request)

iOS: gRPC-Swift з async/await

На iOS використовуємо пакет grpc-swift з TLS та Swift Concurrency:

let group = PlatformSupport.makeEventLoopGroup(loopCount: 1)
let channel = try GRPCChannelPool.with(
    target: .host("api.example.com", port: 443),
    transportSecurity: .tls(.makeClientDefault(compatibleWith: group)),
    eventLoopGroup: group
)

let client = ProductService_ProductServiceNIOClient(channel: channel)

let request = ProductService_GetProductRequest.with { $0.id = productId }
let response = try await client.getProduct(request).response.get()

// Server streaming через AsyncStream
let call = client.listProducts(listRequest)
for try await product in call.responses { }

Як налагоджувати gRPC трафік на мобільних?

JSON-трафік легко читається в Charles/Proxyman, а Protobuf — бінарний. Для налагодження використовуємо grpcurl (command-line), grpc-ui (web UI), Wireshark з gRPC dissector. У dev-збірці підключаємо LoggingClientInterceptor з grpc-java для логування метаданих. Також можна увімкнути reflection API на сервері та виконувати запити через grpc-cli.

Як забезпечити зворотну сумісність .proto схеми?

Зворотна сумісність — ключова перевага Protobuf. Правила:

• Нові поля додаємо з новим номером, ніколи не перевикористовуємо видалені номери.
• required не використовуємо (Protobuf 3 прибрав його не випадково).
• Для перейменування: додаємо нове поле, старе позначаємо reserved.

Порушення цих правил — binary incompatibility: старі версії застосунку будуть падати при отриманні нової схеми.

Як налаштувати retry та deadline для мобільного gRPC?

На стороні клієнта конфігуруємо RetryPolicy у ServiceConfig. Приклад для Kotlin:

val serviceConfig = """
{
  "methodConfig": [{
    "name": [{}],
    "retryPolicy": {
      "maxAttempts": 4,
      "initialBackoff": "1s",
      "maxBackoff": "10s",
      "backoffMultiplier": 2,
      "retryableStatusCodes": ["UNAVAILABLE"]
    }
  }]
}
""".trimIndent()

val channel = ManagedChannelBuilder.forAddress("api.example.com", 443)
    .defaultServiceConfig(JsonParser.parseString(serviceConfig).getAsJsonObject())
    .enableRetry()
    .build()

Deadline обов'язковий для кожного виклику — ми встановлюємо 10 секунд на unary та 30 секунд на streaming. При слабкому з'єднанні використовуємо withExecutor для пулу потоків і налаштовуємо keepalive.

Що входить у роботу та терміни

Процес: аналітика → проектування .proto схеми → налаштування кодогенерації в CI → реалізація gRPC клієнта на Android/iOS з TLS, auth interceptor, deadline та retry → тестування на різних мережевих умовах → деплой.

Терміни: 2–4 тижні (залежить від складності). Ми гарантуємо стабільну роботу на всіх мобільних мережах і забезпечуємо повну документацію по схемі. Зв'яжіться з нами для безкоштовної оцінки вашого проєкту — розрахуємо інтеграцію gRPC під ваші завдання. Отримайте консультацію щодо впровадження gRPC у ваш мобільний застосунок, напишіть нам.

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