Pilot (Fastlane): بنیادی تصورات، TestFlight اور موبائل پروجیکٹس کے لیے بلڈ مینجمنٹ

Pilot (Fastlane) کیا ہے؟

Pilot (Fastlane) موبائل ایپلیکیشنز کے بیٹا ٹیسٹنگ کے لیے Apple کے پلیٹ فارم TestFlight کے ساتھ کام کو خودکار کرنے کے لیے Fastlane ایکو سسٹم کا ایک جزو ہے۔ Pilot تمام معمول کی کارروائیوں کو سنبھالتا ہے: بلڈ اپ لوڈ کرنا، ٹیسٹرز شامل کرنا، گروپس کا انتظام کرنا اور بلڈ اسٹیٹس کو ٹریک کرنا۔

Pilot کے بغیر، بیٹا تقسیم کا عمل اس طرح لگتا ہے: ڈیولپر دستی طور پر App Store Connect کھولتا ہے، ایپ منتخب کرتا ہے، Xcode Organizer کے ذریعے IPA اپ لوڈ کرتا ہے، ٹیسٹر گروپ کنفیگر کرتا ہے اور دعوت نامے بھیجتا ہے۔ TestFlight App Store میں سرکاری ریلیز سے پہلے ٹیسٹرز کو ایپلیکیشنز کے بیٹا ورژن تقسیم کرنے کے لیے Apple کی سروس ہے۔

App Store Connect Help (2025) کے مطابق، بیرونی ٹیسٹرز کو پہلے بلڈ انسٹالیشن سے پہلے Beta App Review کے عمل سے گزرنا ہوگا — اس میں 1 سے 48 گھنٹے لگتے ہیں۔ Pilot خود بخود جائزہ کی اسٹیٹس کو ٹریک کرتا ہے اور ٹیم کو مطلع کرتا ہے جب بلڈ بیرونی ٹیسٹر گروپس میں تقسیم کے لیے تیار ہوتا ہے۔

Pilot کو کسی بھی پروجیکٹ میں استعمال کریں جس میں ٹیسٹرز کو باقاعدگی سے بیٹا بلڈ فراہم کرنے کی ضرورت ہو — یہ iOS CI/CD پائپ لائنز کے لیے ایک معیاری ٹول ہے، جو پیش قیاسی ترسیل کے عمل کو یقینی بناتا ہے۔

TestFlight کے لیے Pilot کے اہم functions

Pilot کی فعالیت بیٹا بلڈ مینجمنٹ کے مکمل لائف سائیکل کا احاطہ کرتی ہے: بائنری فائل اپ لوڈ کرنے سے لے کر ٹیسٹرز کو نئے ورژن کے بارے میں مطلع کرنے تک۔ ہر فنکشن پیش قیاسی رویے اور ہر مرحلے کی تفصیلی لاگنگ کے ساتھ ایک علیحدہ کمانڈ کے طور پر عمل میں لایا جاتا ہے۔

TestFlight میں بلڈز اپ لوڈ کرنا

fastlane pilot upload کمانڈ IPA فائل کو App Store Connect میں اپ لوڈ کرتی ہے اور TestFlight میں نیا بلڈ بناتی ہے۔ Pilot خود بخود بائنری فائل کی درستگی، ورژن کی مطابقت اور ایپ شناخت کنندہ کی جانچ کرتا ہے۔ App Store Connect ایپلیکیشنز کے انتظام کے لیے Apple کا پلیٹ فارم ہے، جس میں بلڈ اپ لوڈ، میٹا ڈیٹا، تجزیات اور سیلز رپورٹس شامل ہیں۔

اپ لوڈ کے بعد، Pilot Apple کے بائنری فائل پروسیس کرنے کا انتظار کرتا ہے — بلڈ سائز کے لحاظ سے اس عمل میں 5 سے 30 منٹ لگتے ہیں۔ انتظار کے دوران، Pilot موجودہ پروسیسنگ اسٹیٹس کے بارے میں معلومات کے ساتھ پیش رفت بار دکھاتا ہے: Processing، Validating یا Ready۔ کامیاب پروسیسنگ کے بعد، بلڈ ٹیسٹر گروپس کو تفویض کرنے کے لیے دستیاب ہو جاتا ہے۔

ٹیسٹر گروپس کا انتظام

Pilot اندرونی اور بیرونی دونوں ٹیسٹر گروپس کے انتظام کی حمایت کرتا ہے۔ اندرونی ٹیسٹرز آپ کی Apple Developer ٹیم کے اراکین ہیں جو Beta App Review سے گزرے بغیر فوری طور پر بلڈز تک رسائی حاصل کرتے ہیں۔ بیرونی ٹیسٹرز ای میل کے ذریعے دعوت یافتہ صارفین ہیں، جنہیں پہلی تنصیب سے پہلے جائزہ کی منظوری درکار ہوتی ہے۔

fastlane pilot add کمانڈ ای میل یا Apple ID کے ذریعے گروپ میں نئے ٹیسٹرز شامل کرتی ہے۔ Pilot خود بخود دعوت نامے بھیجتا ہے اور چیک کرتا ہے کہ آیا ٹیسٹر نے دعوت قبول کی ہے۔ بڑی تعداد میں شامل کرنے کے لیے، آپ --testers_file_path پیرامیٹر کا استعمال کرتے ہوئے فائل سے ای میلز کی فہرست دے سکتے ہیں، جو سیکڑوں شرکاء کے ٹیسٹر گروپ کی ابتدائی تشکیل میں آسان ہے۔

# TestFlight میں نیا بلڈ اپ لوڈ کرنا
fastlane pilot upload --ipa "build/MyApp.ipa"

# گروپ میں ٹیسٹر شامل کرنا
fastlane pilot add --email "tester@company.com" \
      --groups "QA Team"

Pilot سیٹ اپ اور کنفیگریشن

Pilot کنفیگریشن کے لیے علیحدہ کنفیگریشن فائل کی ضرورت نہیں ہے — سیٹنگز Appfile (مشترکہ Fastlane فائل) یا کمانڈ لائن آرگیومنٹس کے ذریعے دی جاتی ہیں۔ اہم پیرامیٹرز میں ایپ کا apple_id، app_identifier، team_id اور App Store Connect API تک رسائی کے لیے اسناد شامل ہیں۔

تصدیق کے لیے، Pilot App Store Connect API Key (تجویز کردہ طریقہ) یا Apple ID دو عنصری تصدیق استعمال کرتا ہے۔ App Store Connect API Key ایک رسائی کلید ہے جو App Store Connect میں تیار ہوتی ہے اور انٹرایکٹو طور پر پاس ورڈ اور تصدیقی کوڈ داخل کیے بغیر API کے ساتھ تعامل کی اجازت دیتی ہے۔

# Appfile — Fastlane مشترکہ ترتیب
app_identifier("com.company.app")
apple_id("developer@company.com")
team_id("TEAM123456")

# Pilot کے لیے ماحول کے متغیرات
# APP_STORE_CONNECT_API_KEY_PATH=/path/to/key.p8

app_identifier پیرامیٹر ایپ کا Bundle Identifier متعین کرتا ہے، جو Xcode پروجیکٹ اور App Store Connect میں متعین کردہ شناخت کنندہ سے مماثل ہونا چاہیے۔ apple_id پیرامیٹر دو عنصری اسکیم میں تصدیق کے لیے استعمال ہوتا ہے، اور team_id — ڈیولپمنٹ ٹیم کے انتخاب کے لیے اگر اکاؤنٹ متعدد Apple Developer ٹیموں سے منسلک ہے۔

Pilot کے کام کرنے کے لیے، آپ کو CI/CD ماحول میں App Store Connect API Key ترتیب دینی ہوگی۔ کلید App Store Connect → Users and Access → Keys → Generate API Key میں تیار ہوتی ہے۔ .p8 فائل کو CI سسٹم سیکرٹس میں محفوظ کریں اور APP_STORE_CONNECT_API_KEY_PATH ماحول متغیر یا Pilot کمانڈز میں --api_key_path پیرامیٹر کے ذریعے راستہ بتائیں۔

بلڈ مینجمنٹ کے لیے Pilot کمانڈز

Pilot کمانڈز کا سیٹ تمام TestFlight منظرناموں کا احاطہ کرتا ہے: بلڈ اپ لوڈ کرنا، ٹیسٹرز کا انتظام کرنا، اسٹیٹس دیکھنا اور میٹا ڈیٹا ٹریک کرنا۔ ہر کمانڈ CI/CD اسکرپٹ میں مزید پروسیسنگ کے لیے ساختہ JSON آؤٹ پٹ لوٹاتی ہے۔

بلڈ اسٹیٹس دیکھنا

fastlane pilot builds کمانڈ ورژن، پروسیسنگ اسٹیٹس اور اپ لوڈ تاریخ کے ساتھ تمام ایپ بلڈز کی فہرست دکھاتی ہے۔ بلڈ اسٹیٹس مندرجہ ذیل میں سے ایک ہو سکتی ہے: Processing — Apple بائنری فائل پروسیس کر رہا ہے، Ready — بلڈ تقسیم کے لیے دستیاب ہے، Rejected — توثیق کی غلطیوں کی وجہ سے بلڈ مسترد کر دیا گیا۔

# TestFlight میں تمام بلڈز کی فہرست دیکھنا
fastlane pilot builds

# ٹیسٹر گروپ کو بلڈ تفویض کرنا
fastlane pilot distribute --build_number 42 \
      --groups "QA Team" --notify

# مخصوص بلڈ کے بارے میں معلومات دیکھنا
fastlane pilot build_info --build_number 42

fastlane pilot distribute کمانڈ بلڈ کو مخصوص ٹیسٹر گروپس کو تفویض کرتی ہے اور اطلاعات بھیجتی ہے۔ --notify پیرامیٹر نئے دستیاب بلڈ کے بارے میں ٹیسٹرز کو ای میل اطلاعات بھیجنے کے قابل بناتا ہے — یہ بیٹا ٹیسٹرز کو جانچ کے عمل میں شامل کرنے اور فیڈ بیک تیز کرنے کے لیے اہم ہے۔

بلڈ میٹا ڈیٹا کے انتظام کے لیے، --changelog پیرامیٹر استعمال کریں، جو نئے ورژن میں تبدیلیوں کی تفصیل کا متن متعین کرتا ہے۔ یہ متن TestFlight ایپ میں جانچ کی دعوت میں ٹیسٹرز کو دکھایا جاتا ہے۔ تجویز کی جاتی ہے کہ ہر بلڈ میں اہم تبدیلیاں، درست کیے گئے بگ اور نئی خصوصیات بتائی جائیں۔

CI/CD پائپ لائن میں Pilot کا انضمام

CI/CD میں Pilot iOS ایپ ترسیل پائپ لائن کا آخری مرحلہ ہے۔ Gym کے IPA بنانے اور ٹیسٹ پاس کرنے کے بعد، Pilot بلڈ کو TestFlight میں اپ لوڈ کرتا ہے اور ٹیسٹر گروپس میں تقسیم کرتا ہے۔ یہ QA ٹیموں کو ذخیرہ میں کمٹ کے منٹوں میں نیا ایپ ورژن حاصل کرنے کی اجازت دیتا ہے۔

ایک عام iOS CI/CD پائپ لائن میں ترتیب شامل ہے: Match (سرٹیفکیٹ)، Gym (IPA بلڈ)، Pilot (TestFlight میں اپ لوڈ اور تقسیم)۔ ہر مرحلہ پچھلے مرحلے پر منحصر ہے، اس بات کو یقینی بناتا ہے کہ صرف درست اور دستخط شدہ بلڈز ٹیسٹرز تک پہنچائے جائیں۔

# Fastfile میں مکمل پائپ لائن
lane :beta do
    match(type: :appstore)
    gym(scheme: "MyApp", export_method: "app-store")
    pilot("build/MyApp.ipa", groups: ["QA", "PM"])
end

اپ لوڈ کمانڈ میں skip_waiting پیرامیٹر CI کام میں Apple کی بائنری فائل پروسیسنگ مکمل ہونے کا انتظار نہ کرنے کی اجازت دیتا ہے — Pilot اپ لوڈ کی درخواست بھیجتا ہے، بلڈ شناخت کنندہ حاصل کرتا ہے اور ختم ہو جاتا ہے۔ یہ پائپ لائن کو تیز کرتا ہے کیونکہ پروسیسنگ میں 30 منٹ لگ سکتے ہیں، جو CI رنر میں انتظار میں ضائع نہیں ہوتے۔

CI میں Pilot کے صحیح کام کرنے کے لیے، آپ کو App Store Connect API کلید ترتیب دینی ہوگی۔ .p8 کلید فائل کو CI سسٹم کے محفوظ ذخیرہ میں محفوظ کریں اور APP_STORE_CONNECT_API_KEY_PATH ماحول متغیر کے ذریعے راستہ دیں۔ Pilot اس کلید کو دو عنصری تصدیق کے بغیر API میں تصدیق کے لیے استعمال کرتا ہے، جو خودکار منظرناموں کے لیے اہم ہے۔

Pilot کے ساتھ کام کرتے وقت عام مسائل

Pilot استعمال کرتے وقت، ڈیولپرز کو اکثر تصدیق کی غلطیاں، غلط ایپ کنفیگریشن اور Apple کی جانب سے بائنری فائل پروسیسنگ کے مسائل کا سامنا ہوتا ہے۔ Pilot مسئلہ تشخیص pilot builds کمانڈ کے ذریعے App Store Connect میں بلڈ اسٹیٹس چیک کرنے سے شروع ہوتا ہے۔

“Your app is not available for testing in TestFlight” غلطی اس وقت ہوتی ہے جب ایپ App Store Connect میں جانچ کے لیے ترتیب نہیں دی گئی ہے۔ حل: App Store Connect میں TestFlight سیکشن کھولیں، ایپ کے لیے جانچ فعال کریں اور یقینی بنائیں کہ Export Compliance آپ کی خفیہ کاری کی قسم کے لیے درست طریقے سے بھرا گیا ہے۔

“Missing iOS Distribution signing identity” غلطی Keychain میں Distribution سرٹیفکیٹ کی عدم موجودگی کی نشاندہی کرتی ہے۔ حل: Pilot کو کال کرنے سے پہلے صحیح سرٹیفکیٹ ڈاؤن لوڈ کرنے کے لیے Match چلائیں۔ ایک Distribution سرٹیفکیٹ Development سے مختلف ہوتا ہے — یہ TestFlight یا App Store کے ذریعے تقسیم کے لیے بنائے گئے بلڈز پر دستخط کرنے کے لیے استعمال ہوتا ہے۔

“Invalid Provisioning Profile” غلطی کے ساتھ، بلڈ میں منتخب ایکسپورٹ طریقہ کے لیے غلط پروفائل ہوتا ہے۔ حل: چیک کریں کہ Gym Match میں پروفائل کی قسم سے مماثل صحیح export_method استعمال کر رہا ہے۔ اگر بلڈ ڈیولپمنٹ پروفائل کے ساتھ بنایا گیا تھا، تو Pilot اسے TestFlight میں اپ لوڈ نہیں کر سکے گا — app-store یا ad-hoc پروفائل درکار ہے۔