Kotlin и непрерывная интеграция с TeamCity
На этой странице вы узнаете, как настроить TeamCity для сборки вашего проекта Kotlin. Для получения дополнительной информации и основ TeamCity, пожалуйста, обратитесь к странице документации, которая содержит информацию об установке, базовой настройке и т. д.
Kotlin работает с различными инструментами сборки, поэтому если вы используете стандартные инструменты, такие как Ant, Maven или Gradle, процесс настройки проекта Kotlin ничем не отличается от любого другого языка или библиотеки, интегрирующихся с этими инструментами. Отклонения и дополнительные требования возникают при использовании внутренней системы сборки IntelliJ IDEA, которая также поддерживается TeamCity.
Gradle, Maven и Ant
Если вы используете Ant, Maven или Gradle, процесс настройки прост. Всё, что нужно, это определить шаг сборки. Например, если вы используете Gradle, просто определите необходимые параметры, такие как имя шага и задачи Gradle, которые нужно выполнить для типа исполнителя.
Поскольку все зависимости, необходимые для Kotlin, определены в файле Gradle, для корректной работы Kotlin ничего больше настраивать не нужно.
При использовании Ant или Maven применяется та же конфигурация. Единственное различие заключается в том, что тип исполнителя будет Ant или Maven соответственно.
Система сборки IntelliJ IDEA
Если вы используете систему сборки IntelliJ IDEA с TeamCity, убедитесь, что версия Kotlin, используемая IntelliJ IDEA, совпадает с версией, работающей в TeamCity. Возможно, потребуется загрузить определённую версию плагина Kotlin и установить её в TeamCity.
К счастью, уже доступен мета-исполнитель, который выполняет большую часть рутинной работы. Если вы не знакомы с концепцией мета-исполнителей TeamCity, обратитесь к документации. Это очень лёгкий и мощный способ введения пользовательских исполнителей без необходимости написания плагинов.
Загрузка и установка мета-исполнителя
Мета-исполнитель для Kotlin доступен на GitHub. Загрузите этот мета-исполнитель и импортируйте его через пользовательский интерфейс TeamCity.
Настройка шага получения компилятора Kotlin
В основном этот шаг ограничен определением имени шага и необходимой версии Kotlin. Можно использовать теги.
Исполнитель установит значение для системной переменной system.path.macro.KOTLIN.BUNDLED в соответствии с настройками пути из проекта IntelliJ IDEA. Однако это значение необходимо определить в TeamCity (и его можно установить на любое значение). Поэтому вам нужно определить его как системную переменную.
Настройка шага компиляции Kotlin
Последний шаг — определение фактической компиляции проекта, которая использует стандартный тип исполнителя IntelliJ IDEA.
После этого наш проект должен успешно собираться и создавать соответствующие артефакты.
Другие серверы CI
Если вы используете инструмент непрерывной интеграции, отличающийся от TeamCity, и он поддерживает инструменты сборки или вызов командных инструментов, компиляция Kotlin и автоматизация процессов в рамках процесса CI должны быть возможны.
© 2010–2022 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/docs/kotlin-and-ci.html