Changelog

This page contains all changes throughout releases of the library.

0.11.0-grpc-185

Full Changelog: 0.10.2...0.11.0-grpc-185

Overview

This release introduces gRPC and Protocol Buffers support for kotlinx-rpc — a Kotlin Multiplatform implementation of gRPC with native protobuf serialization.

Two approaches are supported:

Schema-first — define services and messages in .proto files, and the Gradle plugin generates idiomatic Kotlin code with suspend functions, Flow-based streaming, and type-safe message builders. See the gRPC configuration and generated code docs.
Proto-less — write gRPC service interfaces directly in Kotlin with any serialization format (kotlinx.serialization, custom GrpcMarshaller, etc.), no .proto files needed. See the gRPC services docs.

Supported gRPC workflows:

Unary RPC (request-response)
Server streaming (server returns Flow)
Client streaming (client sends Flow)
Bidirectional streaming (both sides use Flow)
Client and server interceptors
TLS encryption and call credentials
Call metadata (headers and trailers)
Timeout, gzip compression, and keepalive support
Ktor server integration
Status exception handling
proto-less gRPC services

Supported protobuf features:

Proto2, proto3, and editions 2023 syntax
All scalar types, enums, repeated fields, maps, oneof, nested messages
Optional types and field presence tracking
Extensions and groups (deprecated proto2 feature)
Well-Known Types (bundled with the runtime)
Unknown field propagation
Full protobuf conformance test compliance
Custom serialization via kotlinx.serialization or custom GrpcMarshaller

Supported platforms: JVM, Android, iOS, macOS, Linux.

Features 🎉

gRPC initial implementation by @Mr3zee in #262
Simplified gRPC Gradle configuration by @Mr3zee in #281
Internal vs public codegen separation in gRPC (KRPC-162) by @Mr3zee in #285
Reference types by @Mr3zee in #291
Enum support by @Mr3zee in #294
Optional types support (KRPC-142) by @Mr3zee in #295
Repeated types (KRPC-143) by @Mr3zee in #328
Nested types (KRPC-146) by @Mr3zee in #331
OneOf types (KRPC-147) by @Mr3zee in #332
Map types (KRPC-145) by @Mr3zee in #334
Streaming support (unary, server, client, bidirectional) by @Mr3zee in #389
gRPC Ktor server plugin by @Mr3zee in #393
Native initial setup with C++/C/Kotlin interface by @Jozott00 in #400
Wire format encoder and decoder by @Jozott00 in #412
Proto generation for common (JVM and Native) by @Jozott00 in #415
Common APIs for gRPC Services, Client, and Server by @Mr3zee in #419
Field presence tracking, required field enforcing, and MessageCodec generation by @Jozott00 in #421
Enum and oneof field generation by @Jozott00 in #426
gRPC service generation in the compiler plugin by @Mr3zee in #428
Sub-messages (recursive, nested, repeated) by @Jozott00 in #430
Map support in protobuf codec by @Jozott00 in #434
Exceptions and skip unknown fields by @Jozott00 in #437
Native client calls support by @Jozott00 in #452
iOS support (arm64, x64, simulatorArm64) by @Jozott00 in #458
Linux support (arm64, x64) by @Jozott00 in #466
Native server implementation by @Jozott00 in #469
TLS credentials support (client and server) by @Jozott00 in #471
Deprecated groups support by @Jozott00 in #472
Enable all conformance tests by @Jozott00 in #473
Client and server interceptor API by @Jozott00 in #484
Grpc.Method annotation by @Mr3zee in #487
Comments support in generated code by @Mr3zee in #488
Deprecated options support by @Mr3zee in #489
hashCode, equals and toString for generated messages by @Mr3zee in #490
Call metadata — headers and trailers by @Jozott00 in #517
Timeout support by @Jozott00 in #525
gzip compression support by @Jozott00 in #527
Keepalive support by @Jozott00 in #528
Call credentials by @Jozott00 in #530
Add missing Apple targets by @Jozott00 in #533
Full KMP support for the Gradle Plugin by @Mr3zee in #534
Status exception API refactoring by @Jozott00 in #536
copy method for generated messages by @Jozott00 in #539
Presence check support by @Jozott00 in #540
Android source sets support by @Mr3zee in #542
Unknown field propagation by @Jozott00 in #557
Add protoServiceName to [@Grpc](https://github.com/Grpc) annotation by @Jozott00 in #563
Add CodecConfig and codec function by @Jozott00 in #565
ProtobufConfig with discardUnknownFields option by @Jozott00 in #569
[@GeneratedProtoMessage](https://github.com/GeneratedProtoMessage) annotation and descriptor object by @Jozott00 in #572
Shortest unambiguous names in generated code by @Mr3zee in #573 and #575
Platform options for the Gradle plugin by @Mr3zee in #574
Well-known Any extension functions by @Jozott00 in #577
Companion object generation moved to the compiler plugin by @Mr3zee in #586
Extensions support by @Jozott00 in #587
MARSHALLER and DESCRIPTOR objects for group messages by @Jozott00 in #589
Message recursion limit (KRPC-192) by @Mr3zee in #594
descriptor.proto generation by @Mr3zee in #600

Bug fixes 🐛

Fix JPMS for gRPC by @Mr3zee in #390
Fix generation run for imported files by @Mr3zee in #409
Tasks caching by @Mr3zee in #410
Protobuf conformance fixes by @Mr3zee in #454
Fix service names in the generated descriptor by @Jozott00 in #457
Fix onReady() listener delegation — native server streaming fix (KRPC-220) by @Jozott00 in #477
Fix 32-bit target APIs by @Jozott00 in #537
Fix retry behavior for client RPC calls by @Jozott00 in #545
Fix protobuf size calculation for repeated fields and maps by @fabiocarneiro in #566
Add grpc-marshaller dependency to protobuf-core (KRPC-219) by @Mr3zee in #595
AGP 9.0 support by @Mr3zee in #596
Fix unknown fields in nested messages by @Jozott00 in #599

Documentation 📗

KMP sample project by @Jozott00 in #474
gRPC and Protobuf documentation by @Mr3zee in #598 and #604

Infra 🚧

Set up protobuf conformance tests by @Mr3zee in #447
Pre-built gRPC library to avoid long compilation times by @Jozott00 in #461
Splitting core module into client and server by @Jozott00 in #504
Konan LLVM bundle resolution pinning by @Jozott00 in #579
Gradle 9.4 support by @Mr3zee in #597

Other Changes 🧹

Protoc-gen-kotlin-multiplatform as an included build by @Mr3zee in #411
Gradle plugin tests by @Mr3zee in #413
Fix condition for non-JVM projects by @Mr3zee in #417
Protoc-plugin intermediate model refactoring by @Jozott00 in #418
Integration tests for gRPC + Protoc generated files by @Mr3zee in #444
Remove InputStream abstraction in common by @Jozott00 in #571
Konan LLVM bundle mapping update by @Jozott00 in #585

0.10.2

Full Changelog: 0.10.1...0.10.2

Features 🎉

Kotlin 2.3.0 and 2.3.20-Beta1 by @Mr3zee in #553

Bug fixes 🐛

Hide compiler generated code by @Mr3zee in #555

Infra 🚧

Fixes by @Mr3zee in #532
Update space links by @Mr3zee in #554

Other Changes 🧹

Added KEFS xml to git by @Mr3zee in #531

0.10.1

Full Changelog: 0.10.0...0.10.1

Features 🎉

Kotlin 2.2.21 Support by @Mr3zee in #519
Expose RpcServiceDescriptor.callables by @rnett in #516
Added watchosDeviceArm64 and watchosArm32 targets to kRPC by @Mr3zee in #513

Bug fixes 🐛

Fix one more ClosedSendChannelException by @Mr3zee in #514
Fix scope initialization on the kRPC Client by @Mr3zee in #505
Fix wording for the perCallBufferSize docs by @Mr3zee in #500

Infra 🚧

Added readme safeguard by @Mr3zee in #515
Fixed kRPC compatibility tests by @Mr3zee in #518
Update compiler tests infra by @Mr3zee in #510

New Contributors

@rnett made their first contribution in #516

0.10.0

Full Changelog: 0.9.1...0.10.0

Overview

This release brings a lot of changes, work:

Kotlin 2.2.20 and 2.2.10 support
kRPC: Backpressure

To read about the backpressure feature, see the updated kRPC Configuration page.

Breaking Changes 🔴

Allow suspend calls inside ktor rpc builder #433 by @Mr3zee in #439

Features 🎉

Kotlin 2.2.20 by @Mr3zee in #478
Kotlin 2.2.10 by @Mr3zee in #456
kRPC: Backpressure by @Mr3zee in #462
Add support for Wasm/Wasi to krpc #465 by @Mr3zee in #480

Bug fixes 🐛

Add collect once check for client streams by @Mr3zee in #431
Fix diagnostic rendering for compiler plugins checkers by @Mr3zee in #432
fix wrong unchecked null cast (potential NPE) by @y9maly in #445

Documentation 📗

Docs for gRPC with Ktor by @Mr3zee in #394
Add a doc for KMP source sets with gRPC by @Mr3zee in #405
Update strict-mode.topic by @BierDav in #440
Update grpc-configuration.topic by @flockbastian in #450
Added docs for release by @Mr3zee in #482
Fix typo in docs grpc-configuration.topic by @sebaslogen in #495

Infra 🚧

Fix docs yaml and signing tasks by @Mr3zee in #404
Fix jdk resolution problems on CI by @Mr3zee in #406
Use compat-patrouille for compatibility settings by @Mr3zee in #438

Other Changes 🧹

Fix how we create 'publishMavenArtifact' tasks by @Mr3zee in #416
Update grpc-sample app by @Mr3zee in #425
Fix LV and signing by @Mr3zee in #424
Update ktor-all-platforms-app sample to sync service creation by @Mr3zee in #455
Added Ktor closure tests and Cancellation tests, + minor fixes by @Mr3zee in #479
Fix flaky tests by @Mr3zee in #481

New Contributors

@flockbastian made their first contribution in #450
@y9maly made their first contribution in #445
@sebaslogen made their first contribution in #495

0.9.1

Full Changelog: 0.8.1...0.9.1

Bug fixes 🐛

Support nullable contextual serializers by @yakivy in #392
Make WS plugin installation for Ktor server more flexible by @Mr3zee in #398
Make KtorRpcClient inherit KrpcClient by @Mr3zee in #396

Documentation 📗

Update gRPC doc by @Mr3zee in #391
Add stub targets tags for platforms table by @Mr3zee in #397

Infra 🚧

Remove the monitor application by @Mr3zee in #388

Other Changes 🧹

Update version for 0.9.0-SNAPSHOT by @Mr3zee in #387

0.8.1

Full Changelog: 0.8.0...0.8.1

Bug fixes 🐛

Propagate transport coroutine context by @yakivy in #374
Fix compiler bugs by @Mr3zee in #382
kRPC client initialization is not single shot by @Mr3zee in #385

Documentation 📗

Grpc sample update by @Mr3zee in #371
Fix dokka API button for all modules by @Mr3zee in #381

Infra 🚧

Update pages publication and api link by @Mr3zee in #375
Added artifacts validation by @Mr3zee in #377

Other Changes 🧹

Ci updates by @Mr3zee in #370
Updated CSM sources for template generation by @Mr3zee in #372
Update strict-mode.topic by @BierDav in #380
Update Ktor to 3.2.1 and samples by @Mr3zee in #383

New Contributors

@yakivy made their first contribution in #374
@BierDav made their first contribution in #380

0.8.0

Full Changelog: 0.7.0...0.8.0

Overview

This release brings a lot of changes, including breaking changes:

Kotlin 2.2.0 Update
Decoupling of kotlinx.serialization from the core functionality
Simplifying lifetime schema (services lost their CoroutineScope)
Irreversible enforcement of the strict mode

These changes significantly reduce the number of footguns and improve the overall usability of the library.

Additionally, the internal structure of kRPC protocol and our compiler plugin reduced its complexity. That allows us to provide better quality in future releases (and this also applies to gRPC, even though in this particular release it was not a priority).

For the full list of changes that require migration, see the Migration Guide.

Docs update

We added three new documentation sections:

Features 🎉

Serialization decoupling by @Mr3zee in #354
Update Kotlin to 2.2.0 by @Mr3zee in #359

Breaking Changes 🔴

[Meta] Strict mode, deprecations, lifetime by @Mr3zee in #353

Bug fixes 🐛

Fix compilation for standalone k2 module by @Mr3zee in #350
Fix Pupperteer Version by @Mr3zee in #355

Documentation 📗

Platforms Table and docs by @Mr3zee in #356
Dokka by @Mr3zee in #357
Add Changelog.md to Docs by @Mr3zee in #358
Onboarding by @Mr3zee in #363

Other Changes 🧹

Advance version to 0.8.0-SNAPSHOT by @Mr3zee in #340
Update README.md to use non-suspend flows by @brokenhappy in #342
Fix kotlin master builds by @Mr3zee in #345
Simplify Gradle Configs by @Mr3zee in #360

New Contributors

@brokenhappy made their first contribution in #342

0.7.0

Full Changelog: 0.6.2...0.7.0

Announcement

This release enforces ERROR as a default reporting level for APIs that are forbidden by the strict mode. You can still change the level manually, but in 0.8.0 strict mode will be enforced irreversibly.

Breaking Changes 🔴

Change strict mode to level ERROR by default by @Mr3zee in #338

Other Changes 🧹

Update Kotlin to 2.1.21 by @Mr3zee in #337
Version 0.7.0-SNAPSHOT by @Mr3zee in #325
Samples: version 0.6.2 by @Mr3zee in #326
2.2.0 compiler migration by @Mr3zee in #335

0.6.2

Full Changelog: 0.6.1...0.6.2

Bug fixes 🐛

Fix flows that emit Units by @Mr3zee in #323

0.6.1

Full Changelog: 0.6.0...0.6.1

Bug fixes 🐛

Fix bidirectional flows in non-suspend streams by @Mr3zee in #316
Fix KRPC-173 (#315) by @Mr3zee in #317

0.6.0

Full Changelog: 0.5.1...0.6.0

Features 🎉

2.1.20 by @Mr3zee in #309
Non suspend flow by @Mr3zee in #299

Documentation 📗

Update gRPC Docs and Sample by @Mr3zee in #284

Infra 🚧

Update monitior by @Mr3zee in #282
Fix build config for for-ide builds by @Mr3zee in #287
Update build for custom KC versions by @Mr3zee in #293
Fix kotlin master compilation by @Mr3zee in #306

Other Changes 🧹

Upgrade Gradle to 8.12.1 by @Mr3zee in #286
Version 0.6.0-SNAPSHOT by @Mr3zee in #283
Update leftover sources from jvm-only to kmp by @Mr3zee in #300
KRPC-129 Move compatibility tests from Toolbox to Kotlin RPC repo by @Mr3zee in #304
Dependency bump by @Mr3zee in #303
Better compiler error message for checked annotations by @Mr3zee in #302

0.5.1

Full Changelog: 0.5.0...0.5.1

Features 🎉

2.1.10 by @Mr3zee in #271

Documentation 📗

Fix typo in README.md by @SebastianAigner in #266
Added IDE plugin docs by @Mr3zee in #273

Infra 🚧

Update for IDE configs by @Mr3zee in #272
Added python deps automerge by @Mr3zee in #276

Other Changes 🧹

Update README.md by @pambrose in #268
Added monitor app for deps publication by @Mr3zee in #265
Fix kotlin master by @Mr3zee in #274
Fix println tests by @Mr3zee in #277
Update Python Monitor Dependencies by @renovate in #278

New Contributors

@SebastianAigner made their first contribution in #266
@pambrose made their first contribution in #268

0.5.0

Full Changelog: 0.4.0...0.5.0

Features 🎉

Update Service Descriptors Generation by @Mr3zee in #227
Kotlin 2.1.0 by @Mr3zee in #244
Added basic CheckedTypeAnnotation impl with compiler plugin check by @Mr3zee in #240
Strict mode by @Mr3zee in #243

Breaking Changes 🔴

Api naming by @Mr3zee in #236
Update Service Descriptors Generation by @Mr3zee in #227
Added basic CheckedTypeAnnotation impl with compiler plugin check by @Mr3zee in #240

Deprecations ⚠️

Api naming by @Mr3zee in #236
Strict mode by @Mr3zee in #243

Infra 🚧

Update the project structure to work with kotlin-master by @Mr3zee in #234
Fixed version formatting with ENV vars by @Mr3zee in #235
Fix Kotlin master compilation by @Mr3zee in #245
Opt-out from annotations type safety analysis by @Mr3zee in #246

Other Changes 🧹

Added test for non-serializable params by @Mr3zee in #237
Updated descriptor to use RpcType instead of KType directly by @Mr3zee in #239

0.4.0

Full Changelog: 0.3.0...0.4.0

Features 🎉

Experimental support for: KRPC-125 Manual stream scope management by @Mr3zee in #214
Introduce @Rpc annotation by @Mr3zee in #216
Support Kotlin 2.0.21 and 2.0.20 by @Mr3zee in #217

Breaking Changes 🔴

Introduce @Rpc annotation by @Mr3zee in #216
Remove support for Kotlin versions prior to 2.0 by @Mr3zee in #218

Infra 🚧

Added proxy repository settings by @Mr3zee in #191
Added Kotlin for ide configs to project by @Mr3zee in #219

Bug fixes 🐛

Fix for KT-41082 by @Mr3zee in #225

Other Changes 🧹

Bump core deps by @Mr3zee in #220

0.3.0

Full Changelog: 0.2.4...0.3.0

Features 🎉

Wasm Support by @Mr3zee in #190

Breaking Changes 🔴

Move kRPC declarations from core by @Mr3zee in #186

Bug fixes 🐛

Fix kotlin/js code and samples by @Mr3zee in #179
Fix regression of nested declarations in RPC interfaces by @Mr3zee in #181

Documentation 📗

Wording fixes by @Mr3zee in #175

Infra 🚧

Infra enhancements by @Mr3zee in #206
Fixed Wasm Publication by @Mr3zee in #208
Update renovate configs by @Mr3zee in #185
Configure JPMS checks by @Mr3zee in #187
Update some ide configs by @Mr3zee in #188
Added Gradle Doctor to the build by @Mr3zee in #189
Added build cache and develocity plugin by @Mr3zee in #192
Support variable Kotlin and project versions by @Mr3zee in #201
Update renovate and some deps by @Mr3zee in #198

Other Changes 🧹

Bump version to 0.3.0-SNAPSHOT by @Mr3zee in #174
Fix compiler tests after #172 by @Mr3zee in #180
Remove unused and inactive annotation by @kez-lab in #182
Use built-in JsClass getter by @Mr3zee in #184
Update actions/configure-pages action to v5 by @renovate in #200
Update Samples dependencies by @renovate in #199
Update Core dependencies (non-major) by @renovate in #194
Update Core dependencies (non-major) by @renovate in #205

New Contributors

@kez-lab made their first contribution in #182

0.2.4

Full Changelog: 0.2.2...0.2.4

Features

KRPC-18 Add K2 and IR code generation plugins, preserve KSP for K1 by @Mr3zee in #105
Added 1.9.25 and 2.0.10 Kotlin Versions by @Mr3zee in #168

Bug fixes

KRPC-101 Check if the entire stream is not already closed. by @pikinier20 in #158
KRPC-119 Exception Deserialization by @Mr3zee in #170
Fix compilation on Kotlin/Native by @Mr3zee in #172

Infra

Add issue templates by @Mr3zee in #167

New Contributors

@pikinier20 made their first contribution in #158

0.2.2

Full Changelog: 0.2.1...0.2.2

Bug fixes

Fix log error messages by @Mr3zee in #139
KRPC-97 Race condition in stream cancellation locks the transport by @Mr3zee in #138
Fix call cancellation by @Mr3zee in #141

0.2.1

Full Changelog: 0.1.0...0.2.1

Breaking changes

Release contains breaking changes, see the migration guide

Update the project structure to use a new versioning by @Mr3zee in #92
Consistent module structure by @Mr3zee in #114
KRPC-63 Reorganize modules into a logical structure by @Mr3zee in #110

Features

KRPC-62 WebSocketSession KtorRPCClient by @Mr3zee in #107

Bug fixes

Fix typo by @fatalistt in #76
Fix README by @Mr3zee in #79
Remove todos from repo links by @Mr3zee in #85
Fix typo in README.md by @zhelenskiy in #87
Fix KDoc reference by @Mr3zee in #103
Fix native targets compiler plugins (#93) by @Mr3zee in #112

Deprecations

KRPC-59 streamScoped has internal package by @Mr3zee in #104

Documentation

Updated links on the docs website by @Mr3zee in #71
Added search indexes publication to Algolia action by @Mr3zee in #73
Fix algolia artifact in GH Actions by @Mr3zee in #80
Docs: Add structure to existing content by @vnikolova in #86
Added build and test docs on PR by @Mr3zee in #97
Fixed GH Actions for docs by @Mr3zee in #99
Disable docs website autoupdate by @Mr3zee in #108
KRPC-60 Update docs to match the new versioning scheme by @Mr3zee in #109

Infra

Update version to 0.1.1-SNAPSHOT by @Mr3zee in #64
Version updates by @Mr3zee in #72
Signing and Publication by @Mr3zee in #74
IDEA. Issue links by @turansky in #96
IDEA. Vector icon by @turansky in #98
KRPC-71 Type-safe project accessors by @Mr3zee in #106

New Contributors

@jvmusin made their first contribution in #69
@fatalistt made their first contribution in #76
@zhelenskiy made their first contribution in #87
@turansky made their first contribution in #96
@vnikolova made their first contribution in #86

Last modified: 12 March 2026