Непрерывная интеграция (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

On GitHub Actions you can add an additional step to install Tuist, and in the case of managing the installation of Mise, you can use the mise-action, which abstracts the installation of Mise and 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.