Что нового в Kotlin 1.5.20

Конкатенация строк с помощью invokedynamic

Kotlin 1.5.20 компилирует конкатенацию строк в динамические вызовы (invokedynamic) на целевых платформах JVM 9+, тем самым поддерживая современные версии Java. Более точно, используется StringConcatFactory.makeConcatWithConstants() для конкатенации строк.

Чтобы переключиться на конкатенацию через StringBuilder.append(), используемую в предыдущих версиях, добавьте опцию компилятора -Xstring-concat=inline.

Узнайте, как добавлять опции компилятора в Gradle, Maven и компиляторе командной строки.

Поддержка аннотаций JSpecify для нулевых значений

Компилятор Kotlin может читать различные типы аннотаций для нулевых значений, чтобы передавать информацию о нулевых значениях от Java к Kotlin. Версия 1.5.20 добавляет поддержку проекта JSpecify, который включает стандартный объединенный набор аннотаций Java для нулевых значений.

С помощью JSpecify вы можете предоставить более подробную информацию о нулевых значениях, чтобы помочь Kotlin поддерживать межплатформенную безопасность для работы с нулевыми значениями в Java. Вы можете задать значения по умолчанию для объявления, пакета или области модуля, указать параметрическую нулевость и многое другое. Более подробную информацию об этом можно найти в руководстве пользователя JSpecify.

Вот пример того, как Kotlin может обрабатывать аннотации JSpecify:

// JavaClass.java
import org.jspecify.nullness.*;

@NullMarked
public class JavaClass {
  public String notNullableString() { return ""; }
  public @Nullable String nullableString() { return ""; }
}

// Test.kt
fun kotlinFun() = with(JavaClass()) {
  notNullableString().length // OK
  nullableString().length    // Warning: receiver nullability mismatch
}

В 1.5.20 все несовпадения нулевых значений в соответствии с предоставленной JSpecify информацией о нулевых значениях будут сообщаться как предупреждения. Используйте опции компилятора -Xjspecify-annotations=strict и -Xtype-enhancement-improvements-strict-mode для активации строгого режима (с сообщением об ошибках) при работе с JSpecify. Обратите внимание, что проект JSpecify находится в активной разработке. Его API и реализация могут значительно меняться в любое время.

Дополнительная информация о безопасности нулевых значений и типах платформы.

Поддержка вызова методов, сгенерированных Lombok для Java, в модулях, содержащих Kotlin и Java код

Kotlin 1.5.20 добавляет экспериментальный плагин Lombok для компилятора. Этот плагин позволяет генерировать и использовать объявления Java Lombok в модулях, содержащих Kotlin и Java код. Аннотации Lombok работают только в Java-источниках и игнорируются, если вы используете их в Kotlin-коде.

Плагин поддерживает следующие аннотации:

• @Getter, @Setter

• @NoArgsConstructor, @RequiredArgsConstructor, и @AllArgsConstructor

• @Data

• @With

• @Value

Мы продолжаем работать над этим плагином. Чтобы узнать подробное текущее состояние, посетите README плагина Lombok для компилятора.

В настоящее время у нас нет планов по поддержке аннотации @Builder. Однако, мы можем рассмотреть этот вопрос, если вы проголосуете за @Builder в YouTrack.

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

Включение экспорта комментариев KDoc в сгенерированные заголовки Objective-C

Теперь вы можете настроить компилятор Kotlin/Native на экспорт документационных комментариев (KDoc) из Kotlin-кода в сгенерированные Objective-C фреймворки, делая их видимыми для потребителей этих фреймворков.

Например, следующий Kotlin-код с KDoc:

/**
 * Prints the sum of the arguments.
 * Properly handles the case when the sum doesn't fit in 32-bit integer.
 */
fun printSum(a: Int, b: Int) = println(a.toLong() + b)

производит следующие заголовки Objective-C:

/**
 * Prints the sum of the arguments.
 * Properly handles the case when the sum doesn't fit in 32-bit integer.
 */
+ (void)printSumA:(int32_t)a b:(int32_t)b __attribute__((swift_name("printSum(a:b:)")));

Это также хорошо работает с Swift.

Чтобы попробовать эту возможность экспорта комментариев KDoc в заголовки Objective-C, используйте опцию компилятора -Xexport-kdoc. Добавьте следующие строки в build.gradle(.kts) проектов Gradle, из которых вы хотите экспортировать комментарии:

kotlin {
    targets.withType<org.jetbrains.kotlin.gradle.plugin.mpp.KotlinNativeTarget> {
        compilations.get("main").kotlinOptions.freeCompilerArgs += "-Xexport-kdoc"
    }
}

kotlin {
    targets.withType(org.jetbrains.kotlin.gradle.plugin.mpp.KotlinNativeTarget) {
        compilations.get("main").kotlinOptions.freeCompilerArgs += "-Xexport-kdoc"
    }
}

Мы будем очень признательны, если вы поделитесь своими отзывами с нами, используя этот YouTrack-запрос.

Исправления ошибок компилятора

Компилятор Kotlin/Native получил несколько исправлений ошибок в 1.5.20. Полный список можно найти в журнале изменений.

Есть важное исправление, которое затрагивает совместимость: в предыдущих версиях строковые константы, содержащие неправильные UTF замещающие пары, теряли свои значения во время компиляции. Сейчас такие значения сохраняются. Разработчики приложений могут безопасно обновить до 1.5.20 — ничего не сломается. Однако библиотеки, скомпилированные с 1.5.20, несовместимы с более ранними версиями компилятора. Подробности см. в этом вопросе YouTrack.

Улучшенная производительность Array.copyInto() внутри одного массива

Мы улучшили работу Array.copyInto(), когда исходный и целевой массивы — это один и тот же массив. Теперь такие операции выполняются до 20 раз быстрее (в зависимости от количества копируемых объектов) благодаря оптимизациям управления памятью для этого случая.

Руководство по миграции на бекенд JS IR

Новое руководство по миграции на бекенд JS IR определяет потенциальные проблемы, с которыми вы можете столкнуться во время миграции, и предлагает решения для них. Если вы обнаружите какие-либо проблемы, которые не описаны в руководстве, пожалуйста, сообщите об этом в наш отслеживатель задач.

Кэширование загрузчиков классов для процессоров аннотаций в kapt

Теперь появилась новая экспериментальная возможность кэшировать загрузчики классов для процессоров аннотаций в kapt. Это может ускорить работу kapt при последовательных запусках Gradle.

Для включения этой функции используйте следующие свойства в вашем файле gradle.properties.

# positive value will enable caching
# use the same value as the number of modules that use kapt
kapt.classloaders.cache.size=5

# disable for caching to work
kapt.include.compile.classpath=false

Узнайте больше о kapt.

Устаревание свойства kotlin.parallel.tasks.in.project

В этой версии параллельная компиляция Kotlin контролируется флагом параллельного выполнения Gradle --parallel. С помощью этого флага Gradle выполняет задачи параллельно, увеличивая скорость компиляции и более эффективно используя ресурсы.

Вам больше не нужно использовать свойство kotlin.parallel.tasks.in.project. Это свойство устарело и будет удалено в следующей крупной версии.

Поддержка всех символов Unicode в Char.digitToInt() для Kotlin/Native и Kotlin/JS

Char.digitToInt() возвращает числовое значение десятичного разряда, которое представляет символ. До версии 1.5.20 функция поддерживала все символы Unicode для Kotlin/JVM: реализации на платформах Native и JS поддерживали только символы ASCII.

Теперь, как с Kotlin/Native, так и с Kotlin/JS, вы можете вызвать Char.digitToInt() для любого символа Unicode и получить его числовое представление.

fun main() {
//sampleStart
    val ten = '\u0661'.digitToInt() + '\u0039'.digitToInt() // ARABIC-INDIC DIGIT ONE + DIGIT NINE
    println(ten)
//sampleEnd
}

Унификация реализации Char.isLowerCase()/isUpperCase() на разных платформах

Функции Char.isUpperCase() и Char.isLowerCase() возвращают булево значение в зависимости от регистра символа. Для Kotlin/JVM реализация проверяет как General_Category, так и Other_Uppercase/Other_Lowercase, свойства Unicode.

До версии 1.5.20 реализации на других платформах работали по-другому и учитывали только общую категорию. В версии 1.5.20 реализации унифицированы на всех платформах и используют оба свойства для определения регистра символа:

fun main() {
//sampleStart
    val latinCapitalA = 'A' // has "Lu" general category
    val circledLatinCapitalA = 'Ⓐ' // has "Other_Uppercase" property
    println(latinCapitalA.isUpperCase() && circledLatinCapitalA.isUpperCase())
//sampleEnd
}