Непрерывная интеграция (CI)

Вы можете использовать Tuist в окружениях непрерывной интеграции. В следующих разделах приведены примеры того, как это можно сделать на различных платформах CI.

Примеры

Чтобы запускать Tuist команды в ваших рабочих процессах CI, вам нужно установить Tuist в вашей среде CI.

Xcode Cloud

В Xcode Cloud, который использует Xcode проекты, вам нужно будет добавить post-clone скрипт для установки Tuist и запуска необходимых команд, например tuist generate:

Mise

#!/bin/sh
curl https://mise.jdx.dev/install.sh | sh
mise install # Installs the version from .mise.toml

# Runs the version of Tuist indicated in the .mise.toml file {#runs-the-version-of-tuist-indicated-in-the-misetoml-file}
mise exec -- tuist generate

Homebrew

#!/bin/sh
brew install --formula [email protected]

tuist generate

Codemagic

В Codemagic вы можете добавить дополнительный шаг в рабочий процесс для установки Tuist:

Mise

workflows:
  lint:
    name: Build
    max_build_duration: 30
    environment:
      xcode: 15.0.1
    scripts:
      - name: Install Mise
        script: |
          curl https://mise.jdx.dev/install.sh | sh
          mise install # Installs the version from .mise.toml
      - name: Build
        script: mise exec -- tuist build

Homebrew

workflows:
  lint:
    name: Build
    max_build_duration: 30
    environment:
      xcode: 15.0.1
    scripts:
      - name: Install Tuist
        script: |
          brew install --formula [email protected]
      - name: Build
        script: tuist build

GitHub Actions

В GitHub Actions вы можете добавить дополнительный шаг для установки Tuist, а в случае управления установкой Mise, вы можете использовать mise-action, который абстрагирует установку Mise и Tuist:

Mise

name: Build Application
on:
  pull_request:
    branches:
      - main
  push:
    branches:
      - main
jobs:
  build:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v3
      - uses: jdx/mise-action@v2
      - run: tuist build

Homebrew

name: test
on:
  pull_request:
    branches:
      - main
  push:
    branches:
      - main
jobs:
  lint:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v3
      - run: brew install --formula [email protected]
      - run: tuist build

TIP

Мы рекомендуем использовать mise use --pin в ваших проектах, чтобы закрепить версию Tuist в разных окружениях. Команда создаст файл .tool-versions, содержащий версию Tuist.

Аутентификация

При использовании серверных функций, таких как cache, вам понадобится способ аутентификации запросов, идущих с ваших рабочих процессов CI на сервер. Для этого можно сгенерировать токен, привязанный к проекту, выполнив следующую команду:

tuist project tokens create my-handle/MyApp

Команда создаст токен для проекта с полным названием my-account/my-project. Установите значение переменной окружения TUIST_CONFIG_TOKEN в вашей среде CI, так что бы она не была раскрыта.

ОБНАРУЖЕНИЕ СРЕДЫ CI

Tuist использует токен только в том случае, если обнаруживает, что работает в среде CI. Если ваше окружение CI не обнаружено, вы можете принудительно использовать токен, установив переменную окружения CI в значение 1.