أنابيب CI/CD لـ Swift: الإعداد من الصفر على macOS و Linux

مشروع Swift الخاص بك يستحق أتمتة سحابية: بناء CI/CD من الصفر

لقد كتبت حزمة Swift أو تطبيقًا رائعًا. الكود يعمل بسلاسة، والاختبارات تمر محليًا، وتشعر وكأنك نجم. ولكن بمجرد أن تقوم بعمل push، يبدأ الكابوس: "هل سيعمل على Linux؟"، "هل ستنجح الاختبارات على macOS؟"، "ماذا لو نسيت تشغيل SwiftLint؟".

هل يبدو هذا مألوفًا؟ إذا كانت الإجابة بنعم، فأنت بحاجة إلى أنابيب CI/CD لـ Swift. إنها مثل الطيار الآلي للكود الخاص بك: تقوم تلقائيًا بالبناء والاختبار والتحقق من الأسلوب وحتى النشر. في هذه المقالة، سنقوم بإعداد أنابيب CI/CD لـ Swift من الصفر باستخدام GitHub Actions. ستحصل على كود جاهز للعمل يمكنك نسخه واستخدامه اليوم.

تلميح: بعد الإعداد، ستحصل على علامات خضراء لكل commit، بدلاً من القلق أمام الشاشة.

لماذا CI/CD لـ Swift ليس رفاهية بل ضرورة

Swift يعيش في عالمين: macOS (Xcode, CocoaPods, Carthage) و Linux (Vapor, SwiftNIO, مشاريع الخادم). بدون CI/CD، أنت تخاطر بـ:

\n
• تفويت خطأ في الترجمة على منصة أخرى
\n
• نسيان تشغيل المدقق (ثم يبدو الكود وكأنه بعد قصف)
\n
• إضاعة ساعات في النشر اليدوي
\n
• إضاعة الوقت في البحث عن الأخطاء التراجعية
\n

أنابيب CI/CD لـ Swift المُعدة بشكل صحيح تحل كل هذه المشاكل. إنها تعمل 24/7، لا تشرب القهوة ولا تقول "إنه يعمل لدي". هيا بنا!

الخطوة 1: اختيار الأداة — GitHub Actions

سنستخدم GitHub Actions — وهي أداة CI/CD مدمجة في GitHub، وهي مثالية لـ Swift. الأسباب:

\n
• مجانية للمستودعات العامة (2000 دقيقة شهريًا)
\n
• مشغلات macOS — يمكن البناء تحت Xcode
\n
• مشغلات Linux — لمشاريع Swift الخادمية
\n
• إجراءات جاهزة لـ SwiftLint والاختبار والنشر
\n

إذا كنت تستخدم GitLab أو Bitbucket أو Jenkins — المبادئ هي نفسها، لكن بناء جملة YAML سيختلف.

الخطوة 2: الهيكل الأساسي لأنابيب CI/CD لـ Swift

أي pipeline يتكون من ثلاث مراحل:

\n
1. Build — بناء المشروع (SPM أو Xcode)
\n
2. Test — تشغيل اختبارات الوحدة
\n
3. Lint — التحقق من أسلوب الكود (اختياري لكن موصى به بشدة)
\n

يمكنك أيضًا إضافة النشر (مثل الخادم أو TestFlight).

إنشاء ملف .github/workflows/swift-ci.yml

في جذر المستودع الخاص بك، أنشئ مجلد .github/workflows/ وداخله ملف swift-ci.yml. إليك الحد الأدنى من pipeline العملي:

name: Swift CI/CD Pipeline\n\non:\n  push:\n    branches: [ main, develop ]\n  pull_request:\n    branches: [ main ]\n\njobs:\n  build-and-test:\n    runs-on: ubuntu-latest\n\n    steps:\n    - name: Checkout code\n      uses: actions/checkout@v3\n\n    - name: Setup Swift\n      uses: swift-actions/setup-swift@v1\n      with:\n        swift-version: "5.9"\n\n    - name: Build\n      run: swift build\n\n    - name: Run tests\n      run: swift test

هذه أنابيب CI/CD لـ Swift تعمل عند كل push أو pull request إلى main/develop. تقوم ببناء المشروع وتشغيل الاختبارات على Ubuntu. بسيط؟ نعم. لكن دعنا نضيف بعض السحر.

الخطوة 3: إضافة macOS و Xcode إلى مصفوفة البناء

مطورو Swift غالبًا ما يعملون على macOS، بينما الجزء الخادمي على Linux. للتأكد من أن المشروع يُبنى في كل مكان، نستخدم مصفوفة الاستراتيجيات (matrix strategy):

jobs:\n  build-and-test:\n    strategy:\n      matrix:\n        os: [ubuntu-latest, macos-latest]\n        swift-version: ["5.8", "5.9"]\n\n    runs-on: ${{ matrix.os }}\n\n    steps:\n    - uses: actions/checkout@v3\n\n    - name: Setup Swift\n      uses: swift-actions/setup-swift@v1\n