Bitrise — کلیدی تصورات، Workflows اور مسلسل انضمام

Bitrise کیا ہے؟

Bitrise ایک CI/CD پلیٹ فارم ہے جو 2016 میں شروع کیا گیا اور مکمل طور پر موبائل ڈیولپمنٹ پر مرکوز ہے۔ GitHub Actions اور GitLab CI جیسی عالمگیر حل کے برعکس، Bitrise اصل میں iOS اور Android ایپ بلڈ کو خودکار بنانے کے لیے ڈیزائن کیا گیا تھا۔ پلیٹ فارم کلاؤڈ میں کام کرتا ہے اور macOS اور Linux کے ساتھ اپنے میزبان رنر فراہم کرتا ہے۔ Bitrise تمام مقبول موبائل اسٹیکس کو سپورٹ کرتا ہے: Swift، Kotlin، Flutter، React Native، Cordova اور Xamarin۔

Bitrise کا بنیادی فائدہ عام موبائل ڈیولپمنٹ کے کاموں (Xcode بلڈ، Gradle اسمبل، Fastlane، Firebase Distribution، TestFlight، Google Play) کے لیے پہلے سے ترتیب شدہ Step ٹیمپلیٹس ہیں۔ پائپ لائن سیٹ اپ بصری ایڈیٹر کے ذریعے منٹوں میں مکمل ہوتا ہے، اور YAML کنفیگریشن خود بخود bitrise.yml فائل میں تیار ہوتی ہے۔ تجربہ کار صارفین کے لیے، خودکار تکمیل کے ساتھ YAML ایڈیٹر دستیاب ہے۔

Bitrise کا فن تعمیر: Workflows اور Steps

Bitrise کا فن تعمیر دو اہم تصورات پر مبنی ہے: Workflow اور Step۔ ایک Workflow Steps کا ایک سلسلہ ہے جو پائپ لائن کی وضاحت کرتا ہے۔ ہر پروجیکٹ میں متعدد Workflows ہو سکتے ہیں: primary (مین بلڈ)، deploy (اشاعت)، test (صرف ٹیسٹ)۔ Workflow واقعات سے متحرک ہوتا ہے: push، PR، tag یا شیڈول کے مطابق۔ Workflows کو ویب انٹرفیس سے دستی طور پر بھی شروع کیا جا سکتا ہے، جو ایڈہاک بلڈز کے لیے مفید ہے۔

Step ایک ایٹمی ماڈیول ہے جو ایک واحد کام انجام دیتا ہے۔ Steps کو بصری ایڈیٹر میں گھسیٹ کر ان کی ترتیب اور کنفیگریشن تبدیل کی جا سکتی ہے۔ Bitrise Xcode Archive & Export، Gradle Runner، CocoaPods Install، Firebase Distribution اور Slack اطلاعوں کے لیے Steps فراہم کرتا ہے۔ کمیونٹی بھی Steps بناتی ہے — وہ Step Library کے ذریعے دستیاب ہیں۔ ہر Step میں لازمی اور اختیاری ان پٹ پیرامیٹرز کے ساتھ ساتھ آؤٹ پٹ متغیرات ہوتے ہیں جو بعد کے Steps استعمال کر سکتے ہیں۔

Bitrise Pipeline کے تصور کو سپورٹ کرتا ہے — ایک پائپ لائن میں متعدد Workflows کا امتزاج۔ ایک Pipeline میں تمام پلیٹ فارمز کے لیے بنیادی بلڈز اور ڈیپلائمنٹ اور ٹیسٹنگ کے لیے علیحدہ ورک فلو شامل ہو سکتے ہیں۔ یہ پیچیدہ CI/CD عمل بنانے کی اجازت دیتا ہے جہاں ایک بلڈ دوسرے کو متحرک کرتا ہے۔ Bitrise Stacks رنر پر پہلے سے نصب سافٹ ویئر (Xcode، Android SDK، Flutter، Node.js اور دیگر ٹولز) کا تعین کرتے ہیں۔

موبائل پروجیکٹس کے لیے مشہور Steps

• Xcode Archive & Export — پروویژننگ پروفائل مینجمنٹ کے ساتھ IPA بلڈ اور ایکسپورٹ
• Gradle Runner — آرگیومینٹس اور کیشنگ کے ساتھ Gradle ٹاسک چلانا
• Flutter Build — iOS اور Android کے لیے Flutter ایپس بلڈ کرنا
• Firebase App Distribution — ٹیسٹرز کے لیے بلڈز شائع کرنا
• Certificate and Profile Installer — کوڈ سائننگ سرٹیفکیٹس کی خودکار تنصیب

Git ریپوزٹریز کے ساتھ Bitrise انضمام

Bitrise GitHub، GitLab، Bitbucket اور Azure DevOps کے ساتھ مربوط ہوتا ہے۔ ریپوزٹری منسلک کرتے وقت، Bitrise خود بخود پروجیکٹ کی قسم (iOS، Android، Flutter) کا پتہ لگاتا ہے اور Workflow ٹیمپلیٹ تجویز کرتا ہے۔ نجی ریپوزٹریز کے لیے، Bitrise OAuth یا SSH کلید کے ذریعے رسائی کی درخواست کرتا ہے۔ ایک ایپلیکیشن سے متعدد ریپوزٹریز منسلک کی جا سکتی ہیں۔

کنکشن کے بعد، Bitrise push اور PR پر خود بخود بلڈ شروع کرنے کے لیے ریپوزٹری میں ایک ویب ہک بناتا ہے۔ ہر بلڈ کو ایک منفرد نمبر، لاگز اور آرٹیفیکٹس ملتے ہیں۔ انٹرفیس بلڈ ہسٹری براؤز کرنے، تبدیلیوں کا موازنہ کرنے اور ناکام بلڈز کو دوبارہ شروع کرنے کی اجازت دیتا ہے۔ Bitrise باقاعدہ راتوں رات بلڈز کے لیے شیڈولڈ بلڈز اور کمٹ ٹریکنگ کے لیے Jira انضمام کو بھی سپورٹ کرتا ہے۔

Code Signing اور App Store اور Google Play میں اشاعت

iOS کے لیے کوڈ سائننگ CI/CD کے سب سے پیچیدہ کاموں میں سے ایک ہے، اور Bitrise اسے ممکنہ حد تک آسان طریقے سے حل کرتا ہے۔ پلیٹ فارم سرٹیفکیٹس اور پروویژننگ پروفائلز کو خفیہ کردہ شکل میں ذخیرہ کرتا ہے، بلڈ سے پہلے انہیں خود بخود مناسب keychain میں انسٹال کرتا ہے اور دستخط شدہ IPA ایکسپورٹ کرتا ہے۔ Certificate and Profile Installer Step Bitrise اسٹوریج سے فائلیں ڈاؤن لوڈ کرتا ہے اور Xcode کو کنفیگر کرتا ہے۔ Development، AdHoc، AppStore اور Enterprise سرٹیفکیٹ اقسام سپورٹ ہیں۔

App Store Connect میں شائع کرنے کے لیے، Bitrise Xcode Archive & Export کے ذریعے IPA اپ لوڈ کرنے کے لیے Steps فراہم کرتا ہے۔ Google Play اشاعت Keystore دستخط کے ساتھ Gradle Runner استعمال کرتی ہے، جس کے بعد APK/AAB Google Play Deploy Step کے ذریعے Google Play Console میں اپ لوڈ ہوتا ہے۔ Firebase App Distribution کے لیے، صرف Firebase Token اور ٹیسٹر گروپ بتانا کافی ہے۔ Bitrise ہر اشاعت سے پہلے ورژن نمبر اور بلڈ نمبر اپ ڈیٹ کو خودکار بناتا ہے۔

Bitrise میں کوڈ سائننگ ترتیب دینا

سرٹیفکیٹس ویب انٹرفیس کے Code Signing سیکشن میں اپ لوڈ کیے جاتے ہیں: نجی کلید کے ساتھ P12، پروویژننگ پروفائل (.mobileprovision)، Android کے لیے Keystore (.jks/.keystore)۔ Bitrise خود بخود ہر Workflow رن پر iOS سرٹیفکیٹس کو keychain میں انسٹال کرتا ہے اور دستخط شدہ ایپلیکیشن ایکسپورٹ کرتا ہے۔ Android کے لیے، صرف Keystore فائل اپ لوڈ کریں — Bitrise بلڈ کے دوران ماحولیاتی متغیرات کے ذریعے Gradle کو بھیجتا ہے۔

Flutter کے لیے Bitrise کنفیگریشن کی مثال

آئیے ایک Flutter ایپلیکیشن کے لیے Workflow دیکھتے ہیں جو iOS اور Android کے لیے بلڈز بناتا اور شائع کرتا ہے۔ Bitrise خود بخود ایک Flutter پروجیکٹ کا پتہ لگاتا ہے اور مناسب Steps تجویز کرتا ہے۔ Workflow میں Flutter انسٹالیشن، pub-cache کیشنگ، بلڈ، ٹیسٹنگ اور ڈیپلائمنٹ شامل ہے۔ iOS بلڈز کے لیے، اضافی طور پر کوڈ سائننگ سرٹیفکیٹس درکار ہیں، جو Bitrise خود بخود لوڈ کرتا ہے۔

Flutter ایپس بلڈ کرتے وقت، Bitrise ہر پلیٹ فارم کے لیے علیحدہ کنفیگریشن سپورٹ کرتا ہے۔ Android بلڈز Flutter SDK کے ساتھ Linux رنر پر چلتے ہیں، iOS macOS رنر پر۔ ایک Workflow میں مشروط Steps شامل ہو سکتے ہیں: build_android اور build_ios، جو صرف اپنے اپنے پلیٹ فارم پر چلتے ہیں۔ React Native پروجیکٹس کے لیے، Bitrise npm/nvm اور Metro bundler کے ساتھ Steps کا ایک جیسا سیٹ پیش کرتا ہے۔

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

بلڈ کے بعد، iOS اور Android کے لیے Firebase App Distribution Step شامل کیا جا سکتا ہے۔ 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 Secrets خفیہ کردہ ہوتے ہیں اور محفوظ کرنے کے بعد پڑھے نہیں جا سکتے۔ نئی ایپلیکیشن بناتے وقت، Bitrise کسی دوسرے پروجیکٹ سے Secrets درآمد کرنے یا دستی طور پر سیٹ کرنے کی پیشکش کرتا ہے۔ بڑی ٹیموں کے لیے، Environment Groups فیچر دستیاب ہے — ایپلیکیشنز کے گروپ کے لیے متغیرات اور Secrets کا مرکزی انتظام۔

Bitrise خفیہ ڈیٹا (API کلیاں، Firebase ٹوکنز، Keystore پاس ورڈز، Apple ID) کے لیے بلٹ ان Secrets اسٹوریج فراہم کرتا ہے۔ Secrets ویب انٹرفیس میں کلید-قدر کے جوڑوں کے طور پر بیان کیے جاتے ہیں اور بلڈ لاگز میں ماسک کیے جاتے ہیں۔ یہ ایپلیکیشن سطح اور Workflow سطح پر دستیاب ہیں۔ Secrets محفوظ کرنے کے بعد پڑھے نہیں جا سکتے — صرف اوور رائٹ کیے جا سکتے ہیں۔

ماحولیاتی متغیرات (Secret نشان کے بغیر) کنفیگریشن کے لیے استعمال ہوتے ہیں: Xcode ورژن، پروجیکٹ پاتھ، بلڈ اسکیم۔ Bitrise ماحولیاتی متغیرات (BITRISE_BUILD_NUMBER، BITRISE_APP_TITLE) بلڈ کے بارے میں میٹا معلومات فراہم کرتے ہیں۔ Secrets ذخیرہ کرنے پر خفیہ کیے جاتے ہیں اور صرف Workflow پر عملدرآمد کے دوران رنر پر ڈکرپٹ کیے جاتے ہیں۔ متغیرات کے گروپ انتظام کے لیے، Bitrise Environment Groups کو سپورٹ کرتا ہے — متغیرات کے سیٹ جو ایک ساتھ متعدد ایپلیکیشنز پر لاگو ہوتے ہیں۔

Bitrise کے ذریعے iOS سرٹیفکیٹ کا انتظام خاص توجہ کا مستحق ہے۔ پلیٹ فارم خود بخود بلڈ سے پہلے P12 اور پروویژننگ پروفائلز کو سسٹم keychain میں انسٹال کرتا ہے۔ Android کے لیے، Keystore فائل استعمال ہوتی ہے، جو Code Signing سیکشن میں اپ لوڈ کی جاتی ہے۔ ہر سرٹیفکیٹ فائل خفیہ کردہ شکل میں محفوظ ہوتی ہے اور صرف بلڈ کے دوران ڈکرپٹ کی جاتی ہے۔

Secrets کے استعمال کی مثال

- 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 بلڈ کے لیے مختلف اسٹیکس (ٹولز اور SDKs کے ساتھ پہلے سے نصب امیجز) فراہم کرتا ہے۔ دستیاب اسٹیکس میں Xcode (ورژن 14، 15، 16 iOS SDK 17، 18 کے ساتھ)، Android (SDK اور NDK کے مختلف ورژنز کے ساتھ)، Flutter، React Native اور Kotlin Multiplatform شامل ہیں۔ ہر اسٹیک میں پہلے سے نصب ٹولز اور ورژنز کی تفصیل ہوتی ہے۔

اسٹیک کا انتخاب بلڈ کے وقت اور پروجیکٹ کی مطابقت کو متاثر کرتا ہے۔ Bitrise باقاعدگی سے اسٹیکس کو اپ ڈیٹ کرتا ہے، نئے ٹول ورژنز شامل کرتا ہے۔ پلیٹ فارم اپ ڈیٹ ہونے پر غیر متوقع تبدیلیوں سے بچنے کے لیے bitrise.yml میں اسٹیک کے ایک مخصوص ورژن کو فکس کیا جا سکتا ہے۔ کسٹم انحصار کے لیے، Script Step استعمال کیا جاتا ہے جو مین بلڈ سے پہلے ضروری پیکجز انسٹال کرتا ہے۔ Bitrise Linux اسٹیکس کے لیے Docker امیجز کو بھی سپورٹ کرتا ہے، جو Android بلڈز کے لیے کسٹم ماحول کی اجازت دیتا ہے۔