kotlinx.rpc 0.10.2 Help

Changelog

This page contains all changes throughout releases of the library.

0.11.0-grpc-188

Full Changelog: 0.11.0-grpc-187...0.11.0-grpc-188

Features 🎉

  • KRPC-239 Add option to disable default protoc plugins by @Mr3zee in #649

  • KRPC-254 Strip redundant enum value prefixes in protoc-gen by @Mr3zee in #650

  • KRPC-264 Add DSL builder for ProtoConfig by @Mr3zee in #647

  • KRPC-237: Add kotlinx.rpc.protoc Gradle property to enable protoc by @ai-agent-kxrpc [bot] in #653

  • KRPC-533: Add SubclassOptInRequired to generated proto messages by @ai-agent-kxrpc [bot] in #656

Bug fixes 🐛

  • KRPC-245 Fix eager configuration resolution warning in Gradle 9.0 by @Mr3zee in #651

  • KRPC-275 Reject invalid UTF-8 in protobuf string extension fields by @Mr3zee in #648

  • KRPC-268: Fix missing leading space in generated KDoc block comments by @ai-agent-kxrpc [bot] in #654

  • KRPC-266 Move ProtobufException classes to public package by @ai-agent-kxrpc [bot] in #655

  • KRPC-274: Reject bad tag field numbers and overlong varints in protobuf parser by @ai-agent-kxrpc [bot] in #657

  • KRPC-548: Fix flaky CancellationTest.testCancelServer on native by @ai-agent-kxrpc [bot] in #660

  • KRPC-549: Fix flaky GrpcTimeoutTest by increasing server delay margin by @ai-agent-kxrpc [bot] in #658

  • KRPC-556: Add markerClass parameter to SubclassOptInRequired annotations by @ai-agent-kxrpc [bot] in #659

  • KRPC-267: Add blank line before properties with block comments in protoc-gen by @ai-agent-kxrpc [bot] in #667

  • KRPC-560: Fix Native segfault in callables property itable dispatch by @ai-agent-kxrpc [bot] in #668

  • KRPC-554: Reject bad tag field numbers and overlong varints in native protobuf parser by @ai-agent-kxrpc [bot] in #669

  • KRPC-558: Reject invalid UTF-8 in protobuf string fields on native by @ai-agent-kxrpc [bot] in #666

  • KRPC-564: Reject >10-byte varint tags in protobuf parser by @ai-agent-kxrpc [bot] in #672

  • KRPC-562: Use ephemeral ports in gRPC integration tests by @ai-agent-kxrpc [bot] in #670

  • KRPC-561: Explicit grpc_channel_destroy before grpc_shutdown in NativeManagedChannel by @ai-agent-kxrpc [bot] in #671

  • KRPC-252: Support type resolution in comments for protoc-gen by @ai-agent-kxrpc [bot] in #673

  • KRPC-567: Fix race in ServerStreamContext.removeCall causing flaky test by @ai-agent-kxrpc [bot] in #681

  • KRPC-597: Fix grpc native release race conditions by @ai-agent-kxrpc [bot] in #711

Documentation 📗

Infra 🚧

  • KRPC-555: Port protobuf conformance tests to Kotlin/Native by @ai-agent-kxrpc [bot] in #661

  • KRPC-565: Fix deprecated abiValidation enabled API for Kotlin >= 2.4.0 by @ai-agent-kxrpc [bot] in #676

  • KRPC-569: Exclude native conformance test when native targets are unavailable by @ai-agent-kxrpc [bot] in #680

  • Add use-develocity skill for build scan analysis by @Mr3zee in #683

  • KRPC-571: Fix configuration cache misses on every local build by @ai-agent-kxrpc [bot] in #684

  • KRPC-541: Align native shim versions with JVM catalog versions by @ai-agent-kxrpc [bot] in #678

  • KRPC-577: Add .gradle-home to .gitignore for CI Docker cache by @ai-agent-kxrpc [bot] in #685

  • KRPC-573: Remove hardcoded workers.max to scale with CPU cores by @ai-agent-kxrpc [bot] in #687

  • KRPC-572: Enable local Gradle build cache alongside remote Develocity cache by @ai-agent-kxrpc [bot] in #689

  • Add CI polling scripts for fix-issue skill by @Mr3zee in #690

  • KRPC-574: Make BufGenerateTask cacheable by @ai-agent-kxrpc [bot] in #691

  • KRPC-583: Reduce configuration phase overhead from settings plugins by @ai-agent-kxrpc [bot] in #692

  • KRPC-580: Make GenerateBufYaml cacheable by @ai-agent-kxrpc [bot] in #700

  • KRPC-595: Make BufGenerateTask actually cacheable (remove overlapping outputs) by @ai-agent-kxrpc [bot] in #704

  • KRPC-596: Make protobuf conformance tasks cacheable by @ai-agent-kxrpc [bot] in #705

Other Changes 🧹

  • KRPC-183 Add little-endian platform guard to native protobuf codec by @Mr3zee in #646

  • Add fix-issue skill for autonomous YT issue resolution by @Mr3zee in #652

  • KRPC-568: Skip testCancelServer on wasmWasi due to EAGAIN flakiness by @ai-agent-kxrpc [bot] in #677

  • KRPC-584: Skip testClientCancellationCancelsStream on wasmWasi (flaky) by @Mr3zee in #693

  • Varoius fixes to AI automation by @Mr3zee in #698

  • Update commit requirements by @Mr3zee in #701

  • fix bot-pr-title.yml and skill by @Mr3zee in #706

New Contributors

0.11.0-grpc-187

Full Changelog: 0.11.0-grpc-186...0.11.0-grpc-187

Bug fixes 🐛

  • pb: Add this qualifier for fields in generated hashCode methods by @Jozott00 in #642

Infra 🚧

Other Changes 🧹

  • Added AI guidelines for ... everything? (#640, KRPC-530, KRPC-529) by @Mr3zee in #640

  • Updated Yarn deps for Kotlin/Js/Wasm by @Mr3zee in #641

0.11.0-grpc-186

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

Features 🎉

  • pb: Use ByteString for bytes field instead of ByteArray by @Jozott00 in #621

  • pb: Use static defaults for generated protobuf messages (KRPC-520) by @Jozott00 in #629

Bug fixes 🐛

  • protoc-gen: fix star imports issue by @Mr3zee in #624

  • Fix dokka CC issues and xcode on CI by @Mr3zee in #637

  • KRPC-522 Build is broken for AGP projects by @Mr3zee in #636

Documentation 📗

Infra 🚧

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 🎉

Bug fixes 🐛

Documentation 📗

Infra 🚧

Other Changes 🧹

0.10.2

Full Changelog: 0.10.1...0.10.2

Features 🎉

Bug fixes 🐛

Infra 🚧

Other Changes 🧹

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 🚧

New Contributors

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 🎉

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 📗

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

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 📗

Infra 🚧

Other Changes 🧹

0.8.1

Full Changelog: 0.8.0...0.8.1

Bug fixes 🐛

Documentation 📗

Infra 🚧

Other Changes 🧹

New Contributors

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 🎉

Breaking Changes 🔴

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

Bug fixes 🐛

Documentation 📗

Other Changes 🧹

New Contributors

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 🧹

0.6.2

Full Changelog: 0.6.1...0.6.2

Bug fixes 🐛

0.6.1

Full Changelog: 0.6.0...0.6.1

Bug fixes 🐛

0.6.0

Full Changelog: 0.5.1...0.6.0

Features 🎉

Documentation 📗

Infra 🚧

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 🎉

Documentation 📗

Infra 🚧

Other Changes 🧹

New Contributors

0.5.0

Full Changelog: 0.4.0...0.5.0

Features 🎉

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 ⚠️

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 🎉

Breaking Changes 🔴

Infra 🚧

Bug fixes 🐛

Other Changes 🧹

0.3.0

Full Changelog: 0.2.4...0.3.0

Features 🎉

Breaking Changes 🔴

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 📗

Infra 🚧

Other Changes 🧹

New Contributors

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

New Contributors

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

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

New Contributors

Last modified: 05 May 2026
Migration to 0.2.1