Зачем нужны expect/actual
Механизм реализации платформенного поведения за единым API
«Зачем нужны expect/actual» — бесплатный урок Kotlin Multiplatform Academy на CoddyKit. Это урок 1 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Kotlin Multiplatform Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Kotlin Multiplatform Academy содержит 4 уроков всего.
Части этого урока еще не переведены и отображаются на английском.
One Codebase, Different Worlds
Most of your Kotlin runs everywhere, but some tasks need each platform's own tools. That gap is exactly what expect/actual was built to close.
The Problem It Solves
Getting the OS version, a file path, or current time relies on Android or iOS APIs that simply do not exist in shared code. You still want to call them from commonMain. 🤔
A Promise and a Fulfillment
Think of expect as a promise: common code declares an API exists. Then each platform fulfills that promise with a real implementation.
The expect Declaration
In commonMain you write a declaration with no body. The expect keyword means the implementation lives elsewhere, per platform.
expect fun platformName(): StringThe actual Implementation
Each target supplies the body with actual. Android returns one value, iOS returns another, but the signature must match exactly.
actual fun platformName(): String = "Android"Common Code Stays Common
Your shared logic just calls the function and never sees the difference. The compiler picks the right actual for each build.
val label = "Running on " + platformName()Not the Same as an Interface
An interface needs an object to implement it at runtime. expect/actual is resolved at compile time, so there is zero runtime cost.
Where Each Piece Lives
The expect goes in commonMain. Every actual lives in its matching source set, like androidMain or iosMain, side by side.
Every Target Must Answer
If you ship to Android and iOS, both need an actual. A missing one is a compile error, not a surprise crash later.
Use It Sparingly
Reach for expect/actual only for the thin layer that truly differs. The more code stays in common, the more you share. ✨
A Bridge, Not a Wall
expect/actual is a clean bridge to native power without splitting your project. You keep one API while each platform speaks its own language.
Quick Check
Let's make sure the core idea landed.
Recap
You learned why expect/actual exists: it lets common code call platform-specific behavior through one API, resolved at compile time with no runtime cost. 🎉
Часто задаваемые вопросы
Урок «Зачем нужны expect/actual» бесплатный?
Да — полный текст урока «Зачем нужны expect/actual» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Kotlin Multiplatform Academy, подпишись на CoddyKit PRO. Курс Kotlin Multiplatform Academy содержит 4 уроков всего.
Чему я научусь в уроке «Зачем нужны expect/actual»?
Механизм реализации платформенного поведения за единым API Ты практикуешь Kotlin Multiplatform Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.
Нужен ли мне опыт, чтобы начать Kotlin Multiplatform Academy?
Предыдущий опыт не требуется. Kotlin Multiplatform Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 1 из 4.
Сколько времени занимает урок «Зачем нужны expect/actual»?
Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.
Можно ли писать и запускать код в этом уроке Kotlin Multiplatform Academy?
Да. Каждый урок Kotlin Multiplatform Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.
Все уроки этого курса
- Зачем нужны expect/actual
- Получение имени платформы для каждой цели
- Классы и свойства expect/actual
- Распространённые ошибки и ошибки компилятора