Что нового в 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 поддерживать безопасность при работе с null в взаимодействии с 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 и реализация могут значительно меняться в любое время.

Узнайте больше о безопасности при работе с null и типах платформы.

Поддержка вызова методов, сгенерированных 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. Полный список можно найти в changelog.

Существует важное исправление, влияющее на совместимость: в предыдущих версиях строковые константы, содержащие неправильные 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 build

С этим выпуском параллельное компилирование 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.

Теперь вы можете вызвать 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
}