Spec-Zone.ru › Kotlin 1.8

Kotlin и непрерывная интеграция с TeamCity

На этой странице вы узнаете, как настроить TeamCity для сборки вашего проекта Kotlin. Для получения дополнительной информации и основ TeamCity, пожалуйста, ознакомьтесь со страницей документации, которая содержит информацию об установке, базовой настройке и т. д.

Kotlin работает с различными инструментами сборки, поэтому если вы используете стандартный инструмент, такой как Ant, Maven или Gradle, процесс настройки проекта Kotlin ничем не отличается от других языков или библиотек, которые интегрированы с этими инструментами. Различия и дополнительные требования возникают при использовании внутренней системы сборки IntelliJ IDEA, которая также поддерживается TeamCity.

Gradle, Maven и Ant

Если вы используете Ant, Maven или Gradle, процесс настройки прост. Все, что нужно, это определение шага сборки. Например, если вы используете Gradle, просто определите необходимые параметры, такие как имя шага и задачи Gradle, которые необходимо выполнить для типа исполнителя.

Gradle Build Step

Поскольку все зависимости, необходимые для Kotlin, определены в файле Gradle, ничего больше не нужно настраивать для правильной работы Kotlin.

Если вы используете Ant или Maven, применяется та же конфигурация. Единственное различие заключается в том, что тип исполнителя будет Ant или Maven соответственно.

Система сборки IntelliJ IDEA

Если вы используете систему сборки IntelliJ IDEA с TeamCity, убедитесь, что версия Kotlin, используемая IntelliJ IDEA, совпадает с той, которую использует TeamCity. Возможно, вам потребуется загрузить определенную версию плагина Kotlin и установить ее в TeamCity.

К счастью, уже доступен мета-исполнитель, который позаботится о большей части рутинной работы. Если вы не знакомы с концепцией мета-исполнителей TeamCity, ознакомьтесь с документацией. Они представляют собой очень простой и мощный способ введения пользовательских исполнителей без необходимости написания плагинов.

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

Мета-исполнитель для Kotlin доступен на GitHub. Загрузите этот мета-исполнитель и импортируйте его из пользовательского интерфейса TeamCity

Meta-runner

Настройка шага получения компилятора Kotlin

В основном этот шаг ограничивается определением имени шага и необходимой версии Kotlin. Можно использовать теги.

Setup Kotlin Compiler

Исполнитель установит значение для свойства system.path.macro.KOTLIN.BUNDLED на правильное значение, основываясь на параметрах пути из проекта IntelliJ IDEA. Однако это значение необходимо определить в TeamCity (и можно задать любое значение). Поэтому вам нужно определить его как системную переменную.

Настройка шага компиляции Kotlin

Окончательным шагом является определение фактической компиляции проекта, которая использует стандартный тип исполнителя IntelliJ IDEA.

IntelliJ IDEA Runner

С этим наш проект должен теперь собираться и генерировать соответствующие артефакты.

Другие серверы CI

Если вы используете инструмент непрерывной интеграции, отличный от TeamCity, и он поддерживает инструменты сборки или вызов инструментов командной строки, компиляция Kotlin и автоматизация процессов как часть процесса CI должны быть возможны.

Последнее изменение: 10 января 2023
Вопросы и ответы Документирование кода Kotlin: KDoc и Dokka

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API