تثبيت Xcode 26 وضبط بيئة Swift على macOS

📘 الدليل الرئيسي للسلسلة: تطوير تطبيق iOS بـ Swift وSwiftUI: بانوراما 2026. هذا المقال جزء من سلسلة تدريجية للانطلاق في iOS.

قبل كتابة سطر Swift واحد، يلزم بيئة عمل وظيفية. تبدو هذه الخطوة أحيانًا تفصيلًا لكنّها تُحدِّد كلّ ما يليها: Xcode سيّء الضبط يحجب البِنى، simulators غائبة تمنع الاختبار، حساب Apple Developer غير مرتبط يمنع النشر على جهاز مادي. يُفَصِّل هذا الدليل خطوة بخطوة تثبيت Xcode 26 على macOS Tahoe وتحضير حساب Apple Developer، حتى تشغيل أوّل مشروع SwiftUI على simulator iOS.

المتطلّبات

• Mac بـ macOS Tahoe 26.2 أو أحدث (لـ Xcode 26.4 وأحدث) — Mac بمعالج Apple Silicon موصى به بشدّة.
• 50 جيغا حرّة كحدّ أدنى على قرص النظام (Xcode يزن نحو 15 جيغا، كلّ simulator يُضيف 5 إلى 10 جيغا).
• Apple ID نشط (المُستعمَل على iCloud يفي بالغرض).
• اتّصال إنترنت مستقرّ: التنزيل الأوّلي يتجاوز 8 جيغا.
• المستوى: لا متطلّبات Swift؛ معرفة أساسية بـ macOS موصى بها.
• الوقت المتوقّع: 45 إلى 90 دقيقة حسب عرض النطاق.

الخطوة 1 — التحقّق من نسخة macOS

Xcode 26 يرفض التثبيت على macOS قديم. قبل الانخراط في تنزيل عدّة جيغابايت، التحقّق من النسخة الدقيقة يتفادى خيبة الأمل بعد ساعة. الأمر sw_vers يُعطي المعلومة في سطر واحد.

sw_vers

الخرج يشبه ProductName: macOS / ProductVersion: 26.4 / BuildVersion: 25E456. قيمة ProductVersion يجب أن تكون 26.2 على الأقلّ لتثبيت Xcode 26.4 أو أحدث. إن كانت النسخة المعروضة أقلّ (مثل 15.6 أو 14.x)، مرّ عبر Réglages Système ← Général ← Mise à jour de logiciel للانتقال إلى macOS Tahoe. التحديث يزن نحو 12 جيغا ويستغرق 30 إلى 60 دقيقة.

الخطوة 2 — تنزيل Xcode من Mac App Store

تعرض Apple مسارَي تنزيل رسميَّين. Mac App Store الأبسط ويستفيد من تحديثات تلقائية. بوّابة Apple Developer تُتيح استرداد نسخة محدّدة. لأوّل انطلاق، Mac App Store يفي بالغرض.

# يفتح Mac App Store مباشرة على صفحة Xcode
open "macappstore://itunes.apple.com/app/id497799835"

هذا الأمر يُشَغِّل App Store مباشرة على بطاقة Xcode. النقر على « Obtenir » ثم « Installer » يُشَغِّل التنزيل. شريط التقدّم يظهر في Launchpad تحت أيقونة Xcode. على اتّصال 100 Mbps، احسب 12 إلى 18 دقيقة. التنزيل قابل للإيقاف من Launchpad؛ يستأنف تلقائيًّا في الجلسة التالية.

الخطوة 3 — أوّل فتح وقبول الترخيص

بعد تثبيت Xcode، أوّل تشغيل يُشغّل عدّة خطوات خفيّة: قبول ترخيص Apple، تثبيت مكوّنات إضافية (toolchains، platforms)، تسجيل أدوات سطر الأوامر. فتحه من Spotlight أو Launchpad يُشَغِّل العملية.

open -a Xcode

في أوّل تشغيل، نافذة تطلب قبول Apple Developer Agreement. النقر على Agree يتطلّب كلمة سرّ المدير. نافذة ثانية تقترح تثبيت Additional Components: ثبِّت دون تردّد. هذه الخطوة تُثَبِّت toolchains الترجمة وتُمَثِّل 3 إلى 5 جيغا إضافية. في النهاية، شاشة Welcome to Xcode تظهر بثلاثة خيارات: Create New Project، Open Existing Project، Clone Git Repository.

الخطوة 4 — تثبيت simulators iOS اللازمة

افتراضيًّا، Xcode 26 يُضَمِّن فقط simulator iOS 26 الأحدث. للاختبار على نسخ سابقة (iOS 18، iOS 17)، يجب تنزيل simulator runtimes إضافية. هذه runtimes تزن 5 إلى 8 جيغا لكلّ منها؛ لا تُنزِّل سوى الضرورية.

# إدراج runtimes المثبَّتة
xcrun simctl list runtimes

# تنزيل platform من CLI (بديل عن UI)
xcodebuild -downloadPlatform iOS

الأمر xcrun simctl list runtimes يعرض كلّ runtime متاح بحالته (Ready، Downloading، Not Installed). الأمر xcodebuild -downloadPlatform iOS يُنزِّل أحدث simulator iOS من سطر الأوامر، مفيد لـ pipelines CI. للتثبيت التفاعلي، افتح Xcode ثم Settings ← Components ← Platforms وعَلِّم النسخ المرغوبة.

الخطوة 5 — إنشاء حساب Apple Developer (مجاني أو مدفوع)

لتشغيل app على simulator، لا حاجة لحساب Apple Developer — Apple ID المُستعمَل على Mac يكفي. لنشره على iPhone فيزيائي بصلاحية 7 أيّام، نفس Apple ID المجاني يعمل عبر Free Provisioning. للنشر على App Store أو استعمال TestFlight، يُطلَب اشتراك سنوي بـ 99 USD.

التسجيل في البرنامج المدفوع يتمّ على developer.apple.com/programs/enroll/. Apple تطلب بطاقة هويّة، تُصادِق على التسجيل خلال 24 إلى 72 ساعة، وتفوتر بالبطاقة المصرفية أو Apple Pay. لمشروع تعلّم أوّل، الخيار المجاني يكفي؛ الانتقال إلى المدفوع ينتظر مرحلة التوزيع.

الخطوة 6 — ضبط حساب Apple ID في Xcode

على Xcode أن يعرف Apple ID واحدًا على الأقلّ لإدارة توقيع البِنى. دون هذه الخطوة، تشغيل app على iPhone فيزيائي يفشل برسالة « No signing certificate found ».

# فتح تفضيلات Xcode > Accounts مباشرة
open -a Xcode --args -ApplePersistenceIgnoreState YES

بعد فتح Xcode، انتقل في Xcode ← Settings ← Accounts وانقر زرّ + أسفل اليسار، اختر Apple ID، ثم أدخل المُعَرِّف وكلمة السرّ. Apple ترسل كود تحقّق ثنائي إلى الأجهزة الأخرى للحساب؛ إدخاله يُصادِق على الإضافة. بمجرّد ربط الحساب، العمود الأيمن يعرض الـ teams التي ينتمي إليها Apple ID (personal team للـ free provisioning، أو team المدفوع).

الخطوة 7 — إنشاء مشروع « Hello SwiftUI »

حان الوقت للتحقّق من عمل السلسلة كاملة. مشروع عرض فارغ يُولَّد من قائمة الترحيب في Xcode ويُتيح التحقّق سريعًا من الإعداد.

من شاشة Welcome to Xcode، انقر Create New Project. في مُحَدِّد القوالب، اختر iOS ← App ثم انقر Next. املأ الحقول:

Product Name:            HelloSwiftUI
Team:                    اختر personal team المرتبط بـ Apple ID
Organization Identifier: com.example (أو domain معكوس تتحكّم به)
Interface:               SwiftUI
Language:                Swift
Storage:                 None
Include Tests:           مُعَلَّم (مفيد لاحقًا)

انقر Next، اختر مجلّد الوجهة (مثل ~/Developer)، أزِل علامة Create Git repository إن لم يُرَد Git، ثم Create. Xcode يفتح المشروع على ملفّ ContentView.swift الذي يحوي view مبسّطة.

الخطوة 8 — تشغيل المشروع على simulator

هذه الخطوة تُغلق التثبيت: إن ظهر المشروع على simulator، البيئة تعمل. شريط Xcode العلوي يحوي قائمة منسدلة تختار وجهة البناء.

انقر القائمة على يمين اسم المشروع (افتراضيًّا تعرض Any iOS Device أو My Mac) واختر iPhone 16 Pro (iOS 26.5) أو أيّ simulator iOS حديث. ثم انقر زرّ Run المثلّث (أو الاختصار ⌘R).

Simulator يُقلِع في نافذة جديدة. الإقلاع الأوّل يستغرق 1 إلى 3 دقائق — وقت تهيئة iOS في simulator. الإقلاعات التالية شبه فورية. بمجرّد ظهور شاشة الترحيب، app HelloSwiftUI تظهر وتعرض النصّ « Hello, world! » مُتَمَركَزًا. إن ظهرت هذه الصورة، التثبيت مُصادَق عليه.

الخطوة 9 — التحقّق من أدوات سطر الأوامر

Xcode يُثَبِّت مجموعة أدوات CLI تستعملها pipelines البناء، مديرو الحزم، والأدوات الخارجية. التحقّق من حضورها يتفادى مفاجآت عند إضافة Swift Package أو تشغيل سكريبت بناء آلي.

xcode-select -p
swift --version
swiftc --version
xcodebuild -version

الأمر xcode-select -p يجب إرجاع المسار /Applications/Xcode.app/Contents/Developer. swift --version يعرض مثلًا Apple Swift version 6.3.2. إن أرجع الأمر « xcrun: error: invalid active developer path »، شَغِّل sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer لتوجيه CLI نحو التثبيت الصحيح.

أخطاء شائعة عند التثبيت

أسئلة شائعة

كم مساحة قرص يستهلك Xcode 26 فعلًا؟ app Xcode يزن نحو 15 جيغا بعد التثبيت. كلّ simulator runtime يُضيف 5 إلى 10 جيغا. Derived Data (caches البناء) تنمو سريعًا وقد تتجاوز 20 جيغا على مشروع نشط. المجموع الواقعي 50 إلى 80 جيغا لاستعمال منتظم.

هل يجب دفع 99 USD لتعلّم Swift؟ لا. simulator iOS وfree provisioning يكفيان للتعلّم والنمذجة وحتى عرض app على الأصدقاء (بتثبيتها على جهازهم لـ 7 أيّام). الاشتراك المدفوع يصير مفيدًا عند التوزيع عبر TestFlight أو النشر على App Store.

هل يمكن تثبيت عدّة نسخ من Xcode بجانب بعضها؟ نعم. إعادة تسمية نسخة مثبَّتة إلى Xcode-26.3.app قبل تثبيت جديدة يُتيح الإبقاء على الاثنين في مجلّد Applications. الأمر xcode-select --switch يُبَدِّل بين النسخ لبِنى CLI.

التثبيت فشل وApp Store لم يعد يعرض زرّ « Installer » اذهب إلى Launchpad، حدِّد أيقونة Xcode (غالبًا رمادية ومُلَقَّبة « En attente »)، نقرة طويلة ثم النقر على × للإلغاء. عُد إلى بطاقة App Store، الزرّ يعود. وإلّا، إعادة تشغيل Mac تحلّ الانسداد عادةً.

simulator بطيء جدًّا في أوّل إقلاع، هل هذا طبيعي؟ نعم. iOS يُهَيَّأ في simulator (أوّل boot، فهرسة Spotlight، خدمات النظام). أوّل إقلاع يستغرق 2 إلى 4 دقائق. الإقلاعات التالية شبه فورية بفضل snapshot boot.

مشروعي لم يعد يُجَمَّع بعد تحديث Xcode شائع في كلّ قفزة كبيرة (مثل Xcode 26.3 ← 26.4). ثلاثة إجراءات تحلّ 90% من الحالات: Clean Build Folder بـ ⇧⌘K؛ احذف مجلّد ~/Library/Developer/Xcode/DerivedData؛ تحقّق من نسخة Swift المطلوبة في Build Settings ← Swift Language Version.

الفرق بين Apple ID وApple Developer Account؟ Apple ID هو المُعَرِّف العامّ (iCloud، App Store، مشتريات). Apple Developer Account دور إضافي مُلحَق بـ Apple ID يفتح وصول الموارد التطويرية (تنزيلات، beta SDK، App Store Connect). يمكن أن تكون Apple ID دون أن تكون مطوّرًا؛ لا يمكن أن تكون مطوّرًا دون Apple ID.

الأدلّة الموصى بها بعد هذا

بمجرّد عمل البيئة، اتّجاهان مفتوحان: التعرّف على اللغة قبل مهاجمة الواجهة، أو البدء فورًا بـ SwiftUI.

• إتقان أساسيات لغة Swift 6: types وoptionals ودوالّ — الموصى به لمن لم يكتب Swift أبدًا.
• بناء أوّل view SwiftUI — الموصى به لمن يُتقن لغة مكتَّبة حديثة (Kotlin، TypeScript، Rust).

مصادر رسمية

• صفحة Xcode الرسمية — النسخ، الجديد، والتنزيل.
• متطلّبات Xcode — مصفوفة macOS / Xcode.
• Apple Developer Program — تفاصيل الاشتراك المدفوع.
• Installing Xcode and Simulators — الإجراء الرسمي خطوة بخطوة.

🔝 العودة إلى الدليل الرئيسي.

مقالات ذات صلة

• تثبيت Python 3 وإعداد بيئة التطوير
• تثبيت Flutter SDK وضبط بيئة التطوير
• تثبيت Redis 8 على Linux وضبط RDB + AOF خطوة بخطوة
• تثبيت Proxmox VE 9.1 على خادم منزلي خطوة بخطوة