# التحرير {#editing}

على عكس مشاريع Xcode التقليدية أو حزم سويفت، حيث تتم التغييرات من خلال واجهة
مستخدم Xcode، يتم تعريف المشاريع التي تدار بواسطة تويست في كود سويفت الموجود في
ملفات البيان **** . إذا كنت على دراية بحزم Swift Packages وملف `Package.swift` ،
فإن النهج مشابه جدًا.

يمكنك تحرير هذه الملفات باستخدام أي محرر نصوص، ولكننا نوصي باستخدام سير العمل
الذي يوفره تويست لذلك، `tuist edit`. ينشئ سير العمل مشروع Xcode يحتوي على جميع
ملفات البيان ويسمح لك بتحريرها وتجميعها. وبفضل استخدام Xcode، ستحصل على جميع
مزايا إكمال التعليمات البرمجية **، وتمييز بناء الجملة، والتحقق من الأخطاء**.

## تحرير المشروع {#edit-the-project}

لتحرير مشروعك، يمكنك تشغيل الأمر التالي في دليل مشروع Tuist أو في دليل مشروع
فرعي:

```bash
tuist edit
```

ينشئ الأمر مشروع Xcode في دليل عام ويفتحه في Xcode. يتضمن المشروع دليل
`Manifests` الذي يمكنك إنشاؤه للتأكد من صلاحية جميع بياناتك.

> [!NOTE]
> **Glob-resolved Manifests**
>
> `تحرير تويست` يحل المظاهر المراد تضمينها باستخدام glob `**/{Manifest}.swift` من
> الدليل الجذر للمشروع (الذي يحتوي على ملف `Tuist.swift.` ). تأكد من وجود
> `Tuist.swift.swift` صالح في جذر المشروع.


### تجاهل ملفات البيان {#ignoring-manifest-files}

إذا كان مشروعك يحتوي على ملفات سويفت بنفس اسم ملفات البيان (على سبيل المثال،
`Project.swift.`) في دلائل فرعية ليست بيانات تويست الفعلية، يمكنك إنشاء ملف
`.tuistignore` في جذر مشروعك لاستبعادها من مشروع التحرير.

يستخدم ملف .tuistignore` ` .tuistignore أنماطًا كروية لتحديد الملفات التي يجب
تجاهلها:

```gitignore
# Ignore all Project.swift files in the Sources directory
Sources/**/Project.swift

# Ignore specific subdirectories
Tests/Fixtures/**/Workspace.swift
```

يكون هذا مفيدًا بشكل خاص عندما يكون لديك تركيبات اختبار أو أمثلة برمجية تصادف
أنها تستخدم نفس اصطلاح التسمية كملفات بيان تويست.

## تحرير وإنشاء سير العمل {#edit-and-generate-workflow}

كما لاحظت، لا يمكن إجراء التحرير من مشروع Xcode الذي تم إنشاؤه. هذا حسب التصميم
لمنع المشروع الذي تم إنشاؤه من الاعتماد على Tuist، مما يضمن لك الانتقال من Tuist
في المستقبل بأقل جهد ممكن.

عند تكرار مشروع ما، نوصي بتشغيل `tuist edit` من جلسة طرفية للحصول على مشروع
Xcode لتحرير المشروع، واستخدام جلسة طرفية أخرى لتشغيل `tuist gener`.
