Sourced from org.jetbrains.kotlinx:kotlinx-serialization-core-jvm's releases.
1.7.3
This release aims to fix important issues that were discovered in the 1.7.2 release, including the inability to sync certain projects into Android Studio/IntelliJ IDEA and exceptions from custom Uuid serializers.
It uses Kotlin 2.0.20 by default.
- Use explicit kotlin-stdlib and kotlin-test versions from version catalog (#2818)
- Drop usage of deprecated Any?.freeze() in K/N target (#2819)
- Check against serialName instead of simpleClassName (#2802)
- Ignore NoClassDefFoundError when initializing builtins map for serializer() function (#2803)
- Clarify example for SerializationException (#2806)
1.7.2
This release provides several new features, including a major Cbor configuration rework. It uses Kotlin 2.0.20 by default.
Cbor feature set for COSE compliance
This change brings a lot of features to the CBOR format, namely:
- Serial Labels — see
@CborLabel
annotation andpreferCborLabelsOverNames
flag.- Tagging of keys and values — see
encode*Tags
andverify*Tags
set of flags- Definite length encoding — see
useDefiniteLengthEncoding
. This flag affects object encoding, since decoding of arrays with definite lenghts is automatically supported.- Option to globally prefer major type 2 for byte array encoding — see
alwaysUseByteString
flag.Since there are quite a lot of flags now, they were restructured to a separate
CborConfiguration
class, similarly toJsonConfiguration
. It is possible to retrieve this configuration fromCborEncoder/CborDecoder
interfaces in your custom serializers (see their documentation for details).All of these features make it possible to serialize and parse COSE-compliant CBOR, for example, ISO/IEC 18013-5:2021-compliant mobile driving license data. In case you want to make use of them, there is a predefined
Cbor.CoseCompliant
instance. However, some canonicalization steps (such as sorting keys) still need to be performed manually.This functionality was contributed to us by Bernd Prünster and Christian.
Keeping generated serializers
One of the most requested features for serialization plugin was to continue to generate a serializer even if a custom one is specified for the class. It allows using a plugin-generated serializer in a fallback or delegate strategy, accessing type structure via descriptor, using default serialization behavior in inheritors that do not use custom serializers.
Starting with this release, you can specify the
@KeepGeneratedSerializer
annotation on the class declaration to instruct the plugin to continue generating the serializer. In this case, the serializer will be accessible using the.generatedSerializer()
function on the class's companion object.This annotation is currently experimental. Kotlin 2.0.20 or higher is required for this feature to work.
You can check out the examples in the documentation and in the PRs: #2758, #2669.
Serializer for kotlin.uuid.Uuid
Kotlin 2.0.20 added a common class to represent UUIDs in a multiplatform code. kotlinx.serialization 1.7.2 provides a corresponding
Uuid.serializer()
for it, making it possible to use it in@Serializable
classes.Note that for now, serializer should be provided manually with
@Contextual
annotation. Plugin will be able to automatically insertUuid
serializer in Kotlin 2.1.0.See more details in the corresponding PR.
... (truncated)
Sourced from org.jetbrains.kotlinx:kotlinx-serialization-core-jvm's changelog.
1.7.3 / 2024-09-19
This release aims to fix important issues that were discovered in the 1.7.2 release, including the inability to sync certain projects into Android Studio/IntelliJ IDEA and exceptions from custom Uuid serializers.
It uses Kotlin 2.0.20 by default.
- Use explicit kotlin-stdlib and kotlin-test versions from version catalog (#2818)
- Drop usage of deprecated Any?.freeze() in K/N target (#2819)
- Check against serialName instead of simpleClassName (#2802)
- Ignore NoClassDefFoundError when initializing builtins map for serializer() function (#2803)
- Clarify example for SerializationException (#2806)
1.7.2 / 2024-08-28
This release provides several new features, including a major Cbor configuration rework. It uses Kotlin 2.0.20 by default.
Cbor feature set for COSE compliance
This change brings a lot of features to the CBOR format, namely:
- Serial Labels — see
@CborLabel
annotation andpreferCborLabelsOverNames
flag.- Tagging of keys and values — see
encode*Tags
andverify*Tags
set of flags- Definite length encoding — see
useDefiniteLengthEncoding
. This flag affects object encoding, since decoding of arrays with definite lenghts is automatically supported.- Option to globally prefer major type 2 for byte array encoding — see
alwaysUseByteString
flag.Since there are quite a lot of flags now, they were restructured to a separate
CborConfiguration
class, similarly toJsonConfiguration
. It is possible to retrieve this configuration fromCborEncoder/CborDecoder
interfaces in your custom serializers (see their documentation for details).All of these features make it possible to serialize and parse COSE-compliant CBOR, for example, ISO/IEC 18013-5:2021-compliant mobile driving license data. In case you want to make use of them, there is a predefined
Cbor.CoseCompliant
instance. However, some canonicalization steps (such as sorting keys) still need to be performed manually.This functionality was contributed to us by Bernd Prünster.
Keeping generated serializers
One of the most requested features for serialization plugin was to continue to generate a serializer even if a custom one is specified for the class. It allows using a plugin-generated serializer in a fallback or delegate strategy, accessing type structure via descriptor, using default serialization behavior in inheritors that do not use custom serializers.
Starting with this release, you can specify the
@KeepGeneratedSerializer
annotation on the class declaration to instruct the plugin to continue generating the serializer. In this case, the serializer will be accessible using the.generatedSerializer()
function on the class's companion object.This annotation is currently experimental. Kotlin 2.0.20 or higher is required for this feature to work.
You can check out the examples in the documentation and in the PRs: #2758, #2669.
... (truncated)
d4d066d
Prepare 1.7.3 release (#2821)21311a6
Clarify example for SerializationException (#2806)2f1dbdb
Use explicit kotlin-stdlib and kotlin-test versions from version catalog
(#2818)595bcbd
Drop usage of deprecated Any?.freeze() in K/N target (#2819)d9753af
Check against serialName instead of simpleClassName (#2802)0b015e1
Ignore NoClassDefFoundError when initializing builtins map for
serializer() f...8c84a5b
Prepare 1.7.2 release (#2798)b3cfe56
Merge remote-tracking branch 'origin/master' into dev550e1a8
Rework opt-ins in build scripts (#2794)e4fa8a3
Update Annotations.kt, fixed typo: RgpPixel -> RgbPixel (#2793)Sourced from org.jetbrains.kotlinx:kotlinx-serialization-json-jvm's releases.
1.7.3
This release aims to fix important issues that were discovered in the 1.7.2 release, including the inability to sync certain projects into Android Studio/IntelliJ IDEA and exceptions from custom Uuid serializers.
It uses Kotlin 2.0.20 by default.
- Use explicit kotlin-stdlib and kotlin-test versions from version catalog (#2818)
- Drop usage of deprecated Any?.freeze() in K/N target (#2819)
- Check against serialName instead of simpleClassName (#2802)
- Ignore NoClassDefFoundError when initializing builtins map for serializer() function (#2803)
- Clarify example for SerializationException (#2806)
1.7.2
This release provides several new features, including a major Cbor configuration rework. It uses Kotlin 2.0.20 by default.
Cbor feature set for COSE compliance
This change brings a lot of features to the CBOR format, namely:
- Serial Labels — see
@CborLabel
annotation andpreferCborLabelsOverNames
flag.- Tagging of keys and values — see
encode*Tags
andverify*Tags
set of flags- Definite length encoding — see
useDefiniteLengthEncoding
. This flag affects object encoding, since decoding of arrays with definite lenghts is automatically supported.- Option to globally prefer major type 2 for byte array encoding — see
alwaysUseByteString
flag.Since there are quite a lot of flags now, they were restructured to a separate
CborConfiguration
class, similarly toJsonConfiguration
. It is possible to retrieve this configuration fromCborEncoder/CborDecoder
interfaces in your custom serializers (see their documentation for details).All of these features make it possible to serialize and parse COSE-compliant CBOR, for example, ISO/IEC 18013-5:2021-compliant mobile driving license data. In case you want to make use of them, there is a predefined
Cbor.CoseCompliant
instance. However, some canonicalization steps (such as sorting keys) still need to be performed manually.This functionality was contributed to us by Bernd Prünster and Christian.
Keeping generated serializers
One of the most requested features for serialization plugin was to continue to generate a serializer even if a custom one is specified for the class. It allows using a plugin-generated serializer in a fallback or delegate strategy, accessing type structure via descriptor, using default serialization behavior in inheritors that do not use custom serializers.
Starting with this release, you can specify the
@KeepGeneratedSerializer
annotation on the class declaration to instruct the plugin to continue generating the serializer. In this case, the serializer will be accessible using the.generatedSerializer()
function on the class's companion object.This annotation is currently experimental. Kotlin 2.0.20 or higher is required for this feature to work.
You can check out the examples in the documentation and in the PRs: #2758, #2669.
Serializer for kotlin.uuid.Uuid
Kotlin 2.0.20 added a common class to represent UUIDs in a multiplatform code. kotlinx.serialization 1.7.2 provides a corresponding
Uuid.serializer()
for it, making it possible to use it in@Serializable
classes.Note that for now, serializer should be provided manually with
@Contextual
annotation. Plugin will be able to automatically insertUuid
serializer in Kotlin 2.1.0.See more details in the corresponding PR.
... (truncated)
Sourced from org.jetbrains.kotlinx:kotlinx-serialization-json-jvm's changelog.
1.7.3 / 2024-09-19
This release aims to fix important issues that were discovered in the 1.7.2 release, including the inability to sync certain projects into Android Studio/IntelliJ IDEA and exceptions from custom Uuid serializers.
It uses Kotlin 2.0.20 by default.
- Use explicit kotlin-stdlib and kotlin-test versions from version catalog (#2818)
- Drop usage of deprecated Any?.freeze() in K/N target (#2819)
- Check against serialName instead of simpleClassName (#2802)
- Ignore NoClassDefFoundError when initializing builtins map for serializer() function (#2803)
- Clarify example for SerializationException (#2806)
1.7.2 / 2024-08-28
This release provides several new features, including a major Cbor configuration rework. It uses Kotlin 2.0.20 by default.
Cbor feature set for COSE compliance
This change brings a lot of features to the CBOR format, namely:
- Serial Labels — see
@CborLabel
annotation andpreferCborLabelsOverNames
flag.- Tagging of keys and values — see
encode*Tags
andverify*Tags
set of flags- Definite length encoding — see
useDefiniteLengthEncoding
. This flag affects object encoding, since decoding of arrays with definite lenghts is automatically supported.- Option to globally prefer major type 2 for byte array encoding — see
alwaysUseByteString
flag.Since there are quite a lot of flags now, they were restructured to a separate
CborConfiguration
class, similarly toJsonConfiguration
. It is possible to retrieve this configuration fromCborEncoder/CborDecoder
interfaces in your custom serializers (see their documentation for details).All of these features make it possible to serialize and parse COSE-compliant CBOR, for example, ISO/IEC 18013-5:2021-compliant mobile driving license data. In case you want to make use of them, there is a predefined
Cbor.CoseCompliant
instance. However, some canonicalization steps (such as sorting keys) still need to be performed manually.This functionality was contributed to us by Bernd Prünster.
Keeping generated serializers
One of the most requested features for serialization plugin was to continue to generate a serializer even if a custom one is specified for the class. It allows using a plugin-generated serializer in a fallback or delegate strategy, accessing type structure via descriptor, using default serialization behavior in inheritors that do not use custom serializers.
Starting with this release, you can specify the
@KeepGeneratedSerializer
annotation on the class declaration to instruct the plugin to continue generating the serializer. In this case, the serializer will be accessible using the.generatedSerializer()
function on the class's companion object.This annotation is currently experimental. Kotlin 2.0.20 or higher is required for this feature to work.
You can check out the examples in the documentation and in the PRs: #2758, #2669.
... (truncated)
d4d066d
Prepare 1.7.3 release (#2821)21311a6
Clarify example for SerializationException (#2806)2f1dbdb
Use explicit kotlin-stdlib and kotlin-test versions from version catalog
(#2818)595bcbd
Drop usage of deprecated Any?.freeze() in K/N target (#2819)d9753af
Check against serialName instead of simpleClassName (#2802)0b015e1
Ignore NoClassDefFoundError when initializing builtins map for
serializer() f...8c84a5b
Prepare 1.7.2 release (#2798)b3cfe56
Merge remote-tracking branch 'origin/master' into dev550e1a8
Rework opt-ins in build scripts (#2794)e4fa8a3
Update Annotations.kt, fixed typo: RgpPixel -> RgbPixel (#2793)