Розробка 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 у ваш мобільний застосунок, напишіть нам.