🏝 Как делать минималистичный API интерфейс с помощью extension fun

При разработке библиотек на Kotlin одним из элегантных решений является подход, знакомый многим по Flow из Coroutines. Его суть в том, что интерфейс содержит только базовый, фундаментальный метод, а все остальные операторы реализованы как функции-расширения.

Например, интерфейс Flow из Kotlin выглядит так:

interface Flow<out T> {
    suspend fun collect(collector: FlowCollector<T>)
}

fun interface FlowCollector<in T> {
    suspend fun emit(value: T)
}

Почему это хороший подход?
👉 Минимализм и ясность интерфейса. Один метод в интерфейсе ясно показывает суть контракта, облегчает понимание и поддержку.
👉 Гибкость расширения API. Можно добавлять бесконечное количество новых операторов без изменения интерфейса и нарушения обратной совместимости.
👉 Удобство и читаемость. Цепочки вызовов выглядят компактно, легко читаемы и следуют единому стилю, принятому в Kotlin.

Плюсы подхода
✅ Простое масштабирование библиотеки, благодаря гибкости Kotlin Extension-функций.
✅ Лёгкость в написании и поддержке тестов, так как расширения можно тестировать отдельно.
✅ Улучшение читаемости клиентского кода благодаря последовательной и понятной структуре вызовов.
✅ Простые и понятные API интерфейсов в типах

Минусы подхода
⚠️ Сложность в управлении видимостью и областью применения расширений. Пользователь может запутаться в большом количестве операторов.
⚠️ Ограничение на возможность переопределения методов. Расширения не переопределяются, что может осложнить кастомизацию.

Когда лучше использовать методы интерфейса вместо расширений?
Обычно в интерфейс стоит помещать:
👉 Фундаментальные методы, которые описывают самую суть интерфейса.
👉 Методы, для которых критично переопределение и которые могут требовать разных реализаций в разных имплементациях.
👉 Функции, критичные к производительности, так как их реализация через расширения иногда менее эффективна.

Когда методы стоит делать как расширения
Явными кандидатами для функций через расширения к интерфейсу - те что имеют реализацию по умолчанию и просто вызывают другие функции этого же интерфейса

interface Container {

   val childCount: Int

   // ❌ Не имеет смысла как функция интерфейса
   fun isEmpty(): Boolean = childCount == 0
}

// ✅ Дополнительное расширение, которое не нужно как часть API интерфейса
fun Container.isEmpty(): Boolean = childCount == 0

💬 Делитесь в комментариях используете ли вы такой подход при проектирование API

#kotlin

🏝 Обновили Kotlin Roadmap (февраль 2025)

Ключевые приоритеты разработки:
👉 Развитие возможностей языка: более высокие абстракции, лучшая производительность, более чистый код, повышение эффективности обработки данных.
👉 Kotlin Multiplatform: релиз "Kotlin to Swift Export", упрощение настройки проектов и создание KMP библиотек.
👉 Улучшение опыта сторонних контрибьюторов в экосистеме Kotlin.

#kotlin

🏝 Приоритеты развития Kotlin Compiler:

🆕 Финализация поддержки JSpecify (подробности здесь)
🆕 Завершение поддержки компилятора K1. Переносится в категорию "Deprecated"
🆕 Перевод Kotlin/Wasm (wasm-js) в Beta

Kotlin/Wasm:
⛏️ Переключение таргета wasm-wasi в библиотеках на WASI Preview 2
⛏️ Поддержка компонентной модели

#kotlin #wasm #k1

🐘 Планируемые улучшения в Gradle при работе с 🏝 Kotlin

👉 Поддержка Gradle Project Isolation (подробнее об этой функции здесь)
👉 Улучшение отчетов по компиляции Kotlin
👉 Поддержка Declarative Gradle
👉 Улучшение интеграции инструментов Kotlin/Native в Gradle
👉 Выпуск стабильных аргументов компилятора в Gradle DSL для упрощения конфигурации проектов на Kotlin и KMP

#kotlin #gradle

🏝 Настройка Fastlane для KMP проекта с Android и iOS

#kotlin #kmp #ci

🏝 Вышел Kotlin 2.1.20

JetBrains представила новую версию языка программирования Kotlin 2.1.20. В этом обновлении:
👉 Новый плагин компилятора kapt на основе K2 по умолчанию (обещают ускорение работы)
🧪 Kotlin Multiplatform: Новый DSL для замены плагина Application в мультиплатформенных проектах.
🧪 Kotlin/Native: Оптимизация инлайнинга для повышения производительности (нужно включение через опцию компилятора)
👉 Kotlin/Wasm: Пользовательские форматтеры теперь включены по умолчанию в дев сборках.
🐘 Поддержка Gradle: Возможность добавления пользовательских вариантов публикации в мультиплатформенных и JVM проектах.
🐘 Экспериментальная поддержка Gradle Isolated Project
👉 Стандартная библиотека: Введение common атомарных типов, улучшенная поддержка UUID и новая функциональность для отслеживания времени.

#kotlin #kmp #k2

🏝 Вышла KSP для Kotlin 2.1.20. Обновляйте версию до 2.1.20-1.0.31

#kotlin #ksp

Что нового в UUID из Kotlin Standart Library

UUID (Universally Unique Identifier) – это стандарт для генерации уникальных идентификаторов длиной 128 бит, который широко используется для идентификации объектов в распределенных системах.

🏝 Теперь функция Uuid.parse() поддерживает не только привычный формат с дефисами (hex-and-dash), например, 550e8400-e29b-41d4-a716-446655440000, но и простой шестнадцатеричный формат без дефисов, например, 550e8400e29b41d4a716446655440000.

🏝 Появились явные функции для работы с hex-and-dash форматом:
parseHexDash() – парсинг UUID из формата с дефисами.
toHexDashString() – преобразование UUID в строку с дефисами.

🏝 UUID теперь реализует интерфейс Comparable. Это значит, что UUID можно напрямую сравнивать и сортировать, используя операторы <, > и стандартные функции вроде sorted().

⚠️ Не забывайте, поддержка UUID в стандартной библиотеке пока экспериментальная. Для её использования используйте:

@OptIn(ExperimentalUuidApi::class)
fun main() {
    val uuid = Uuid.parse("550e8400e29b41d4a716446655440000")
    println(uuid.toHexDashString())

    val sortedUuids = listOf(
        uuid,
        Uuid.parse("780e8400e29b41d4a716446655440005"),
        Uuid.parse("5ab88400e29b41d4a716446655440076")
    ).sorted()

    println(sortedUuids)
}

#kotlin

🏝 Как в Kotlin Multiplatform открыть ссылку в системном браузере

// Kotlin Common Code
expect fun openInBrowser(
         url: String, 
         completionHandler: (Boolean) -> Unit = {}
)

// Kotlin iOS Common
actual fun openInBrowser(
     url: String,
     completionHandler: (Boolean) -> Unit
) {
  NSURL.URLWithString(url)?.let {
    UIApplication.sharedApplication.openURL(
      url = it, 
      options = emptyMap<Any?, Any>(),
      completionHandler = completionHandler
    )
  }
}

actual fun openInBrowser(
     url: String,
     completionHandler: (Boolean) -> Unit
) {
  val result = try {
    context.startActivity(
      Intent(Intent.ACTION_VIEW, Uri.parse(url))
            .addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
    true
  } catch (_: ActivityNotFoundException) {
    false
  }
  completionHandler(result)
}

// Kotlin JVM Desktop Common
actual fun openInBrowser(
     url: String,
     completionHandler: (Boolean) -> Unit
) {
  with(Desktop.getDesktop()) {
    val result = if (isSupported(Desktop.Action.BROWSE)) {
      try {
        browse(URI.create(url))
        true
      } catch (e: IOException) {
        false
      } catch (e: SecurityException) {
        false
      }
    } else false
    completionHandler(result)
  }
}

Источник тут

#kmp #kotlin

💉 Вышел Koin 4.0.4 с исправлениями багов и пометили Deprecated методы, нерекомендуемые для использования

#kotlin #di #koin

📹 Using Platform-Specific APIs in KMP Apps (12м)

Хотите узнать, как использовать платформозависимые API в своих приложениях Kotlin Multiplatform (KMP) или запутались в связанных с этим лучших практиках?

В этом видео мы расскажует об использования механизма expect/actual для создания отличных приложений на KMP.

#kmp #kotlin #jetbrains