Начало работы с Kotlin/Native с помощью Gradle
Gradle — это система сборки, широко используемая в экосистемах Java, Android и других. Это предпочтительный выбор для Kotlin/Native и Multiplatform в отношении систем сборки.
Хотя большинство IDE, включая IntelliJ IDEA, могут генерировать необходимые файлы Gradle, этот учебник описывает, как создавать их вручную, чтобы обеспечить лучшее понимание принципов работы под капотом.
Для начала установите последнюю версию Gradle.
Создание файлов проекта
-
Создайте директорию проекта. Внутри нее создайте файл сборки Gradle
build.gradleилиbuild.gradle.ktsс указанным ниже содержимым:// build.gradle.kts plugins { kotlin("multiplatform") version "1.8.0" } repositories { mavenCentral() } kotlin { macosX64("native") { // on macOS // linuxX64("native") // on Linux // mingwX64("native") // on Windows binaries { executable() } } } tasks.withType<Wrapper> { gradleVersion = "7.3" distributionType = Wrapper.DistributionType.BIN }// build.gradle plugins { id 'org.jetbrains.kotlin.multiplatform' version '1.8.0' } repositories { mavenCentral() } kotlin { macosX64('native') { // on macOS // linuxX64('native') // on Linux // mingwX64('native') // on Windows binaries { executable() } } } wrapper { gradleVersion = '7.3' distributionType = 'BIN' }Вы можете использовать различные пресеты целевых платформ, такие как
macosX64,mingwX64,linuxX64,iosX64, для определения соответствующей платформы цели. Название пресета описывает платформу, для которой компилируется код. Эти пресеты целевых платформ необязательно принимают имя цели в качестве параметра, которое в данном случае являетсяnative. Имя цели используется для генерации путей к исходным файлам и имен задач в проекте. Создайте пустой файл
settings.gradleилиsettings.gradle.ktsв директории проекта.-
Создайте директорию
src/nativeMain/kotlinи поместите в нее файлhello.ktсо следующим содержимым:fun main() { println("Hello, Kotlin/Native!") }Согласно соглашению, все исходные файлы расположены в каталогах
src/<target name>[Main|Test]/kotlin, гдеmainпредназначен для исходного кода, аtest— для тестов.<target name>соответствует целевой платформе (в данном случаеnative), как указано в файле сборки.
Теперь вы готовы собрать свой проект и запустить приложение.
Сборка и запуск приложения
-
Из корневой директории проекта запустите команду сборки:
gradle nativeBinaries
Эта команда создает директорию
build/bin/nativeс двумя каталогами внутри:debugExecutableиreleaseExecutable. Они содержат соответствующие двоичные файлы.По умолчанию имя двоичного файла совпадает с именем директории проекта.
-
Для запуска проекта выполните следующую команду:
build/bin/native/debugExecutable/<project_name>.kexe
В терминале будет выведено "Hello, Kotlin/Native!".
Открытие проекта в IDE
Теперь вы можете открыть свой проект в любой IDE, поддерживающей Gradle. Если вы используете IntelliJ IDEA:
Выберите Файл | Открыть....
Выберите директорию проекта и нажмите Открыть.
IntelliJ IDEA автоматически определит его как проект Kotlin/Native.
Что дальше?
Узнайте, как создавать файлы сборки Gradle для реальных проектов Kotlin/Native.
© 2010–2023 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/docs/native-gradle.html