1+ <?xml version =" 1.0" encoding =" UTF-8" ?>
2+ <!--
3+ - Copyright 2023-2024 JetBrains s.r.o and contributors. Use of this source code is governed by the Apache 2.0 license.
4+ -->
5+
6+ <!DOCTYPE topic
7+ SYSTEM "https://resources.jetbrains.com/writerside/1.0/xhtml-entities.dtd">
8+ <topic xmlns : xsi =" http://www.w3.org/2001/XMLSchema-instance"
9+ xsi : noNamespaceSchemaLocation =" https://resources.jetbrains.com/writerside/1.0/topic.v2.xsd"
10+ title =" Migration to 0.2.4" id =" 0-2-4" >
11+
12+ <p >
13+ Version <code >0.2.4</code > does introduce any breaking changes.
14+ However, it includes some updates that may require additional modifications in user projects.
15+ </p >
16+ <chapter title =" Removal of KSP plugin for Kotlin 2.0" id =" removal-of-ksp-plugin-for-kotlin-2-0" >
17+ If your project uses Kotlin 2.0,
18+ you are no longer required to add KSP Gradle plugin to your build files:
19+ <code-block lang =" kotlin" >
20+ plugins {
21+ kotlin("jvm") version "2.0.10"
22+ kotlin("plugin.serialization") version "2.0.10"
23+ id("org.jetbrains.kotlinx.rpc.plugin") version "0.2.4"
24+
25+ // KSP can be removed
26+ // id("com.google.devtools.ksp") version "2.0.10-1.0.24"
27+ }
28+ </code-block >
29+ This change brings one more benefit:
30+ without KSP, projects that use <code >kotlinx.rpc</code >
31+ can now use <a href =" https://docs.gradle.org/current/userguide/configuration_cache.html" >Gradle configuration
32+ caches</a >.
33+ </chapter >
34+ <chapter title =" Moving of client APIs" id =" moving-of-client-apis" >
35+ Some client APIs were moved from <code >kotlinx-rpc-krpc-client</code > artifact (and package)
36+ into <code >kotlinx-rpc-core</code > module (and package). These APIs are not kRPC specific hence the move.
37+ <p >List of API changes:</p >
38+ <table >
39+ <tr >
40+ <td ><code >0.2.2</code ></td >
41+ <td ><code >0.2.4</code ></td >
42+ </tr >
43+ <tr >
44+ <td ><code >kotlinx.rpc.client.withService</code ></td >
45+ <td ><code >kotlinx.rpc.withService</code ></td >
46+ </tr >
47+ <tr >
48+ <td ><code >kotlinx.rpc.client.awaitFieldInitialization</code ></td >
49+ <td ><code >kotlinx.rpc.awaitFieldInitialization</code ></td >
50+ </tr >
51+ <tr >
52+ <td ><code >kotlinx.rpc.client.UninitializedRPCFieldException</code ></td >
53+ <td ><code >kotlinx.rpc.UninitializedRPCFieldException</code ></td >
54+ </tr >
55+ </table >
56+ Old declaration and marked with <code >@Deprecated(WARNING)</code >
57+ and will be removed in 2 minor releases.
58+ </chapter >
59+ </topic >
0 commit comments