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 البيانات إلى API App Store Connect وترفع الملف الثنائي وتبدأ عملية التحقق من البناء على جانب Apple.

تستخدم Deliver API App Store Connect لجميع العمليات، مما يضمن التوافق مع أحدث متطلبات Apple ويزيل استخدام الواجهات الخاصة. API App Store Connect هي واجهة REST الرسمية من Apple لأتمتة عمليات التطبيقات، بما في ذلك رفع البناءات وإدارة البيانات الوصفية وتتبع حالة المراجعة.

رفع الملفات الثنائية

تتكامل Deliver مباشرة مع Gym عبر Fastlane: بعد بناء IPA، تقوم Deliver برفعه إلى App Store Connect وبدء المعالجة. المعامل --ipa يحدد مسار الملف الثنائي. إذا لم يتم تحديده، تجد Deliver تلقائيًا آخر IPA في دليل البناء المحدد في Gymfile أو الذي تم تمريره عبر خطوات Fastlane السابقة.

بعد الرفع، تنتظر Deliver اكتمال معالجة Apple للملف الثنائي — بشكل مشابه لـ Pilot، يتم تتبع الحالة عبر شريط التقدم. الحالات المتاحة: Processing و Waiting For Review و In Review و Ready For Sale أو Rejected. تُخطر Deliver الفريق بكل تغيير في الحالة من خلال الاستدعاءات في Fastfile.

إدارة البيانات الوصفية للتطبيق

تدير Deliver المجموعة الكاملة من البيانات الوصفية للتطبيق: الاسم والوصف (القصير والكامل) والكلمات المفتاحية وعناوين URL للدعم والتسويق والفئة وتصنيف العمر. البيانات الوصفية للتطبيق هي المعلومات النصية حول التطبيق التي تظهر على صفحة App Store وتستخدم لفهرسة البحث وتحسين ASO.

المعامل --submit_for_review يرسل التطبيق للإشراف فورًا بعد رفع البيانات الوصفية. هذا معامل رئيسي للإصدارات المؤتمتة بالكامل. بدونه، تقوم Deliver فقط برفع البيانات ولكن لا ترسل التطبيق للمراجعة — وهذا مفيد للتحقق المسبق من جميع الحقول قبل الإرسال الفعلي.

العمل مع لقطات الشاشة

تقوم Deliver تلقائيًا برفع لقطات الشاشة لجميع تركيبات الأجهزة واللغات من الدليل المحدد. يجب أن تتبع أسماء الملفات النمط: iPhone_6.5_01.png لجهاز iPhone مقاس 6.5 بوصة في الفتحة الأولى. تحدد Deliver حجم لقطة الشاشة وتطابقه مع متطلبات Apple لكل نوع جهاز.

يتم رفع لقطات الشاشة بالترتيب الصحيح وبشكل منفصل لكل لغة توطين. إذا لم يتم العثور على لقطات شاشة للغة ما، تستخدم Deliver النسخ الإنجليزية كبديل. توطين لقطات الشاشة هو متطلب إلزامي للتطبيقات التي تريد تصنيفًا جيدًا في App Store عبر البلدان المختلفة، حيث تأخذ Apple في الاعتبار المحتوى المحلي في نتائج البحث.

# أمر الرفع الأساسي إلى App Store
fastlane deliver

# الرفع مع تحديد البيانات الوصفية ولقطات الشاشة
fastlane deliver --ipa "build/MyApp.ipa" \
      --force --submit_for_review

# معاينة دون رفع
fastlane deliver --preview

تكوين Deliver عبر Deliverfile

Deliverfile هو ملف تكوين Fastlane لتخزين البيانات الوصفية للتطبيق بتنسيق Ruby منظم. بخلاف ملء النماذج يدويًا في 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 في وقت واحد.

لرفع لقطات الشاشة، يُستخدم دليل screenshots داخل مجلد Fastlane. بنية المجلدات: 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 هو عملية CI/CD كاملة لنظام iOS تؤتمت جميع المراحل من الالتزام إلى النشر في App Store. يتضمن خط الأنابيب النموذجي: Match للشهادات و Gym لبناءات IPA و Snapshot للقطات الشاشة و Deliver لرفع جميع البيانات إلى App Store Connect مع الإرسال اللاحق للإشراف.

ميزة رئيسية لـ 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”، التطبيق غير موجود في App Store Connect باستخدام apple_identifier المحدد. الحل: أنشئ إدخال التطبيق في App Store Connect عبر الواجهة قبل أول استدعاء لـ Deliver، مع تحديد Bundle Identifier والاسم. لا تنشئ Deliver تطبيقات جديدة — إنها فقط تحدث الإدخالات الموجودة في المتجر.