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
