Lines Matching +full:api +full:- +full:version

3 This document describes the compatibility policy of kotlinx.serialization library since version 1.0…
6 since other experimental platforms currently do not impose any backward-compatibility guarantees.
7 …e stable on [this page](https://kotlinlang.org/docs/reference/evolution/components-stability.html).
9 - [Core library compatibility](#core-library-compatibility)
10   * [General (Stable) API](#stable-api)
11   * [Experimental API](#experimental-api)
12   * [Internal API](#internal-api)
13 - [Compatibility with Kotlin compiler plugin](#compatibility-with-kotlin-compiler-plugin)
17 Core library public API comes in three flavours: general (stable), experimental, and internal.
18 All public API except stable is marked with the corresponding annotation.
19 …quire opt-in, please refer to [corresponding documentation page](https://kotlinlang.org/docs/refer…
21 ### Stable API
23 Stable API is guaranteed to preserve its ABI and documented semantics:
26 * It is binary backwards-compatible: during update of `kotlinx.serialization` version, previously c…
27     For example, for a library that depends only on `kotlinx.serialization` stable API,
28 …clients of the library can easily depend on a next `kotlinx.serialization` version and expect ever…
29 * It is source backwards compatible modulo major deprecation. Most of the API is here to stay forev…
30 … or design flaw is exposed. Minor releases never add source-incompatible changes to the stable API.
34 When API is deprecated, it goes through multiple stages and there is at least one major release bet…
37 …or hidden. It is no longer possible to compile new code against deprecated API, though it is still…
38 3. API is completely removed. While we give our best efforts not to do so and have no plans of remo…
41 ### Experimental API
43 …API marked as `@ExperimentalSerializationApi`. API is marked experimental when its design has pote…
44 …API is marked as experimental and becomes stable in one of the next releases if no new issues aris…
46 However, we'll try to provide best-effort compatibility — such declarations won't be deleted or cha…
51 * Experimental API can be used in your applications if maintenance cost is clear: 
54 * Experimental API can be used in other **experimental** API (for example, a custom serialization f…
55 In such cases, clients of the API have to be aware about experimentality.
57 * It's not recommended to use it as a dependency in your **stable** API, even as an implementation …
59 or runtime exceptions when an unexpected version of `kotlinx.serialization` gets included in the ru…
61 ### Internal API
63 This API is marked with `@InternalSerializationApi` or located in `kotlinx.serialization.internal` …
67 However, if you have a rare use-case that can be solved only with internal API, it is possible to u…
68 In such a case, please create an issue on GitHub in order for us to understand a use-case and to pr…
79 It means that it is possible to freely update Kotlin version in a project without changing the code
85 it would require a corresponding runtime version higher than `1.0.0`.
91 …g serialization runtime from `1.x` to `1.y` requires an update of Kotlin version from `1.4.0` to `…
92 … can detect such problems and will inform you if its version is incompatible with a current versio…