هيكل الدليل

على الرغم من أن مشاريع Tuist تُستخدم عادةً لتحل محل مشاريع Xcode، إلا أنها لا تقتصر على حالة الاستخدام هذه. تُستخدم مشاريع تويست أيضًا لإنشاء أنواع أخرى من المشاريع، مثل حزم SPM، والقوالب، والمكونات الإضافية، والمهام. يصف هذا المستند بنية مشاريع تويست وكيفية تنظيمها. في أقسام لاحقة، سنغطي كيفية تعريف القوالب والإضافات والمهام.

مشاريع تويست القياسية

مشاريع تويست هي النوع الأكثر شيوعًا من المشاريع التي يتم إنشاؤها بواسطة تويست. تُستخدم لبناء التطبيقات والأطر والمكتبات وغيرها. على عكس مشاريع Xcode، يتم تعريف مشاريع Tuist بلغة Swift، مما يجعلها أكثر مرونة وأسهل في الصيانة. مشاريع تويست هي أيضًا أكثر وضوحًا، مما يجعلها أسهل في الفهم والاستدلال. تُظهر البنية التالية مشروع تويست نموذجي يولد مشروع Xcode:

Tuist.swift
Tuist/
  Package.swift
  ProjectDescriptionHelpers/
Projects/
  App/
    Project.swift
  Feature/
    Project.swift
Workspace.swift

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

  • مساعدو وصف المشروع: يحتوي هذا الدليل على كود Swift الذي تتم مشاركته عبر جميع ملفات البيان. يمكن لملفات البيان استيراد ProjectDescriptionHelpers لاستخدام الشيفرة المحددة في هذا الدليل. مشاركة الشيفرة مفيدة لتجنب التكرار وضمان الاتساق عبر المشاريع.
  • Package.swift: يحتوي هذا الملف على تبعيات Swift Package لتويست لدمجها باستخدام مشاريع وأهداف Xcode (مثل [CocoaPods] (https://cococapods)}) القابلة للتكوين والتحسين. تعرف على المزيد هنا.

• الدليل الجذر: الدليل الجذر لمشروعك الذي يحتوي أيضًا على الدليل Tuist.

  • يحتوي هذا الملف على تهيئة لـ Tuist التي تتم مشاركتها عبر جميع المشاريع ومساحات العمل والبيئات. على سبيل المثال، يمكن استخدامه لتعطيل الإنشاء التلقائي للمخططات، أو لتحديد هدف نشر المشاريع.
  • يمثل هذا البيان مساحة عمل Xcode. يُستخدم لتجميع المشاريع الأخرى ويمكنه أيضًا إضافة ملفات ومخططات إضافية.
  • يمثل هذا البيان مشروع Xcode. يُستخدم لتحديد الأهداف التي هي جزء من المشروع وتوابعها.

عند التفاعل مع المشروع أعلاه، تتوقع الأوامر أن تجد إما ملف Workspace.swift أو ملف Project.swift في دليل العمل أو الدليل المشار إليه عبر العلامة - المسار. يجب أن يكون البيان في دليل أو دليل فرعي لدليل يحتوي على دليل Tuist الذي يمثل جذر المشروع.

TIP

سمحت مساحات عمل Xcode بتقسيم المشاريع إلى مشاريع Xcode متعددة لتقليل احتمالية تعارضات الدمج. إذا كان هذا ما كنت تستخدم مساحات العمل من أجله، فلن تحتاج إليها في Tuist. يُنشئ تويست تلقائيًا مساحة عمل تحتوي على مشروع ومشاريع تبعياته.

باقة سويفت beta

يدعم Tuist أيضًا مشاريع حزم SPM. إذا كنت تعمل على حزمة SPM، فلن تحتاج إلى تحديث أي شيء. يلتقط تويست تلقائيًا على الجذر الخاص بك Package.swift وتعمل جميع ميزات تويست كما لو كان Project.swift البيان.

للبدء، قم بتشغيل tuist install و tuist generate في حزمة SPM الخاصة بك. يجب أن يحتوي مشروعك الآن على جميع المخططات والملفات نفسها التي ستراها في تكامل Xcode SPM الفانيليا. ومع ذلك، يمكنك الآن أيضًا تشغيل

`tuist cache`

وستحصل على معظم تبعيات ووحدات SPM الخاصة بك مجمعة مسبقًا، مما يجعل الإنشاءات اللاحقة سريعة للغاية.