Начало работы с Kotlin/Native

Создание проекта

1. Скачайте и установите последнюю версию IntelliJ IDEA.

2. Клонируйте шаблон проекта: в IntelliJ IDEA выберите Файл | Создать | Проект из системы контроля версий и укажите следующий URL:

   https://github.com/Kotlin/kmp-native-wizard
   

3. Откройте файл gradle/libs.versions.toml — каталог версий зависимостей проекта. Для создания приложений Kotlin/Native вам понадобится плагин Gradle Kotlin Multiplatform, версия которого совпадает с версией Kotlin. Убедитесь, что используете последнюю версию Kotlin:

   [versions]
   kotlin = "2.4.20"
   

4. Следуйте предложению перезагрузить файлы Gradle:

   

Подробнее об этих настройках см. в справочнике по DSL Gradle для Multiplatform.

Сборка и запуск приложения

Откройте файл Main.kt в каталоге src/nativeMain/kotlin/:

• В каталоге src находятся исходные файлы Kotlin.

• Файл Main.kt содержит код, который выводит «Hello, Kotlin/Native!» с помощью функции println().

Нажмите зелёный значок на поле слева от кода, чтобы запустить его:

IntelliJ IDEA запускает код с помощью задачи Gradle и выводит результат на вкладке Запуск:

После первого запуска IDE создаёт соответствующую конфигурацию запуска в верхней части окна:

Вы можете настроить IntelliJ IDEA для автоматической сборки проекта:

1. Перейдите в раздел Настройки | Сборка, выполнение, развёртывание | Компилятор.

2. На странице Компилятор выберите пункт Автоматически собирать проект.

3. Примените изменения.

Теперь, когда вы вносите изменения в файлы классов или сохраняете файл (Ctrl + S/Cmd + S), IntelliJ IDEA автоматически выполняет инкрементальную сборку проекта.

Обновление приложения

Добавим в приложение функцию подсчёта количества букв в вашем имени:

1. Добавьте в файл Main.kt код для чтения введённых данных. Используйте функцию readln(), чтобы прочитать введённое значение и присвоить его переменной name:

   fun main() {
       // Read the input value.
       println("Hello, enter your name:")
       val name = readln()
   }
   

2. Чтобы запустить это приложение с помощью Gradle, укажите System.in в качестве используемого ввода в файле build.gradle.kts и загрузите изменения Gradle:

   kotlin { //... targets.withType<KotlinNativeTarget>().configureEach { binaries { executable { entryPoint = "main" runTaskProvider?.configure { standardInput = System.`in` } } } } //... }

3. Удалите пробелы и подсчитайте буквы:

   • Используйте функцию replace(), чтобы удалить пробелы в имени.

   • Используйте функцию области видимости let, чтобы выполнить функцию в контексте объекта.

   • Используйте шаблон строки, чтобы вставить длину имени в строку: добавьте знак доллара $ и заключите выражение в фигурные скобки — ${it.length}. it — это имя параметра лямбда-выражения по умолчанию.

   fun main() {
       // Read the input value.
       println("Hello, enter your name:")
       val name = readln()
       // Count the letters in the name.
       name.replace(" ", "").let {
           println("Your name contains ${it.length} letters")
       }
   }
   

4. Запустите приложение.

5. Введите своё имя и посмотрите на результат:

   

Теперь подсчитаем только уникальные буквы в вашем имени:

1. Объявите в файле Main.kt новую функцию-расширение .countDistinctCharacters() для String:

   • Преобразуйте имя в нижний регистр с помощью функции .lowercase().

   • Преобразуйте введённую строку в список символов с помощью функции toList().

   • Выберите только уникальные символы в имени с помощью функции distinct().

   • Подсчитайте уникальные символы с помощью функции count().

   fun String.countDistinctCharacters() = lowercase().toList().distinct().count()
   

2. Используйте функцию .countDistinctCharacters(), чтобы подсчитать количество уникальных букв в имени:

   fun String.countDistinctCharacters() = lowercase().toList().distinct().count()
   
   fun main() {
       // Read the input value.
       println("Hello, enter your name:")
       val name = readln()
       // Count the letters in the name.
       name.replace(" ", "").let {
           println("Your name contains ${it.length} letters")
           // Print the number of unique letters.
           println("Your name contains ${it.countDistinctCharacters()} unique letters")
       }
   }
   

3. Запустите приложение.

4. Введите своё имя и посмотрите на результат:

   

Создание файлов проекта

1. Для начала установите совместимую версию Gradle. Сверьтесь с таблицей совместимости, чтобы проверить, с какими доступными версиями Gradle совместим плагин Kotlin Gradle (KGP).

2. Создайте пустой каталог проекта. Внутри него создайте файл build.gradle(.kts) со следующим содержимым:

   // build.gradle.kts
   import org.jetbrains.kotlin.gradle.plugin.mpp.KotlinNativeTarget
   
   plugins {
       kotlin("multiplatform") version "2.4.20"
   }
   
   repositories {
       // Specify the source to download the main bundle
       // Maven Central is used by default
       mavenCentral()
   }
   
   kotlin {
       macosArm64()    // on macOS
       // linuxArm64() // on Linux
       // mingwX64()   // on Windows
   
       targets.withType<KotlinNativeTarget>().configureEach {
           binaries {
               executable()
           }
       }
   }
   
   tasks.withType<Wrapper> {
       gradleVersion = "9.7.0"
       distributionType = Wrapper.DistributionType.BIN
   }
   

   // build.gradle
   import org.jetbrains.kotlin.gradle.plugin.mpp.KotlinNativeTarget
   
   plugins {
       id 'org.jetbrains.kotlin.multiplatform' version '2.4.20'
   }
   
   repositories {
       // Specify the source to download the main bundle
       // Maven Central is used by default
       mavenCentral()
   }
   
   kotlin {
       macosArm64()    // on macOS
       // linuxArm64() // on Linux
       // mingwX64()   // on Windows
   
       targets.withType(KotlinNativeTarget).configureEach {
           binaries {
               executable()
           }
       }
   }
   
   wrapper {
       gradleVersion = '9.7.0'
       distributionType = 'BIN'
   }
   

   Для определения целевых платформ, для которых компилируется код, можно использовать разные имена целей, например macosArm64, iosArm64 linuxArm64 и mingwX64. Имя цели используется для создания путей к исходным файлам и имён задач проекта.

3. Создайте пустой файл settings.gradle(.kts) в каталоге проекта.

4. Создайте каталог src/nativeMain/kotlin и поместите в него файл hello.kt со следующим содержимым:

   fun main() {
       println("Hello, Kotlin/Native!")
   }
   

По соглашению все исходные файлы размещаются в каталогах src/<platform name>[Main|Test]/kotlin, где Main предназначен для исходного кода, а Test — для тестов. В этом случае <platform name> — это native.

Сборка и запуск проекта

1. Выполните из корневого каталога проекта команду сборки <yourTargetName>Binaries для своей целевой платформы, например:

   ./gradlew macosArm64Binaries
   

   Эта команда создаёт каталог build/bin/<yourTargetName> с двумя вложенными каталогами: debugExecutable и releaseExecutable. В них находятся соответствующие двоичные файлы.

   По умолчанию двоичный файл называется так же, как каталог проекта.

2. Чтобы запустить проект, выполните команду build/bin/<yourTargetName>/debugExecutable/<project_name>.kexe для своей целевой платформы, например:

   build/bin/macosArm64/DebugExecutable/hello.kexe
   

Терминал выводит «Hello, Kotlin/Native!».

Открытие проекта в интегрированной среде разработки

Теперь проект можно открыть в любой интегрированной среде разработки с поддержкой Gradle. Если вы используете IntelliJ IDEA:

1. Выберите Файл | Открыть.

2. Выберите каталог проекта и нажмите Открыть. IntelliJ IDEA автоматически определит, является ли проект проектом Kotlin/Native.

Если возникнет проблема с проектом, IntelliJ IDEA покажет сообщение об ошибке на вкладке Сборка.

Загрузка и установка компилятора

Чтобы установить компилятор:

1. Перейдите на страницу выпусков Kotlin на GitHub и прокрутите страницу до раздела Ресурсы.

2. Найдите файл, в названии которого есть kotlin-native, и скачайте файл для своей операционной системы, например kotlin-native-prebuilt-linux-x86_64-2.4.20.tar.gz.

3. Распакуйте архив в выбранный каталог.

4. Откройте файл профиля оболочки и добавьте путь к каталогу компилятора /bin в переменную среды PATH:

   export PATH="/<path to the compiler>/kotlin-native/bin:$PATH"
   

Создание программы

Выберите рабочий каталог и создайте файл с именем hello.kt. Добавьте в него следующий код:

fun main() {
    println("Hello, Kotlin/Native!")
}

Компиляция кода в консоли

Чтобы скомпилировать приложение, выполните следующую команду с помощью скачанного компилятора:

kotlinc-native hello.kt -o hello

Параметр -o задаёт имя выходного файла, поэтому эта команда создаёт двоичный файл hello.kexe в macOS и Linux (а в Windows — hello.exe).

Полный список доступных параметров см. в разделе Параметры компилятора Kotlin.

Запуск программы

Чтобы запустить программу, перейдите в инструменте командной строки в каталог с двоичным файлом и выполните следующую команду:

./hello.kexe

./hello.exe

Приложение выводит «Hello, Kotlin/Native» в стандартный поток вывода.