Настройка TeamCity для приложения Kotlin Multiplatform

Общие настройки конвейера

Для этого руководства не нужно настраивать глобальные параметры конвейера. Подробнее о параметрах, которые влияют на все задания в конвейере, см. в этой статье. К таким параметрам относятся:

• Автозапуск конвейеров — позволяет настроить автоматический запуск конвейера при каждом коммите изменений в удаленный репозиторий (включено по умолчанию), при открытии запроса на слияние для репозитория или по заданному расписанию.

• Репозиторий — позволяет извлекать и обрабатывать несколько репозиториев из разных хостингов VCS.

• Интеграции — позволяет подключать внешние реестры NPM и Docker. Обратите внимание: если вы планируете выполнять шаги сборки в общедоступных образах Docker Hub, настраивать соответствующую интеграцию не нужно, если только конвейер не запускается настолько часто, что превышает ограничения Docker Hub на анонимную загрузку образов.

Настройки агентов

Задачи сборки обрабатываются агентами сборки, установленными на физических или облачных машинах. На этих машинах должны быть установлены все инструменты, необходимые для выполнения заданных задач сборки. Например, для задания 2 в этом конвейере требуется Android SDK, а в задании 3 используется Xcode для сборки версии приложения для iOS.

• В TeamCity Cloud используются агенты, размещенные JetBrains и оснащенные широким набором инструментов сборки. Для этого руководства подключать дополнительные агенты не нужно.

• Если вы используете TeamCity On-Premises, убедитесь, что каждое задание может выполняться как минимум на одном агенте. Подробнее см. в статье Установка и запуск агентов TeamCity.

В этом руководстве в заданиях указаны требования к агентам, чтобы гарантировать их назначение только агентам с необходимыми установленными инструментами.

Запуск общих тестов

Переключитесь на редактор конвейера YAML и вставьте следующую разметку, чтобы настроить первое задание:

jobs:
  Job1:
    name: Run tests
    steps:
      - type: gradle
        use-gradle-wrapper: true
        name: Gradle test
        jdk-home: '%env.JDK_17_0%'
        tasks: jvmTest
    files-publication:
      - path: '**/build/reports/tests/**/*'
        share-with-jobs: false
        publish-artifact: true
    allow-reuse: false

Это задание запускает задачу Gradle jvmTest с использованием Java 17. Оно собирает все файлы, пути которых соответствуют .../build/reports/tests/..., помещает их в папку test-reports и публикует эту папку как артефакт.

Также можно включить параметр задания Оптимизации | Параллельное тестирование, чтобы разделить набор тестов на более мелкие группы и обрабатывать каждую группу на отдельном агенте сборки. Это может значительно сократить общее время выполнения, но потребует больше ресурсов. Чтобы включить параллельное тестирование, измените YAML конвейера, добавив параметр parallelism, как показано ниже:

    ...
    allow-reuse: false
    parallelism: 3

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

Дополнительные сведения см. в статьях Настройки задания и Шаг сборки Gradle.

Сборка отладочного пакета Android

Измените YAML конвейера следующим образом:

jobs:
  Job1:
    name: Run tests
    ...
    Job2:
      name: Build Android
      steps:
        - type: gradle
          jdk-home: '%env.JDK_17_0%'
          tasks: ':mobile:assembleDebug'
          use-gradle-wrapper: true
      files-publication:
        - path: mobile/build/outputs/apk/debug/*.apk
          share-with-jobs: false
          publish-artifact: true
      runs-on:
        self-hosted:
          - requirement: exists
            name: Android home
            parameter: env.ANDROID_HOME
      dependencies:
        - Job1

• Блок requirement гарантирует, что это задание будет назначено только агентам с установленным Android SDK.

• Раздел dependencies гарантирует, что это задание начнется только после успешного завершения Job1.

Сборка приложения для симулятора iOS

На последнем шаге добавьте в YAML конвейера следующую разметку:

jobs:
  Job1:
    ...
  Job2:
    ...
  Job3:
    name: Build iOS
    steps:
      - type: script
        script-content: |-
          xcodebuild build \
            -project JetcasterMigration/JetcasterMigration.xcodeproj \
            -configuration Debug \
            -scheme JetcasterMigration \
            -sdk iphonesimulator \
            -derivedDataPath ./build \
            -verbose
    files-publication:
      - path: build/Build/Products/Debug-iphonesimulator/**/*
        share-with-jobs: false
        publish-artifact: true
    dependencies:
      - Job1

В отличие от первых двух заданий, Сборка iOS использует универсальный шаг сборки командной строки, который позволяет выполнять команды и работать с любыми инструментами, установленными на машине агента.

Раздел dependencies указывает зависимость от Job1. Это означает, что задания Сборка Android и Сборка iOS могут выполняться параллельно, но начнутся только после завершения процедуры тестирования из Job1.