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

يوفر تويست دعمًا لذاكرة التخزين المؤقت لتجميع Xcode، مما يسمح للفرق بمشاركة القطع الأثرية للتجميع من خلال الاستفادة من قدرات التخزين المؤقت لنظام الإنشاء.

الإعداد

REQUIREMENTS

• حساب ومشروع Tuist
• Xcode 26.0 أو أحدث

إذا لم يكن لديك حساب ومشروع تويست بالفعل، يمكنك إنشاء حساب ومشروع عن طريق التشغيل:

tuist init

بمجرد أن يكون لديك ملف Tuist.swift.swift الذي يشير إلى ملف fullHandle ، يمكنك إعداد التخزين المؤقت لمشروعك عن طريق تشغيل:

tuist setup cache

ينشئ هذا الأمر [LaunchAgent] (https://developer.apple.com/library/archive/documentation/MacOSX/Conceptual/BPSystemStartup/Chapters/CreatingLaunchdJobs.html) لتشغيل خدمة تخزين مؤقت محلية عند بدء التشغيل يستخدمها [نظام البناء] (https://github.com/swiftlang/swift-build) Swift لمشاركة القطع الأثرية للتجميع. يجب تشغيل هذا الأمر مرة واحدة في كل من البيئات المحلية وبيئة التخزين المؤقت.

لإعداد ذاكرة التخزين المؤقت على CI، تأكد من أنك مصادق.

تهيئة إعدادات إنشاء Xcode

أضف إعدادات الإنشاء التالية إلى مشروع Xcode الخاص بك:

COMPILATION_CACHE_ENABLE_CACHING = YES
COMPILATION_CACHE_REMOTE_SERVICE_PATH = $HOME/.local/state/tuist/your_org_your_project.sock
COMPILATION_CACHE_ENABLE_PLUGIN = YES
COMPILATION_CACHE_ENABLE_DIAGNOSTIC_REMARKS = YES

لاحظ أن COMPILATION_CACHE_REMOTE_SERVICE_SERVICE_PATH و COMPILATION_CACHE_ENABLE_PLUGIN يجب إضافتها كإعدادات بناء محددة من قبل المستخدم نظرًا لأنها غير مكشوفة مباشرة في واجهة مستخدم إعدادات البناء في Xcode:

SOCKET PATH

سيتم عرض مسار المقبس عند تشغيل tuist إعداد ذاكرة التخزين المؤقت. وهو يستند إلى المقبض الكامل لمشروعك مع استبدال الشرطات المائلة بشرطة سفلية.

يمكنك أيضًا تحديد هذه الإعدادات عند تشغيل xcodebuild عن طريق إضافة الأعلام التالية، مثل

xcodebuild build -project YourProject.xcodeproj -scheme YourScheme \
    COMPILATION_CACHE_ENABLE_CACHING=YES \
    COMPILATION_CACHE_REMOTE_SERVICE_PATH=$HOME/.local/state/tuist/your_org_your_project.sock \
    COMPILATION_CACHE_ENABLE_PLUGIN=YES \
    COMPILATION_CACHE_ENABLE_DIAGNOSTIC_REMARKS=YES

GENERATED PROJECTS

لا حاجة إلى ضبط الإعدادات يدويًا إذا كان مشروعك قد تم إنشاؤه بواسطة Tuist.

في هذه الحالة، كل ما تحتاجه هو إضافة enableCaching: true إلى ملف Tuist.swift.swift الخاص بك :

import ProjectDescription

let tuist = Tuist(
    fullHandle: "your-org/your-project",
    project: .tuist(
        generationOptions: .options(
            enableCaching: true
        )
    )
)

التكامل المستمر

لتمكين التخزين المؤقت في بيئة CI الخاصة بك، تحتاج إلى تشغيل نفس الأمر كما هو الحال في البيئات المحلية: tuist إعداد ذاكرة التخزين المؤقت.

بالإضافة إلى ذلك، تحتاج إلى التأكد من تعيين متغير البيئة TUIST_TOKEN. يمكنك إنشاء واحد باتباع الوثائق هنا. يجب أن يكون متغير البيئة TUIST_TOKEN موجودًا لخطوة الإنشاء الخاصة بك، لكننا نوصي بتعيينه لسير عمل CI بأكمله.

مثال على سير العمل لإجراءات GitHub يمكن أن يبدو بعد ذلك على النحو التالي:

name: Build

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

jobs:
  build:
    steps:
      - # Your set up steps...
      - name: Set up Tuist Cache
        run: tuist setup cache
      - # Your build steps