skill

إعداد مشروع Xcode

يعدل مشاريع Xcode (.pbxproj) بأمان لإضافة حزم Swift وربط الملفات. استخدم هذه المهارة كلما احتاج مشروع iOS إلى تثبيت تبعيات (مثل Firebase، Alamofire).

firebase122,649+ تثبيتموثوق

نبذة

# إعداد مشروع Xcode

## ⛔️ قواعد حاسمة وفحوصات البيئة

قبل إجراء أي إعداد ل Xcode أو معالجة للملفات، **يجب عليك** الالتزام بالقواعد التالية. سيتم تطبيق رسوم باهظة إذا انتهكتها.

### 1. حظر Ruby

يحظر عليك **بشكل صارم** استخدام Ruby أو Rails أو أي حزم Ruby (بما في ذلك حزمة `xcodeproj`). لا يجوز لك تحت أي ظرف من الظروف كتابة أو تنفيذ نصوص Ruby البرمجية.

### 2. مزامنة مجلدات Xcode الحديثة

تدعم مشاريع Xcode الحديثة مزامنة المجلدات. عند إضافة كود مصدر جديد (`.swift`) أو ملفات موارد، ما عليك سوى كتابتها في الدليل الصحيح على القرص. سيتم تضمينها تلقائيا في مشروع Xcode. **لا تقم أبدا بتعديل ملف `.pbxproj` يدويا لإضافة ملفات.**

### 3. لغات البرمجة النصية المسموح بها

إذا كان يجب عليك كتابة نص برمجي لمعالجة بيئة المشروع (مثل تكوين حزم SPM بما يتجاوز ما يفعله النص البرمجي `xcode_spm_setup` المقدم)، **يجب عليك استخدام Swift**. فقط كحل أخير مطلق، إذا كان Swift غير قابل للتطبيق تماما، يمكنك استخدام Node.js أو TypeScript.

### 4. التحقق من سلسلة الأدوات

نظرا لأن هذه المهارة تعتمد كليا على نص Swift برمجي أصلي، يجب عليك التحقق من البيئة:

- قم بتشغيل `swift --version` قبل المتابعة. - إذا لم يتم العثور على أمر Swift، يجب عليك التوقف والتوصية للمستخدم بتثبيت سلسلة أدوات Swift (على سبيل المثال، عبر `xcode-select --install` على macOS)، أو السؤال عما إذا كان يمكنك محاولة تثبيتها لهم. لا تحاول المتابعة بدون Swift.

### 5. علامات الرابط الإلزامية للأطر الثابتة (Firebase)

عند إعداد تبعيات SPM التي تعتمد بشكل كبير على فئات Objective-C الداخلية وطرق `+load` (مثل مجموعة Firebase iOS SDK)، سيقوم رابط Apple بتجريد هذه الطرق بقوة إذا تم ربطها بشكل ثابت.

يؤدي هذا إلى أعطال قاتلة في وقت التشغيل (على سبيل المثال، `FirebaseAuth/Auth.swift:167: Fatal error: Unexpectedly found nil`).

**يقوم النص البرمجي `xcode_spm_setup` Swift المقدم بإدخال علامة `-ObjC` تلقائيا إلى `OTHER_LDFLAGS` عند إضافة منتجات Firebase.** ومع ذلك، يجب عليك التحقق من وجودها في إعدادات البناء إذا واجهت مشكلات.

- عدم تضمين هذه العلامة عند إضافة تبعيات Firebase هو خطأ فادح.

______________________________________________________________________

## سير عمل الدليل الفارغ

إذا طلب منك إنشاء تطبيق iOS أو تكوين تبعيات Xcode ولكن **لا يوجد ملف `.xcodeproj` أو `.xcworkspace`**، يجب عليك أن تطلب من المستخدم إنشاء المشروع أولا:

**"لم يتم العثور على مشروع Xcode في هذا الدليل. يرجى إنشاء مشروع Xcode فارغ يدويا وإعلامي عندما تكون جاهزا للمتابعة."**

انتظر حتى يؤكد المستخدم أنه أنشأ ملف `.xcodeproj` عبر Xcode، ثم تابع سير عمل Xcode القياسي أدناه.

______________________________________________________________________

## سير عمل Xcode القياسي

لا تستخدم تحليل النص الخام أو `sed` أو نصوص Ruby البرمجية لتعديل ملفات `.pbxproj` مباشرة.

بدلا من ذلك، قم بتنفيذ حزمة تكوين Swift المرفقة بهذه المهارة (`scripts/xcode_spm_setup`) لتثبيت حزم SPM بشكل آمن وربط ملفات التكوين الاختيارية (مثل `GoogleService-Info.plist`).

### **هام: استخدم دائما أحدث إصدار من SDK**

لضمان الوصول إلى أحدث الميزات وإصلاحات الأمان، استخدم دائما أحدث إصدار من Firebase iOS SDK. تحقق من أحدث إصدار على [https://github.com/firebase/firebase-ios-sdk/releases](https://github.com/firebase/firebase-ios-sdk/releases).

- استخدم أحدث رقم إصدار (على سبيل المثال، `11.x.y`) في أوامرك بدلا من العناصر النائبة المكتوبة بشكل ثابت.

### فهم إجراءات النص البرمجي

عند إضافة حزمة Swift إلى مشروع Xcode، يجب أن تحدث خطوتان متميزتان:

1. إضافة تبعية مستودع الحزمة (على سبيل المثال، `https://github.com/Alamofire/Alamofire`). 2. تحديد الهدف (على سبيل المثال، `MyApp`)، الانتقال إلى **General > Frameworks, Libraries, and Embedded Content**، والضغط على زر `+` لربط وحدات المنتج المحددة صراحة (على سبيل المثال، `Alamofire`).

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

## الاستخدام

1. **تحديد مسار الحزمة:** ابحث عن المسار المطلق لدليل `scripts/xcode_spm_setup` لهذه المهارة على القرص. 2. **التنفيذ:** قم بتشغيل أمر `swift run` الأصلي باستخدام التوقيع أدناه:

```bash swift run --package-path <PATH_TO_SKILL>/scripts/xcode_spm_setup xcode_spm_setup <ProjectPath.xcodeproj> <RepoURL> <VersionRequirement> [--plist <Optional/Path/To/Config.plist>] <Product1> [Product2 ...] ```

### مثال 1: حزمة عامة (مثل Alamofire)

إضافة Alamofire إلى مشروع Xcode قياسي. لاحظ عدم وجود علامة `--plist`.

```bash swift run --package-path /Users/foo/.agents/skills/xcode-project-setup/scripts/xcode_spm_setup xcode_spm_set ```

التثبيت

شغل هذا الأمر

npx skills add firebase/agent-skills

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `npx skills add firebase/agent-skills`، أو استنسخ المستودع وانسخ مجلد `skills/xcode-project-setup` إلى دليل مهارات Claude الخاص بك.

عرض المصدر

أسئلة شائعة

ما هي مهارة إعداد مشروع Xcode؟

يعدل مشاريع Xcode (.pbxproj) بأمان لإضافة حزم Swift وربط الملفات. استخدم هذه المهارة كلما احتاج مشروع iOS إلى تثبيت تبعيات (مثل Firebase، Alamofire).

كيف أثبت إعداد مشروع Xcode؟

شغل هذا الأمر في الطرفية:

npx skills add firebase/agent-skills
مع أي أدوات ذكاء اصطناعي تعمل إعداد مشروع Xcode؟

تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.

من طور إعداد مشروع Xcode؟

طورها firebase.

هل إعداد مشروع Xcode مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في الإنتاجية والمكتب.

كل بدائل إعداد مشروع Xcode ←
skillclaude_appclaude_codeclaude_api
npx skills add vercel-labs/skills
البحث عن المهارات
يساعد المستخدمين على اكتشاف وتثبيت مهارات الوكلاء عندما يطرحون أسئلة مثل "كيف أفعل X؟"، "ابحث عن مهارة ل X"، "هل توجد مهارة يمكنها..."، أو يعبرون عن ا…3,611,572+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
استخدام الوسائط
احصل على أو أنشئ أي وسائط لفيديو HyperFrames - موسيقى، مؤثرات صوتية، صور، أيقونات، شعارات، تعليق صوتي، صورة رمزية وفيديو مولد، نصوص، قصاصات، درجات ألو…1,085,267+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تحسين هيكلية قاعدة الكود
افحص قاعدة بيانات برمجية بحثا عن فرص للتحسين والتعميق، وقدمها كتقرير HTML مرئي، ثم تعمق في أي فرصة تختارها.1,040,100+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تسليم المهام
لخص المحادثة الحالية في وثيقة تسليم ليتابعها وكيل آخر.946,569+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
فرز أولي
نقل المشكلات وطلبات السحب الخارجية عبر آلة حالة لأدوار الفرز، وتصنيفها، والتحقق منها، والتدقيق فيها عند الحاجة، وكتابة ملخصات جاهزة للوكلاء.881,979+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تعليم
علم المستخدم مهارة أو مفهوما جديدا ضمن مساحة العمل هذه.778,928+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في الإنتاجية والمكتب