Bitrise — المفاهيم الأساسية وسير العمل والتكامل المستمر

ما هو Bitrise؟

Bitrise هي منصة CI/CD أطلقت في عام 2016 ومركزة بالكامل على تطوير التطبيقات المحمولة. على عكس الحلول العامة مثل GitHub Actions وGitLab CI، صُممت Bitrise في الأصل لأتمتة بناء تطبيقات iOS وAndroid. تعمل المنصة في السحابة وتوفر خوادم بناء مستضافة خاصة بها مع macOS وLinux. تدعم Bitrise جميع بيئات التطوير المحمولة الشائعة: Swift وKotlin وFlutter وReact Native وCordova وXamarin.

الميزة الرئيسية لـ Bitrise هي قوالب Steps المهيأة مسبقاً للمهام النموذجية لتطوير التطبيقات المحمولة: بناء Xcode وتجميع Gradle وFastlane وFirebase Distribution وTestFlight وGoogle Play. إعداد خط الأنابيب يستغرق دقائق من خلال المحرر المرئي، ويتم إنشاء تكوين YAML تلقائياً في ملف bitrise.yml. للمستخدمين الخبراء، يتوفر محرر YAML مع الإكمال التلقائي.

هندسة Bitrise: Workflows وSteps

تعتمد هندسة Bitrise على مفهومين أساسيين: Workflow وStep. Workflow هو سلسلة من Steps تحدد خط الأنابيب. يمكن أن يحتوي كل مشروع على عدة Workflows: أساسي (بناء رئيسي)، نشر (نشر)، اختبار (اختبار فقط). يتم تشغيل Workflow بواسطة الأحداث: push وPR وtag أو وفقاً لجدول زمني. يمكن أيضاً تشغيل Workflows يدوياً من الواجهة الإلكترونية، وهو مفيد للبناءات المخصصة.

Step هي وحدة ذرية تؤدي مهمة واحدة. يمكن سحب Steps في المحرر المرئي وتغيير ترتيبها وتكوينها. توفر Bitrise Steps لأرشفة وتصدير Xcode وGradle Runner وتثبيت CocoaPods وFirebase Distribution وإشعارات Slack. كما ينشئ المجتمع Steps — وهي متاحة من خلال Step Library. كل Step لها معلمات إدخال إلزامية واختيارية، بالإضافة إلى متغيرات إخراج يمكن استخدامها بواسطة Steps اللاحقة.

تدعم Bitrise مفهوم Pipeline — دمج عدة Workflows في خط أنابيب واحد. يمكن أن يشمل Pipeline بناءات رئيسية لجميع المنصات وWorkflows منفصلة للنشر والاختبار. هذا يتيح إنشاء عمليات CI/CD معقدة حيث يؤدي بناء إلى تشغيل آخر. تحدد Stacks الخاصة بـ Bitrise البرامج المثبتة مسبقاً على خادم البناء: Xcode وAndroid SDK وFlutter وNode.js وأدوات أخرى.

Steps الشائعة للمشاريع المحمولة

• Xcode Archive & Export — بناء وتصدير IPA مع إدارة ملف التزويد
• Gradle Runner — تشغيل مهام Gradle مع الوسائط والتخزين المؤقت
• Flutter Build — بناء تطبيقات Flutter لنظامي iOS وAndroid
• Firebase App Distribution — نشر البناءات للمختبرين
• Certificate and Profile Installer — التثبيت التلقائي لشهادات توقيع الكود

دمج Bitrise مع مستودعات Git

تتكامل Bitrise مع GitHub وGitLab وBitbucket وAzure DevOps. عند توصيل مستودع، تكتشف Bitrise تلقائياً نوع المشروع (iOS أو Android أو Flutter) وتقترح قالب Workflow. للمستودعات الخاصة، تطلب Bitrise الوصول عبر OAuth أو مفتاح SSH. يمكن توصيل عدة مستودعات بتطبيق واحد.

بعد التوصيل، تنشئ Bitrise خطاف ويب في المستودع لبدء البناءات تلقائياً عند push وPR. كل بناء يحصل على رقم فريد وسجلات وقطع أثرية. تتيح الواجهة عرض تاريخ البناءات ومقارنة التغييرات وإعادة تشغيل البناءات الفاشلة. تدعم Bitrise أيضاً البناءات المجدولة للبناءات الليلية المنتظمة والتكامل مع Jira لتتبع الالتزامات.

توقيع الكود والنشر في App Store وGoogle Play

يعد توقيع الكود لنظام iOS من أصعب مهام CI/CD، وتقوم Bitrise بحلها بأبسط طريقة ممكنة. تخزن المنصة الشهادات وملفات التزويد بشكل مشفر، وتثبتها تلقائياً في keychain المناسب قبل البناء، وتصدر IPA الموقع. يقوم Step Certificate and Profile Installer بتنزيل الملفات من مخزن Bitrise وتكوين Xcode. الأنواع المدعومة من الشهادات: Development وAdHoc وAppStore وEnterprise.

للنشر في App Store Connect، توفر Bitrise Steps لرفع IPA عبر Xcode Archive & Export. النشر في Google Play يستخدم Gradle Runner مع التوقيع عبر Keystore، وبعد ذلك يتم رفع APK/AAB إلى Google Play Console عبر Google Play Deploy Step. لتوزيع Firebase App Distribution، يكفي تحديد رمز Firebase ومجموعة المختبرين. تقوم Bitrise بأتمتة تحديث رقم الإصدار ورقم البناء قبل كل نشر.

إعداد توقيع الكود في Bitrise

يتم تحميل الشهادات في قسم Code Signing بالواجهة الإلكترونية: P12 مع المفتاح الخاص وملف التزويد (.mobileprovision) وKeystore (.jks/.keystore) لنظام Android. تقوم Bitrise تلقائياً بتثبيت شهادات iOS في keychain عند كل تشغيل Workflow وتصدر التطبيق الموقع. لنظام Android، يكفي تحميل ملف Keystore — تقوم Bitrise بتمريره إلى Gradle عبر متغيرات البيئة أثناء البناء.

مثال تكوين Bitrise لتطبيق Flutter

لنلقِ نظرة على Workflow لتطبيق Flutter يقوم ببناء ونشر إصدارات iOS وAndroid. تكتشف Bitrise تلقائياً مشروع Flutter وتقترح Steps المناسبة. يشمل Workflow تثبيت Flutter وتخزين pub-cache المؤقت والبناء والاختبار والنشر. للبناءات iOS، يلزم بالإضافة إلى ذلك شهادات توقيع الكود، والتي تقوم Bitrise بتحميلها تلقائياً.

عند بناء تطبيقات Flutter، تدعم Bitrise تكويناً منفصلاً لكل منصة. بناءات Android تُنفذ على خادم بناء Linux مع Flutter SDK، ونظام iOS على خادم بناء macOS. يمكن أن يشمل Workflow Steps شرطية: build_android وbuild_ios، والتي تعمل فقط على المنصات المقابلة. لمشاريع React Native، تقدم Bitrise مجموعة مماثلة من Steps مع npm/nvm وMetro bundler.

format_version: 13
default_step_lib_source: https://github.com/bitrise-io/bitrise-steplib.git

trigger_map:
- push_branch: main
  workflow: primary

workflows:
  primary:
    steps:
    - activate-ssh-key@4:
        run_if: true
    - git-clone@8: {}
    - flutter-installer@0:
        inputs:
        - version: 3.24.0
    - flutter-build@0:
        inputs:
        - platform: both
        - ios_output_type: archive
    - deploy-to-bitrise-io@2: {}

Step مخصص للنشر

بعد البناء، يمكن إضافة Step لتوزيع Firebase App Distribution لنظامي iOS وAndroid. يقبل Step firebase_token وapp_id وtesters_group. تقوم Bitrise باستبدال القيم من Secrets — يضمن التخزين الآمن للرموز عدم ظهورها في السجلات.

- firebase-app-distribution@1:
    inputs:
    - firebase_token: $FIREBASE_TOKEN
    - app_id: $FIREBASE_IOS_APP_ID
    - testers_group: qa-team
    - release_notes: |
        Build $BITRISE_BUILD_NUMBER

Secrets وإدارة البيئة

الإدارة السليمة للبيانات السرية هي أساس أمان عمليات CI/CD. أسرار Bitrise مشفرة وغير قابلة للقراءة بعد الحفظ. عند إنشاء تطبيق جديد، تقدم Bitrise استيراد الأسرار من مشروع آخر أو تعيينها يدوياً. للفرق الكبيرة، تتوفر ميزة Environment Groups — إدارة مركزية للمتغيرات والأسرار لمجموعة من التطبيقات.

توفر Bitrise مخزناً مدمجاً للأسرار للبيانات السرية: مفاتيح API ورموز Firebase وكلمات مرور Keystore ومعرف Apple. تُعرف الأسرار كأزواج مفتاح-قيمة في الواجهة الإلكترونية ويتم إخفاؤها في سجلات البناء. وهي متاحة على مستوى التطبيق ومستوى Workflow. لا يمكن قراءة الأسرار بعد الحفظ — يمكن فقط استبدالها.

تُستخدم متغيرات البيئة (بدون علامة Secret) للتكوين: إصدار Xcode ومسار المشروع ونظام البناء. متغيرات بيئة Bitrise (BITRISE_BUILD_NUMBER، BITRISE_APP_TITLE) توفر معلومات وصفية عن البناء. يتم تشفير الأسرار أثناء التخزين وفك تشفيرها فقط على خادم البناء أثناء تنفيذ Workflow. للإدارة الجماعية للمتغيرات، تدعم Bitrise Environment Groups — مجموعات من المتغيرات قابلة للتطبيق على عدة تطبيقات في وقت واحد.

تستحق إدارة شهادات iOS عبر Bitrise اهتماماً خاصاً. تقوم المنصة تلقائياً بتثبيت P12 وملفات التزويد في keychain النظام قبل البناء. لنظام Android، يُستخدم ملف Keystore الذي يُحمّل في قسم Code Signing. يتم تخزين كل ملف شهادة بشكل مشفر وفك تشفيره فقط أثناء البناء.

مثال لاستخدام الأسرار

- google-play-deploy@3:
    inputs:
    - package_name: com.example.app
    - service_account_json_key: $SERVICE_ACCOUNT_KEY
    - app_file: $BITRISE_APK_PATH

بيئات Bitrise وStacks

تقدم Bitrise بيئات تطوير متنوعة للبناء — صور مثبتة مسبقاً بالأدوات وSDK. البيئات المتاحة تشمل Xcode (الإصدارات 14 و15 و16 مع iOS SDK 17 و18) وAndroid (بإصدارات مختلفة من SDK وNDK) وFlutter وReact Native وKotlin Multiplatform. كل بيئة لها وصف للأدوات والإصدارات المثبتة مسبقاً.

يؤثر اختيار البيئة على وقت البناء والتوافق مع المشروع. تقوم Bitrise بتحديث البيئات بانتظام، مضيفة إصدارات جديدة من الأدوات. يمكن تثبيت إصدار محدد من البيئة في bitrise.yml لتجنب التغييرات غير المتوقعة عند تحديث المنصة. للتبعيات المخصصة، يُستخدم Script Step الذي يقوم بتثبيت الحزم اللازمة قبل البناء الرئيسي. تدعم Bitrise أيضاً صور Docker لبيئات Linux، مما يتيح استخدام بيئات مخصصة للبناءات Android.