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.
После этого наш проект должен собираться и создавать соответствующие артефакты.
Другие сервера непрерывной интеграции
Если вы используете инструмент непрерывной интеграции, отличный от TeamCity, и он поддерживает инструменты сборки или вызов инструментов командной строки, компиляция Kotlin и автоматизация задач как часть процесса CI должны быть возможны.
© 2010–2023 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