نماذج البيانات @Serializable

APIs speak JSON, but your shared code wants Kotlin objects. kotlinx.serialization bridges that gap on every KMP target.

Unlike reflection-based parsers, this library generates code at compile time, so it works fast and predictably on Android and iOS.

You tag a data class with @Serializable and the compiler writes a serializer for it automatically.

The annotation only works once you apply the kotlin-serialization Gradle plugin to your shared module.

You also need the JSON runtime dependency in commonMain so the generated code has something to call.

Turn a model into JSON text with Json.encodeToString, ready to send over the network.

Going the other way, decodeToString's partner reads JSON text back into a typed Kotlin object.

By default each property name becomes the matching JSON key, so id and name map straight across with no extra config.

If a serializable class holds another serializable class, the whole nested tree serializes together with no manual wiring.

Primitives, strings, lists, maps and other serializable classes are all supported, which covers most real API payloads you will meet.

Because the serializer is generated Kotlin, the exact same parsing logic runs on every target with no platform-specific code.

What does the @Serializable annotation actually trigger?

Tag models with @Serializable, add the plugin and runtime, then use Json.encodeToString and decodeFromString to move between objects and JSON.