Как Kotlin Multiplatform использует `expect` и `actual` декларации для реализации платформ-специфичного кода, при этом сохраняя общую кодовую базу?

Обзор

В Kotlin Multiplatform механизм expect/actual позволяет определить единый общий API, делегируя платформо-специфичное поведение каждой целевой платформе.

Декларация expect

Ключевое слово expect размещается в общем коде и действует как контракт — оно объявляет, что функция, класс или свойство существует, но не предоставляет никакой реализации:

Декларация actual

Каждый платформо-специфичный набор исходников должен предоставить соответствующую декларацию actual, которая выполняет контракт конкретной реализацией:

Ключевые преимущества

• Типобезопасность — компилятор гарантирует, что каждая декларация expect имеет соответствующую actual на всех настроенных платформах
• Переиспользование кода — бизнес-логика остаётся в общем коде, а платформо-специфичные детали вынесены отдельно
• Гибкость — работает с функциями, классами, интерфейсами и даже аннотациями

Важные правила

• Каждая декларация expect должна иметь соответствующую actual на каждой целевой платформе, иначе сборка сломается
• Сигнатура actual должна точно совпадать с сигнатурой expect
• Реализации actual могут внутри себя использовать нативные платформенные API (например, Android SDK или iOS Foundation)