Deliver (Fastlane) — یہ کیا ہے، App Store پر اپ لوڈ اور iOS اور Android ڈیولپمنٹ میں کنفیگریشن

Deliver (Fastlane) کیا ہے؟

Deliver (Fastlane) Fastlane ایکو سسٹم کا ایک جزو ہے جو App Store میں موبائل ایپلیکیشنز کی اشاعت کے عمل کو خودکار کرتا ہے۔ یہ بائنری فائل اپ لوڈ، میٹا ڈیٹا اپ ڈیٹ (نام، تفصیل، کلیدی الفاظ)، اسکرین شاٹ اپ لوڈ اور تمام مقامی کاری زبانوں کے لیے قیمت کے تعین کی کنفیگریشن کو سنبھالتا ہے۔

Deliver کے بغیر، ہر ریلیز کے لیے App Store Connect ویب انٹرفیس کے ذریعے دستی طور پر معلومات کو اپ ڈیٹ کرنے کی ضرورت ہوتی ہے: متعدد زبانوں میں تفصیل پُر کرنا، ہر اسکرین سائز کے لیے اسکرین شاٹس اپ لوڈ کرنا، کلیدی الفاظ اپ ڈیٹ کرنا اور قیمت کا تعین کنفیگر کرنا۔ App Store اشاعت iOS ایپلیکیشن لائف سائیکل کا آخری مرحلہ ہے، جس میں بائنری فائل کی تصدیق، مواد کی نگرانی اور ایپلیکیشن کو پروڈکشن میں دستیاب کرانا شامل ہے۔

App Store Connect دستاویزات (2025) کے مطابق، باقاعدہ اپ ڈیٹس والی ایپلیکیشنز کو 30% زیادہ دوبارہ انسٹالیشن ملتی ہیں اور تلاش کے نتائج میں بہتر درجہ بندی ہوتی ہے۔ Deliver ٹیموں کو معمول کے اشاعت کے مراحل کو خودکار کرکے اور درجنوں زبانوں میں میٹا ڈیٹا پُر کرتے وقت انسانی غلطی کے خطرے کو کم کرکے ہفتہ وار اپ ڈیٹس جاری کرنے کے قابل بناتا ہے۔

کسی بھی ایپلیکیشن کے لیے Deliver استعمال کریں جو App Store پر شائع ہوتی ہے — یہ خاص طور پر کثیر لسانی مقامی کاری والے منصوبوں کے لیے قیمتی ہے جہاں 32 زبانوں کو دستی طور پر اپ ڈیٹ کرنے میں کئی گھنٹے لگتے ہیں۔

Deliver App Store Connect کے ساتھ کیسے کام کرتا ہے

Deliver کا کام کرنے کا طریقہ کار دو مرحلے کے عمل پر مبنی ہے۔ پہلے مرحلے میں، ٹول میٹا ڈیٹا تیار کرتا ہے — یہ Deliverfile کی ساخت کی تصدیق کرتا ہے، اسکرین شاٹس لوڈ کرتا ہے اور تبدیلیوں کا اعلامیہ تیار کرتا ہے۔ دوسرے مرحلے میں، Deliver App Store Connect API کو ڈیٹا بھیجتا ہے، بائنری فائل اپ لوڈ کرتا ہے اور Apple کی جانب سے بلڈ کی تصدیق کا عمل شروع کرتا ہے۔

Deliver تمام کارروائیوں کے لیے App Store Connect API استعمال کرتا ہے، جو Apple کی تازہ ترین ضروریات کے ساتھ مطابقت کو یقینی بناتا ہے اور نجی انٹرفیس کے استعمال کو ختم کرتا ہے۔ App Store Connect API ایپلیکیشن کی کارروائیوں کو خودکار کرنے کے لیے Apple کی سرکاری REST API ہے، جس میں بلڈ اپ لوڈ، میٹا ڈیٹا کا انتظام اور جائزے کی حالت کی ٹریکنگ شامل ہے۔

بائنری فائل اپ لوڈ

Deliver Fastlane کے ذریعے Gym کے ساتھ براہ راست ضم ہوتا ہے: IPA بلڈ کے بعد، Deliver اسے App Store Connect پر اپ لوڈ کرتا ہے اور پروسیسنگ شروع کرتا ہے۔ --ipa پیرامیٹر بائنری فائل کا راستہ بتاتا ہے۔ اگر بتایا نہیں گیا تو، Deliver خود بخود Gymfile میں بتائے گئے یا پچھلے Fastlane مراحل کے ذریعے بھیجے گئے بلڈ ڈائریکٹری میں تازہ ترین IPA تلاش کرتا ہے۔

اپ لوڈ کے بعد، Deliver Apple کے بائنری پروسیسنگ کے مکمل ہونے کا انتظار کرتا ہے — Pilot کی طرح، حالت ایک پیش رفت بار کے ذریعے ٹریک کی جاتی ہے۔ دستیاب حالتیں: Processing، Waiting For Review، In Review، Ready For Sale یا Rejected۔ Deliver Fastfile میں کال بیکس کے ذریعے ٹیم کو ہر حالت کی تبدیلی کے بارے میں مطلع کرتا ہے۔

ایپلیکیشن میٹا ڈیٹا کا انتظام

Deliver ایپلیکیشن میٹا ڈیٹا کے مکمل سیٹ کا انتظام کرتا ہے: نام، تفصیل (مختصر اور مکمل)، کلیدی الفاظ، سپورٹ اور مارکیٹنگ URLs، زمرہ اور عمر کی درجہ بندی۔ ایپلیکیشن میٹا ڈیٹا ایپلیکیشن کے بارے میں متنی معلومات ہے جو App Store صفحہ پر ظاہر ہوتی ہے اور تلاش انڈیکسنگ اور ASO اصلاح کے لیے استعمال ہوتی ہے۔

--submit_for_review پیرامیٹر میٹا ڈیٹا اپ لوڈ کے فوراً بعد ایپلیکیشن کو نگرانی کے لیے بھیجتا ہے۔ یہ مکمل طور پر خودکار ریلیز کے لیے ایک اہم پیرامیٹر ہے۔ اس کے بغیر، Deliver صرف ڈیٹا اپ لوڈ کرتا ہے لیکن ایپلیکیشن کو جائزے کے لیے جمع نہیں کرتا — حقیقی جمع کروانے سے پہلے تمام فیلڈز کی پیشگی جانچ کے لیے مفید ہے۔

اسکرین شاٹس کے ساتھ کام کرنا

Deliver مخصوص کردہ ڈائریکٹری سے تمام آلات اور زبانوں کے امتزاج کے لیے خود بخود اسکرین شاٹس اپ لوڈ کرتا ہے۔ فائل کے ناموں کو پیٹرن کی پیروی کرنی چاہیے: پہلے سلاٹ میں 6.5 انچ iPhone کے لیے iPhone_6.5_01.png۔ Deliver اسکرین شاٹ کا سائز تعین کرتا ہے اور اسے ہر ڈیوائس کی قسم کے لیے Apple کی ضروریات سے ملاتا ہے۔

اسکرین شاٹس صحیح ترتیب میں اور ہر مقامی کاری زبان کے لیے الگ الگ اپ لوڈ ہوتے ہیں۔ اگر کسی زبان کے لیے اسکرین شاٹس نہیں ملتے ہیں تو، Deliver انگریزی ورژن کو متبادل کے طور پر استعمال کرتا ہے۔ اسکرین شاٹ مقامی کاری ان ایپلیکیشنز کے لیے لازمی ضرورت ہے جو مختلف ممالک کے App Store میں اچھی درجہ بندی حاصل کرنا چاہتی ہیں، کیونکہ Apple تلاش کے نتائج میں مقامی مواد کو مدنظر رکھتا ہے۔

# App Store میں بنیادی اپ لوڈ کمانڈ
fastlane deliver

# میٹا ڈیٹا اور اسکرین شاٹس بتا کر اپ لوڈ
fastlane deliver --ipa "build/MyApp.ipa" \
      --force --submit_for_review

# اپ لوڈ کے بغیر پیش نظارہ
fastlane deliver --preview

Deliverfile کے ذریعے Deliver کنفیگریشن

Deliverfile ایپلیکیشن میٹا ڈیٹا کو منظم Ruby فارمیٹ میں ذخیرہ کرنے کے لیے Fastlane کنفیگریشن فائل ہے۔ App Store Connect میں دستی طور پر فارم بھرنے کے برعکس، Deliverfile Git میں میٹا ڈیٹا کا ورژن کنٹرول اور اشاعت سے پہلے کوڈ جائزہ کے ذریعے تبدیلیوں کی تصدیق کرنے کی اجازت دیتا ہے۔

# Deliverfile — ایپلیکیشن میٹا ڈیٹا
app_identifier("com.company.app")
title("MyApp")
description("اسٹور کے لیے ایپلیکیشن تفصیل")
keywords("موبائل, ایپلیکیشن, ios, swift")
support_url("https://company.com/support")
marketing_url("https://company.com")
privacy_url("https://company.com/privacy")

# میٹا ڈیٹا مقامی کاری کی زبانیں
languages(["en-US", "ru", "de"])

languages پیرامیٹر تعین کرتا ہے کہ کن زبانوں کے لیے میٹا ڈیٹا اپ لوڈ کیا جائے گا۔ fastlane/metadata فولڈر میں ہر زبان کے لیے متعلقہ تفصیل، کلیدی الفاظ اور مارکیٹنگ ٹیکسٹ فائلوں کے ساتھ ایک الگ ڈائریکٹری بنائی جانی چاہیے۔ Deliver بیک وقت 32 App Store زبانوں کو سپورٹ کرتا ہے۔

اسکرین شاٹس اپ لوڈ کرنے کے لیے، Fastlane فولڈر کے اندر screenshots ڈائریکٹری استعمال ہوتی ہے۔ فولڈر کی ساخت: screenshots/[Language]/[DeviceType]_[ScreenSize]_[Number].png۔ Deliver مخصوص کردہ زبانوں اور آلات کے لیے خود بخود اسکرین شاٹس اپ لوڈ کرتا ہے، سائز کو Apple کی ضروریات سے ملاتا ہے۔ اسکرین شاٹس بنانے کے لیے Snapshot استعمال کرنے کی سفارش کی جاتی ہے — ان کا آؤٹ پٹ فارمیٹ Deliver کے ساتھ مطابقت رکھتا ہے۔

قیمت کا گروپ price_tier پیرامیٹر کے ذریعے کنفیگر کیا جاتا ہے، جو 0 سے 87 تک قیمت کی سطح کا نمبر قبول کرتا ہے۔ Apple کی قیمت کی سطحیں خود بخود تمام موجودہ ممالک کی کرنسیوں میں تبدیل ہو جاتی ہیں۔ Deliver ریلیز کے حصے کے طور پر قیمت تبدیل کرنے کی اجازت دیتا ہے، جو عارضی پروموشنز یا ایپلیکیشن کے کاروباری ماڈل میں تبدیلیوں کے لیے مفید ہے۔

ایپلیکیشنز کی اشاعت کے لیے Deliver کمانڈز

Deliver انٹرفیس میں میٹا ڈیٹا، بائنری فائلیں، اسکرین شاٹس اور مکمل ریلیز اپ لوڈ کرنے کے لیے کمانڈز شامل ہیں۔ بغیر پیرامیٹر کے مرکزی fastlane deliver کمانڈ، مکمل اشاعت کے چکر کے لیے Deliverfile اور میٹا ڈیٹا ڈائریکٹری سے ڈیٹا استعمال کرتی ہے۔

fastlane deliver --preview کمانڈ App Store Connect پر حقیقی اپ لوڈ کیے بغیر میٹا ڈیٹا کی پیشگی تصدیق چلاتی ہے۔ اپ لوڈ کے لیے --force ضروری ہے — اس کے بغیر، Deliver پیش نظارہ موڈ میں کام کرتا ہے۔ --skip_binary پیرامیٹر بائنری فائل اپ لوڈ کو چھوڑ کر صرف میٹا ڈیٹا اور اسکرین شاٹس اپ لوڈ کرتا ہے — نئی ریلیز کے بغیر ASO فیلڈز کو فوری طور پر اپ ڈیٹ کرنے کے لیے آسان۔

# بائنری اپ لوڈ کے ساتھ مکمل ریلیز
fastlane deliver --force --ipa "build/App.ipa"

# بائنری کے بغیر صرف میٹا ڈیٹا اپ لوڈ کریں
fastlane deliver --force --skip_binary

# صرف اسکرین شاٹس اپ ڈیٹ کریں
fastlane deliver --force --skip_metadata

--skip_metadata پیرامیٹر موجودہ میٹا ڈیٹا کو تبدیل کیے بغیر صرف اسکرین شاٹس اور بائنری فائل اپ لوڈ کرتا ہے۔ یہ ہاٹ فکس ریلیز کے لیے مفید ہے جب تفصیل اور ASO فیلڈز کو تبدیل کیے بغیر فوری طور پر درستگی جاری کرنے کی ضرورت ہو۔ فلیگ کا امتزاج ہر اشاعت کے مرحلے کو الگ الگ لچکدار طریقے سے منظم کرنے کی اجازت دیتا ہے۔

ریلیز پائپ لائن میں Deliver کو ضم کرنا

ریلیز پائپ لائن Deliver کے ساتھ iOS کے لیے ایک مکمل CI/CD عمل ہے جو کمٹ سے App Store اشاعت تک تمام مراحل کو خودکار کرتا ہے۔ ایک عام پائپ لائن میں شامل ہے: سرٹیفکیٹ کے لیے Match، IPA بلڈ کے لیے Gym، اسکرین شاٹس کے لیے Snapshot اور تمام ڈیٹا App Store Connect پر اپ لوڈ کرنے اور اس کے بعد نگرانی کے لیے جمع کروانے کے لیے Deliver۔

پائپ لائن میں Deliver کی ایک اہم خصوصیت metadata.json کی حمایت ہے، جو میٹا ڈیٹا کو منظم JSON فارمیٹ میں ذخیرہ کرتا ہے۔ یہ بیرونی CMS سسٹمز سے پروگرامیٹک طور پر میٹا ڈیٹا تیار کرنے یا ترجمہ API کے ذریعے متعدد زبانوں میں خود بخود تفصیل بنانے کی اجازت دیتا ہے۔

# Fastfile میں ریلیز پائپ لائن
lane :release do
    match(type: :appstore)
    capture_screenshots
    gym(scheme: "MyApp", export_method: "app-store")
    deliver(ipa: "build/MyApp.ipa", force: true, submit_for_review: true)
end

پائپ لائن میں Deliver کو کال کرنے سے پہلے، یقینی بنائیں کہ تمام میٹا ڈیٹا تازہ ترین ہے: تفصیل نئے ورژن سے میل کھاتی ہے، اسکرین شاٹس نئی خصوصیات کے لیے اپ ڈیٹ کیے گئے ہیں اور قیمت کے گروپ میں تبدیلی کی ضرورت نہیں ہے۔ Submit for review ایپلیکیشن کو Apple کی نگرانی میں بھیجتا ہے، جس میں نئی ایپلیکیشنز کے لیے 24 سے 48 گھنٹے اور اپ ڈیٹس کے لیے 2 سے 12 گھنٹے لگتے ہیں۔

Deliver app_version میکانزم کی حمایت کرتا ہے، جو میٹا ڈیٹا اپ ڈیٹس کے لیے ہدف ورژن بتانے کی اجازت دیتا ہے۔ اگر ورژن نہیں بتایا گیا تو، Deliver App Store Connect میں ایپلیکیشن کے موجودہ فعال ورژن کو اپ ڈیٹ کرتا ہے۔ نیا ورژن جاری کرنے کے لیے، App Store Connect انٹرفیس یا API کے ذریعے پہلے متعلقہ ورژن بنانا ضروری ہے۔

Deliver کے ساتھ کام کرتے وقت عام غلطیاں

Deliver استعمال کرتے وقت، ڈیولپرز کو اکثر میٹا ڈیٹا کی تصدیق کی غلطیاں، اسکرین شاٹ فائل کی غلط ساخت اور تصدیقی مسائل کا سامنا ہوتا ہے۔ غلطی کی تشخیص Deliver میں کمانڈ لاگز کے تجزیے سے شروع ہوتی ہے — Deliver ہر اپ لوڈ مرحلے اور مسترد کرنے کی وجوہات کے بارے میں تفصیلی معلومات فراہم کرتا ہے۔

“Invalid screenshot path” غلطی اس وقت ہوتی ہے جب اسکرین شاٹس کے فولڈر کی ساخت متوقع فارمیٹ سے مطابقت نہیں رکھتی۔ حل: چیک کریں کہ اسکرین شاٹ فائل کے نام پیٹرن DeviceType_ScreenSize_Number.png کی پیروی کرتے ہیں (مثال AppleiPhone15ProMax_6.7_01.png)۔ Deliver فائل کے ناموں میں کیس اور حد بندی کرنے والوں کے لیے حساس ہے۔

“Metadata validation failed” غلطی اشارہ کرتی ہے کہ میٹا ڈیٹا App Store کی ضروریات کو پورا نہیں کرتا۔ حل: تفصیل کی لمبائی (4000 حروف تک)، کلیدی الفاظ کی لمبائی (100 حروف تک) اور نام کی لمبائی (30 حروف تک) چیک کریں۔ App Store جائزے کے رہنما اصول میں میٹا ڈیٹا کے ہر فیلڈ کے لیے مکمل ضروریات ہیں — ہر ریلیز سے پہلے انہیں چیک کرنے کی سفارش کی جاتی ہے۔

“Apple ID not found” غلطی کے ساتھ، مخصوص کردہ apple_identifier کے ساتھ ایپلیکیشن App Store Connect میں موجود نہیں ہے۔ حل: پہلی Deliver کال سے پہلے ویب انٹرفیس کے ذریعے App Store Connect میں ایپلیکیشن کا اندراج بنائیں، Bundle Identifier اور نام بتاتے ہوئے۔ Deliver نئی ایپلیکیشنز نہیں بناتا — یہ صرف اسٹور میں موجودہ اندراجات کو اپ ڈیٹ کرتا ہے۔