التكامل المستمر (CI)

لتشغيل أوامر Tuist في عمليات سير عمل [التكامل المستمر] (https://en.wikipedia.org/wiki/Continuous_integration) الخاصة بك، ستحتاج إلى تثبيته في بيئة CI الخاصة بك.

تكون المصادقة اختيارية ولكنها مطلوبة إذا كنت تريد استخدام ميزات من جانب الخادم مثل ذاكرة التخزين المؤقت.

تقدم الأقسام التالية أمثلة على كيفية القيام بذلك على منصات CI المختلفة.

أمثلة

إجراءات GitHub

في إجراءات GitHub يمكنك استخدام مصادقة

OIDC

للمصادقة الآمنة وغير السرية:

OIDC (Mise)OIDC (Homebrew)Project token (Mise)Project token (Homebrew)

yaml

name: Build Application
on:
  pull_request:
    branches:
      - main
  push:
    branches:
      - main

permissions:
  id-token: write
  contents: read

jobs:
  build:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v4
      - uses: jdx/mise-action@v2
      - run: tuist auth login
      - run: tuist setup cache

yaml

name: Build Application
on:
  pull_request:
    branches:
      - main
  push:
    branches:
      - main

permissions:
  id-token: write
  contents: read

jobs:
  build:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v4
      - run: brew install --formula [email protected]
      - run: tuist auth login
      - run: tuist setup cache

yaml

name: Build Application
on:
  pull_request:
    branches:
      - main
  push:
    branches:
      - main

env:
  TUIST_TOKEN: ${{ secrets.TUIST_TOKEN }}

jobs:
  build:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v4
      - uses: jdx/mise-action@v2
      - run: tuist setup cache

yaml

name: Build Application
on:
  pull_request:
    branches:
      - main
  push:
    branches:
      - main

env:
  TUIST_TOKEN: ${{ secrets.TUIST_TOKEN }}

jobs:
  build:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v4
      - run: brew install --formula [email protected]
      - run: tuist setup cache

إعداد OIDC

قبل استخدام مصادقة OIDC، تحتاج إلى

ربط مستودع GitHub الخاص بك بمشروعك Tuist. الأذونات `: الرمز المميز للمعرف:

الكتابة` مطلوب لكي يعمل OIDC. وبدلاً من ذلك، يمكنك استخدام

رمز المشروع مع TUIST_TOKEN السري.

TIP

نوصي باستخدام mise استخدام --pin في مشاريع تويست الخاصة بك لتثبيت إصدار تويست عبر البيئات. سينشئ الأمر ملف .tool-versions يحتوي على إصدار تويست.

سحابة Xcode السحابية

في [Xcode Cloud] (https://developer.apple.com/xcode-cloud/)، الذي يستخدم مشاريع Xcode كمصدر للحقيقة، ستحتاج إلى إضافة [ما بعد الاستنساخ] (https://developer.apple.com/documentation/xcode/writing-custom-build-scripts#Create-a-custom-build-script) برنامج نصي لتثبيت Tuist وتشغيل الأوامر التي تحتاجها، على سبيل المثال tuist توليد:

MiseHomebrew

bash

#!/bin/sh

# Mise installation taken from https://mise.jdx.dev/continuous-integration.html#xcode-cloud
curl https://mise.run | sh # Install Mise
export PATH="$HOME/.local/bin:$PATH"

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 install --path ../ # `--path` needed as this is run from within the `ci_scripts` directory
mise exec -- tuist generate -p ../ --no-open # `-p` needed as this is run from within the `ci_scripts` directory

bash

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

tuist generate

المصادقة

استخدم رمزًا مميزًا

للمشروع عن طريق تعيين متغير البيئة TUIST_TOKEN في إعدادات سير عمل

Xcode Cloud الخاص بك.

سيركل سي آي

في CircleCI يمكنك استخدام مصادقة

OIDC

للمصادقة الآمنة وغير السرية:

OIDC (Mise)Project token (Mise)

yaml

version: 2.1
jobs:
  build:
    macos:
      xcode: "15.0.1"
    steps:
      - checkout
      - run:
          name: Install Mise
          command: |
            curl https://mise.jdx.dev/install.sh | sh
            echo 'export PATH="$HOME/.local/bin:$PATH"' >> $BASH_ENV
      - run:
          name: Install Tuist
          command: mise install
      - run:
          name: Authenticate
          command: mise exec -- tuist auth login
      - run:
          name: Build
          command: mise exec -- tuist setup cache

yaml

version: 2.1
jobs:
  build:
    macos:
      xcode: "15.0.1"
    environment:
      TUIST_TOKEN: $TUIST_TOKEN
    steps:
      - checkout
      - run:
          name: Install Mise
          command: |
            curl https://mise.jdx.dev/install.sh | sh
            echo 'export PATH="$HOME/.local/bin:$PATH"' >> $BASH_ENV
      - run:
          name: Install Tuist
          command: mise install
      - run:
          name: Build
          command: mise exec -- tuist setup cache

المصادقة

قبل استخدام مصادقة OIDC، تحتاج إلى

ربط مستودع GitHub الخاص بك بمستودع GitHub الخاص بك بمشروع Tuist الخاص بك. تتضمن

رموز CircleCI OIDC الرموز المميزة لمستودع GitHub المتصل الخاص بك، والتي يستخدمها Tuist لتخويل الوصول إلى مشاريعك. بدلاً من ذلك، يمكنك استخدام

رمز المشروع المميز مع متغير البيئة TUIST_TOKEN.

بيترايز

على Bitrise يمكنك استخدام مصادقة

OIDC

للمصادقة الآمنة وغير السرية:

OIDC (Mise)Project token (Mise)

yaml

workflows:
  build:
    steps:
      - git-clone@8: {}
      - script@1:
          title: Install Mise
          inputs:
            - content: |
                curl https://mise.jdx.dev/install.sh | sh
                echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
      - script@1:
          title: Install Tuist
          inputs:
            - content: mise install
      - get-identity-token@0:
          inputs:
          - audience: tuist
      - script@1:
          title: Authenticate
          inputs:
            - content: mise exec -- tuist auth login
      - script@1:
          title: Build
          inputs:
            - content: mise exec -- tuist setup cache

yaml

workflows:
  build:
    steps:
      - git-clone@8: {}
      - script@1:
          title: Install Mise
          inputs:
            - content: |
                curl https://mise.jdx.dev/install.sh | sh
                echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
      - script@1:
          title: Install Tuist
          inputs:
            - content: mise install
      - script@1:
          title: Build
          inputs:
            - content: mise exec -- tuist setup cache

المصادقة

قبل استخدام مصادقة OIDC، تحتاج إلى

ربط مستودع GitHub الخاص بك بمستودع GitHub الخاص بك بمشروع Tuist الخاص بك. تتضمن

رموز Bitrise OIDC الرموز المميزة لمستودع GitHub المتصل الخاص بك، والذي يستخدمه Tuist لتخويل الوصول إلى مشاريعك. بدلاً من ذلك، يمكنك استخدام

رمز المشروع المميز مع متغير البيئة TUIST_TOKEN.

كودمجيك

في [Codemagic] (https://codemagic.io)، يمكنك إضافة خطوة إضافية إلى سير عملك لتثبيت Tuist:

MiseHomebrew

yaml

workflows:
  build:
    name: Build
    max_build_duration: 30
    environment:
      xcode: 15.0.1
      vars:
        TUIST_TOKEN: ${{ secrets.TUIST_TOKEN }}
    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 setup cache

yaml

workflows:
  build:
    name: Build
    max_build_duration: 30
    environment:
      xcode: 15.0.1
      vars:
        TUIST_TOKEN: ${{ secrets.TUIST_TOKEN }}
    scripts:
      - name: Install Tuist
        script: |
          brew install --formula [email protected]
      - name: Build
        script: tuist setup cache

المصادقة

قم بإنشاء رمز مميز للمشروع وأضفه كمتغير بيئة سري باسم TUIST_TOKEN.

المشروع المُنشأ

التبني

الانتقال

الفحص

ذاكرة التخزين المؤقت

الاختبار الانتقائي

السجل

المشروع المُنشأ

التكامل المستمر (CI)

أمثلة

إجراءات GitHub

سحابة Xcode السحابية

سيركل سي آي

بيترايز

كودمجيك

الانتقال

التكامل المستمر (CI) ​

أمثلة ​

إجراءات GitHub ​

سحابة Xcode السحابية ​

سيركل سي آي ​

بيترايز ​

كودمجيك ​

التكامل المستمر (CI)

أمثلة

إجراءات GitHub

سحابة Xcode السحابية

سيركل سي آي

بيترايز

كودمجيك