Spec-Zone.ru › Kotlin 1.6

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 должны быть возможны.

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

© 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

Spec-Zone.ru

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