Что нового в Kotlin 1.8.0

Возможность не генерировать цели аннотаций TYPE_USE и TYPE_PARAMETER

Если Kotlin аннотация имеет TYPE среди своих Kotlin целей, то аннотация отображается на java.lang.annotation.ElementType.TYPE_USE в списке целей Java аннотаций. Это аналогично тому, как TYPE_PARAMETER Kotlin цель отображается на java.lang.annotation.ElementType.TYPE_PARAMETER Java цель. Это проблема для Android клиентов с API уровнями меньше 26, у которых нет этих целей в API.

Начиная с Kotlin 1.8.0, вы можете использовать новый параметр компилятора -Xno-new-java-annotation-targets чтобы избежать генерации целей аннотаций TYPE_USE и TYPE_PARAMETER.

Новый компиляторный параметр для отключения оптимизаций

Kotlin 1.8.0 добавляет новый -Xdebug компиляторный параметр, который отключает оптимизации для лучшего опыта отладки. Пока что параметр отключает функцию «была оптимизирована» для корутин. В будущем, после добавления других оптимизаций, этот параметр также отключит их.

Функция «была оптимизирована» оптимизирует переменные при использовании suspend функций. Однако отладка кода с оптимизированными переменными затруднена, потому что вы не видите их значения.

Удаление старого бэкэнда

В Kotlin 1.5.0 мы объявили, что IR-бэкэнд стал стабильным. Это означало, что старый бэкэнд из Kotlin 1.4.* был устаревшим. В Kotlin 1.8.0 мы полностью удалили старый бэкэнд. Соответственно, мы удалили компиляторный параметр -Xuse-old-backend и параметр Gradle useOldBackend.

Поддержка аннотации Lombok @Builder

Сообщество добавило много голосов за запрос YouTrack Kotlin Lombok: Поддержка сгенерированных билдеров (@Builder), поэтому мы просто добавили поддержку @аннотации Builder.

Пока нет планов по поддержке @SuperBuilder или @Tolerate аннотаций, но мы пересмотрим этот вопрос, если за запросы @SuperBuilder и @Tolerate будет достаточно голосов.

Узнайте, как настроить плагин Lombok для компилятора.

Поддержка Xcode 14.1

Компилятор Kotlin/Native теперь поддерживает последнюю стабильную версию Xcode, 14.1. Улучшения совместимости включают следующие изменения:

• Добавлен новый watchosDeviceArm64 пресет для целевой платформы watchOS, который поддерживает Apple watchOS на платформах ARM64.

• Плагин Kotlin CocoaPods Gradle больше не включает встраивание bitcode для фреймворков Apple по умолчанию.

• Библиотеки платформы были обновлены в соответствии с изменениями в Objective-C фреймворках для целей Apple.

Улучшенная межплатформенная совместимость с Objective-C/Swift

Для повышения совместимости Kotlin с Objective-C и Swift были добавлены три новые аннотации:

• @ObjCName позволяет указать более удобочитаемое имя на Swift или Objective-C вместо переименования объявления Kotlin.

  Аннотация указывает компилятору Kotlin использовать пользовательское имя Objective-C и Swift для этого класса, свойства, параметра или функции:

  @ObjCName(swiftName = "MySwiftArray")
  class MyKotlinArray {
      @ObjCName("index")
      fun indexOf(@ObjCName("of") element: String): Int = TODO()
  }
  
  // Usage with the ObjCName annotations
  let array = MySwiftArray()
  let index = array.index(of: "element")
  

• @HiddenFromObjC позволяет скрыть объявление Kotlin от Objective-C.

  Аннотация указывает компилятору Kotlin не экспортировать функцию или свойство в Objective-C и, следовательно, в Swift. Это может сделать ваш код Kotlin более дружественным для Objective-C/Swift.

• @ShouldRefineInSwift полезна для замены объявления Kotlin на обертку, написанную на Swift.

  Аннотация указывает компилятору Kotlin отметить функцию или свойство как swift_private в сгенерированном API Objective-C. Такие объявления получают префикс __, делая их невидимыми для Swift-кода.

  Вы по-прежнему можете использовать эти объявления в коде Swift для создания дружественного к Swift API, но они не будут предлагаться автодополнением Xcode, например.

  Дополнительную информацию об уточнении объявлений Objective-C в Swift см. в официальной документации Apple.

Команда Kotlin выражает огромную благодарность Рику Клефасу за реализацию этих аннотаций.

Динамические фреймворки по умолчанию в плагине CocoaPods Gradle

Начиная с Kotlin 1.8.0, Kotlin фреймворки, зарегистрированные плагином CocoaPods Gradle, по умолчанию подключаются динамически. Предыдущая статическая реализация была несовместима с поведением плагина Kotlin Gradle.

kotlin {
    cocoapods {
        framework {
            baseName = "MyFramework"
            isStatic = false // Now dynamic by default
        }
    }
}

Если у вас есть существующий проект со статическим типом подключения, и вы обновляетесь до Kotlin 1.8.0 (или явно меняете тип подключения), вы можете столкнуться с ошибкой при выполнении проекта. Для исправления закройте проект Xcode и выполните pod install в каталоге Podfile.

Дополнительную информацию см. в справке по языку DSL плагина CocoaPods Gradle.

Схема именования KotlinSourceSet

{AndroidSourceSet.name} отображается на {KotlinSourceSet.name} следующим образом:

SourceDirectories

{AndroidSourceSet.name} отображается на {SourceDirectories included} следующим образом:

Расположение файла AndroidManifest.xml

{AndroidSourceSet.name} отображается на {AndroidManifest.xml location} следующим образом:

Конфигурация и настройка

Новая структура станет стандартной в будущих выпусках. Вы можете включить её сейчас с помощью следующего параметра Gradle:

kotlin.mpp.androidSourceSetLayoutVersion=2

Использование предыдущих директорий в стиле Android теперь не рекомендуется. Kotlin 1.8.0 знаменует начало процесса устаревания, выводя предупреждение о текущей структуре. Вы можете подавить предупреждение с помощью следующей свойства Gradle:

kotlin.mpp.androidSourceSetLayoutVersion1.nowarn=true

Стабильный бэкенд компилятора JS IR

Начиная с этого релиза, бэкенд компилятора Kotlin/JS промежуточного представления (IR-основанного) является стабильным. Потребовалось время для унификации инфраструктуры для всех трех бэкендов, но теперь они работают с тем же IR для кода Kotlin.

Вследствие стабильного бэкенда компилятора JS IR, предыдущий теперь устарел.

Инкрементная компиляция включена по умолчанию вместе со стабильным компилятором JS IR.

Если вы всё ещё используете старый компилятор, переключите свой проект на новый бэкенд с помощью нашего руководства по миграции.

Новые настройки для сообщения об обновлении yarn.lock

Если вы используете менеджер пакетов yarn, есть три новых специальных настройки Gradle, которые могут уведомлять вас, если файл yarn.lock был обновлён. Вы можете использовать эти настройки, когда хотите быть уведомлёнными, если yarn.lock был изменён незаметно во время процесса сборки CI.

Эти три новых свойства Gradle:

• YarnLockMismatchReport, которое определяет, как сообщения об изменениях в файле yarn.lock выводятся. Вы можете использовать одно из следующих значений:

  • FAIL приводит к провалу соответствующей задачи Gradle. Это значение по умолчанию.

  • WARNING записывает информацию об изменениях в журнале предупреждений.

  • NONE отключает сообщения.

• reportNewYarnLock, которое явно сообщает об недавно созданном файле yarn.lock. По умолчанию этот параметр отключён: обычно новый файл yarn.lock генерируется при первом запуске. Вы можете использовать этот параметр, чтобы убедиться, что файл добавлен в ваш репозиторий.

• yarnLockAutoReplace, который автоматически заменяет yarn.lock каждый раз, когда запускается задача Gradle.

Чтобы использовать эти параметры, обновите свой файл скрипта сборки build.gradle.kts следующим образом:

import org.jetbrains.kotlin.gradle.targets.js.yarn.YarnLockMismatchReport
import org.jetbrains.kotlin.gradle.targets.js.yarn.YarnRootExtension

rootProject.plugins.withType(org.jetbrains.kotlin.gradle.targets.js.yarn.YarnPlugin::class.java) {
    rootProject.the<YarnRootExtension>().yarnLockMismatchReport =
        YarnLockMismatchReport.WARNING // NONE | FAIL
    rootProject.the<YarnRootExtension>().reportNewYarnLock = false // true
    rootProject.the<YarnRootExtension>().yarnLockAutoReplace = false // true
}

Добавление целей тестирования для браузеров через свойства Gradle

Начиная с Kotlin 1.8.0, вы можете задавать цели тестирования для разных браузеров прямо в файле свойств Gradle. Это сокращает размер файла скрипта сборки, поскольку вам больше не нужно писать все цели в build.gradle.kts.

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

Например, следующая строка в вашем файле свойств Gradle запустит тесты в Firefox и Safari для всех модулей:

kotlin.js.browser.karma.browsers=firefox,safari

См. полный список доступных значений для свойства на GitHub.

Команда Kotlin выражает огромную благодарность Martynas Petuška за реализацию этой функции.

Новый подход к добавлению поддержки CSS в ваш проект

В этом релизе представлен новый подход к добавлению поддержки CSS в ваш проект. Мы предполагаем, что это затронет множество проектов, поэтому не забудьте обновить ваши файлы скриптов сборки Gradle, как описано ниже.

Перед Kotlin 1.8.0, для добавления поддержки CSS использовалось свойство cssSupport.enabled.

cssSupport.enabled = true

Теперь вы должны использовать метод enabled.set() в блоке cssSupport{}.

cssSupport {
    enabled.set(true)
}

Обновлённая целевая версия JVM для компиляции

В Kotlin 1.8.0 стандартные библиотеки (kotlin-stdlib, kotlin-reflect, и kotlin-script-*) скомпилированы с целевой версией JVM 1.8. Ранее стандартные библиотеки компилировались с целевой версией JVM 1.6.

Kotlin 1.8.0 больше не поддерживает целевые версии JVM 1.6 и 1.7. В результате, вам больше не нужно объявлять kotlin-stdlib-jdk7 и kotlin-stdlib-jdk8 отдельно в скриптах сборки, так как содержимое этих артефактов объединено в kotlin-stdlib.

Обратите внимание, что смешивание разных версий артефактов stdlib может привести к дублированию классов или отсутствию необходимых. Для предотвращения этого плагин Kotlin Gradle поможет вам выровнять версии stdlib.

cbrt()

Функция cbrt(), позволяющая вычислить действительный кубический корень из double или float, теперь стабильна.

import kotlin.math.*

fun main() {
    val num = 27
    val negNum = -num

    println("The cube root of ${num.toDouble()} is: " + 
            cbrt(num.toDouble()))
    println("The cube root of ${negNum.toDouble()} is: " + 
            cbrt(negNum.toDouble()))
}

Преобразование единиц времени между Java и Kotlin

Функции toTimeUnit() и toDurationUnit() в kotlin.time теперь стабильны. Введённые как экспериментальные в Kotlin 1.6.0, эти функции улучшают межплатформенную совместимость Kotlin и Java. Теперь вы можете легко преобразовывать между Java java.util.concurrent.TimeUnit и Kotlin kotlin.time.DurationUnit. Эти функции поддерживаются только на JVM.

import kotlin.time.*

// For use from Java
fun wait(timeout: Long, unit: TimeUnit) {
    val duration: Duration = timeout.toDuration(unit.toDurationUnit())
    ...
}

Сравнимые и вычитаемые отметки времени

До Kotlin 1.8.0, если вы хотели вычислить разницу во времени между несколькими TimeMarks и текущим моментом, вы могли вызывать elapsedNow() только для одной TimeMark за раз. Это затрудняло сравнение результатов, так как два вызова функции elapsedNow() не могли быть выполнены точно в одно и то же время.

Для решения этой проблемы, в Kotlin 1.8.0 вы можете вычитать и сравнивать TimeMarks из одного и того же источника времени. Теперь вы можете создать новый экземпляр TimeMark для представления текущего момента и вычитать другие TimeMarks из него. Таким образом, результаты, которые вы получаете от этих вычислений, гарантированно будут относительны друг к другу.

import kotlin.time.*
fun main() {
//sampleStart
    val timeSource = TimeSource.Monotonic
    val mark1 = timeSource.markNow()
    Thread.sleep(500) // Sleep 0.5 seconds
    val mark2 = timeSource.markNow()

    // Before 1.8.0
    repeat(4) { n ->
        val elapsed1 = mark1.elapsedNow()
        val elapsed2 = mark2.elapsedNow()

        // Difference between elapsed1 and elapsed2 can vary depending 
        // on how much time passes between the two elapsedNow() calls
        println("Measurement 1.${n + 1}: elapsed1=$elapsed1, " +
                "elapsed2=$elapsed2, diff=${elapsed1 - elapsed2}")
    }
    println()

    // Since 1.8.0
    repeat(4) { n ->
        val mark3 = timeSource.markNow()
        val elapsed1 = mark3 - mark1
        val elapsed2 = mark3 - mark2

        // Now the elapsed times are calculated relative to mark3, 
        // which is a fixed value
        println("Measurement 2.${n + 1}: elapsed1=$elapsed1, " +
                "elapsed2=$elapsed2, diff=${elapsed1 - elapsed2}")
    }
    // It's also possible to compare time marks with each other
    // This is true, as mark2 was captured later than mark1
    println(mark2 > mark1)
//sampleEnd
}

Эта новая функциональность особенно полезна при расчётах анимации, когда вам нужно вычислить разницу между или сравнить несколько TimeMarks, представляющих разные кадры.

Рекурсивное копирование или удаление каталогов

Мы представили две новые расширяющие функции для java.nio.file.Path, copyToRecursively() и deleteRecursively(), которые позволяют вам рекурсивно:

• Копировать каталог и его содержимое в другое место назначения.

• Удалить каталог и его содержимое.

Эти функции могут быть очень полезными в процессе резервного копирования.

sourceRoot.copyToRecursively(destinationRoot, followLinks = false, 
    onError = { source, target, exception ->
        logger.logError(exception, "Failed to copy $source to $target")
        OnErrorResult.TERMINATE
    })

fun setUpEnvironment(projectDirectory: Path, fixtureName: String) {
    fixturesRoot.resolve(COMMON_FIXTURE_NAME)
        .copyToRecursively(projectDirectory, followLinks = false)
    fixturesRoot.resolve(fixtureName)
        .copyToRecursively(projectDirectory, followLinks = false, 
          overwrite = true) // patches the common fixture
}

sourceRoot.copyToRecursively(destinationRoot, followLinks = false) { source, target ->
    if (source.name.startsWith(".")) {
        CopyActionResult.SKIP_SUBTREE
    } else {
        source.copyToIgnoringExistingDirectory(target, followLinks = false)
        CopyActionResult.CONTINUE
    }
}

Расширяющие функции для Java Optional

Расширяющие функции, введённые в Kotlin 1.7.0, теперь стабильны. Эти функции упрощают работу с классами Optional в Java. Они могут быть использованы для разворачивания и преобразования Optional объектов на JVM и для повышения лаконичности при работе с Java API. Для получения дополнительной информации, см. Что нового в Kotlin 1.7.0.

Улучшенная производительность kotlin-reflect

Используя тот факт, что kotlin-reflect теперь компилируется с целевой версией JVM 1.8, мы мигрировали нашу внутреннюю механизм кэширования на Java ClassValue. Раньше мы кэшировали только KClass, но теперь также кэшируем KType и KDeclarationContainer. Эти изменения привели к значительному улучшению производительности при вызове typeOf().

Переработанные и новые страницы

• Обзор Gradle – узнайте, как настроить и собрать проект Kotlin с помощью системы сборки Gradle, доступные опции компилятора, компиляция и кэширование в плагине Kotlin Gradle.

• Обязательность в Java и Kotlin – ознакомьтесь с различиями между подходами Java и Kotlin к обработке потенциально нулевых переменных.

• Руководство по Lincheck – узнайте, как настроить и использовать фреймворк Lincheck для тестирования конкурирующих алгоритмов на JVM.

Новые и обновлённые учебные пособия

• Начало работы с Gradle и Kotlin/JVM – создание консольного приложения с использованием IntelliJ IDEA и Gradle.

• Создание многоплатформенного приложения с помощью Ktor и SQLDelight – создание мобильного приложения для iOS и Android с использованием Kotlin Multiplatform Mobile.

• Начало работы с Kotlin Multiplatform Mobile – ознакомьтесь с кроссплатформенной мобильной разработкой с помощью Kotlin и создайте приложение, работающее как на Android, так и на iOS.