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

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

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

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

قبل استخدام مصادقة 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 توليد:

:::: مجموعة الرموز

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
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

:::

Authentication

استخدم رمزًا مميزًا للمشروع عن طريق تعيين متغير البيئة TUIST_TOKEN في إعدادات سير عمل Xcode Cloud الخاص بك.

سيركلسي#

في CircleCI يمكنك استخدام مصادقة OIDC للمصادقة الآمنة وغير السرية:

:::: مجموعة الرموز

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

:::

Authentication

قبل استخدام مصادقة OIDC، تحتاج إلى ربط مستودع GitHub الخاص بك بمستودع GitHub الخاص بك بمشروع Tuist الخاص بك. تتضمن رموز CircleCI OIDC الرموز المميزة لمستودع GitHub المتصل الخاص بك، والتي يستخدمها Tuist لتخويل الوصول إلى مشاريعك. بدلاً من ذلك، يمكنك استخدام رمز المشروع المميز مع متغير البيئة TUIST_TOKEN.

بيترايز#

على Bitrise يمكنك استخدام مصادقة OIDC للمصادقة الآمنة وغير السرية:

:::: مجموعة الرموز

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

:::

Authentication

قبل استخدام مصادقة OIDC، تحتاج إلى ربط مستودع GitHub الخاص بك بمستودع GitHub الخاص بك بمشروع Tuist الخاص بك. تتضمن رموز Bitrise OIDC الرموز المميزة لمستودع GitHub المتصل الخاص بك، والذي يستخدمه Tuist لتخويل الوصول إلى مشاريعك. بدلاً من ذلك، يمكنك استخدام رمز المشروع المميز مع متغير البيئة TUIST_TOKEN.

كودماغك#

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

:::: مجموعة الرموز

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

:::

Authentication

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

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

أمثلة#

إجراءات GitHub#

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

سيركلسي#

بيترايز#

كودماغك#