How to Upload Screenshots to App Store Connect (2026 Guide)
لا يزال رفع لقطات شاشة App Store أحد أكثر الأجزاء تعقيدًا في شحن تطبيق لنظام iOS أو iPadOS أو macOS. تدعم Apple أنواع عرض متعددة لكل منصة وكل لغة لها خانتها الخاصة، لذا فحتى التطبيق الصغير يمكن أن ينتهي به المطاف بـ 80-200 ملف لدفعها لكل إصدار. يغطي هذا الدليل أربع طرق عملية لرفع لقطات الشاشة إلى App Store Connect في عام 2026، ومتى تختار كل منها، والمشاكل التي قد تضيع عليك فترة ما بعد الظهيرة بأكملها إذا لم تكن على دراية بها مسبقًا.
الخيار 1: رافع الويب لـ App Store Connect
المسار الافتراضي. افتح تطبيقك في App Store Connect، واختر الإصدار الذي تريد تعديله، ثم مرر إلى لقطات الشاشة، واسحب ملفات PNG أو JPEG إلى مربع نوع العرض الصحيح (6.9"، 6.5"، iPad 13"، Mac، إلخ). كرر العملية لكل لغة.
- جيد لـ: التقديم الأول، أو تطبيق صغير بلغة واحدة أو لغتين، أو عندما تحتاج إلى معاينة ما سيراه المراجع بالضبط.
- سيئ لـ: أي تطبيق متعدد اللغات، أو أي تطبيق يحتوي على أكثر من نوعين من أنواع العرض، أو أي سير عمل تحتاج إلى تكراره مع كل إصدار. 30 دقيقة من السحب والإفلات لكل لغة تتراكم بسرعة.
المشاكل الشائعة:
- نوع عرض خاطئ. إذا كان ملفك المصدر بمقاس 1320 × 2868 (iPhone 16/17 Pro Max، 6.9") وقمت بإسقاطه في مربع 6.5"، سيرفض App Store Connect عملية الرفع.
- الإصدارات المقفلة. بمجرد أن يصبح الإصدار "قيد المراجعة" أو "بانتظار إصدار المطور"، تكون لقطات الشاشة للقراءة فقط. أنشئ إصدارًا جديدًا أولاً.
- الرفع الجزئي. إذا فشل سير عمل الاستبدال في منتصف الطريق، فتحقق من مجموعة نوع العرض الكاملة قبل التقديم بدلاً من افتراض أن المجموعة القديمة لا تزال سليمة.
الخيار 2: Transporter أو Fastlane Deliver
يعمل كلا الأداتين على أتمتة التسليم إلى App Store Connect، ولكن مع تباين في طريقة التعبئة والتهيئة.
Transporter هو أداة مجانية من Apple لشحن إصدارات التطبيقات وحزم البيانات الوصفية (Metadata). إنه قابل للبرمجة النصية ولكنه يفترض أن لديك بالفعل بنية مجلدات متوافقة مع iTMSTransporter تحتوي على ملف XML للبيانات الوصفية. ممتاز إذا كنت تقوم بالفعل ببناء حزم IPA باستخدام xcodebuild؛ ولكنه معقد إذا كنت تريد فقط رفع لقطات الشاشة.
fastlane deliver هو المعيار المجتمعي. تحتفظ بلقطات الشاشة في بنية مجلدات مثلfastlane/screenshots/ar-SA/iPhone 6.9 - 01.png وتقوم بتشغيلfastlane deliver. حيث يقوم برفع لقطات الشاشة، والبيانات الوصفية، والكلمات المفتاحية في تمريرة واحدة.
- جيد لـ: الفرق التي لديها بالفعل خط أنابيب CI، وتريد تتبع رفع لقطات الشاشة في git، ولا تمانع في استخدام لغة Ruby.
- سيئ لـ: المصممين الذين لا يريدون صيانة بيئة عمل Ruby، وأي شخص يريد واجهة مستخدم رسومية تعرض ما سيتم رفعه قبل حدوثه.
المشاكل الشائعة:
- الدقة والتسمية مهمتان. يمكن لـ fastlane استنتاج شاشات العرض المستهدفة من دقة الصورة، وقد تحتاج عائلات iPad غير الواضحة إلى اسم عائلة العرض من Apple في اسم الملف لتوضع في خانة لقطة الشاشة الصحيحة.
- يجب إنشاء مفاتيح واجهة برمجة تطبيقات App Store Connect مرة واحدة وتخزينها بشكل آمن (معرف المفتاح، ومعرف المصدر، وملف .p8). يعني فقدان ملف .p8 إعادة إنشائه من جديد.
- الاستبدال هو عملية كل شيء أو لا شيء. يتم حذف كل لقطة شاشة موجودة في نوع العرض المستهدف قبل رفع اللقطات الجديدة.
الخيار 3: واجهة برمجة تطبيقات App Store Connect مباشرة
إذا كنت تبني أداة بنفسك، فإن واجهة برمجة تطبيقات App Store Connect تتيح رفع لقطات الشاشة عبر ثلاثة نقاط نهاية (Endpoints):
POST /v1/appScreenshotSets— إنشاء مجموعة لقطات شاشة لنوع عرض وتوطين معينين.POST /v1/appScreenshots— إنشاء حجز للقطة الشاشة، وإرجاع البيانات الوصفية لعملية الرفع (روابط PUT المجزأة).PATCH /v1/appScreenshots/{id}معuploaded: true— تثبيت عملية الرفع بعد دفع جميع الأجزاء.
تقوم بالمصادقة باستخدام رمز JWT موقع بواسطة مفتاح .p8 الخاص بك. رمز JWT للمصادقة قصير الأجل (20 دقيقة كحد أقصى) ومقتصر على جمهور واجهة برمجة تطبيقات App Store Connect. تفرض Apple أيضًا قيودًا على معدل عمليات الرفع المكثفة، لذا تحتاج عمليات الرفع المتزامنة والمجزأة إلى استراتيجية إعادة محاولة/تراجع (retry/backoff).
جيد لـ: بناء أتمتة أو أدوات مخصصة. تحصل على تحكم كامل، واستجابات محددة الأنواع، ويمكنك بناء تجربة مستخدم حول تدفق الرفع.
سيئ لـ: أي شخص يريد الشحن فقط، دون صيانة. توقع قضاء عطلة نهاية الأسبوع في التعامل مع المصادقة، والرفع المجزأ، ومعالجة الأخطاء قبل أن تصبح الأداة موثوقة.
الخيار 4: أداة تصميم ترفع الملفات نيابة عنك
هذا هو سير العمل الذي بنيناه داخل Screenshot Bro. تقوم بتصميم لقطات الشاشة الخاصة بك، وإضافة اللغات، وترجمة النصوص تلقائيًا، ثم النقر فوق Upload to App Store Connect. يقوم التطبيق بـ:
- الكشف التلقائي عن نوع العرض الصحيح من حجم الصف الخاص بك (1320 × 2868 ← iPhone 6.9"، 2064 × 2752 ← iPad 13"، إلخ).
- مطابقة لغات مشروعك مع توطينات App Store Connect في الإصدار المحدد. يتم الكشف عن عدم التطابق مسبقًا.
- إجراء فحص أولي — الملفات ذات الحجم الزائد، أو اللغات المفقودة، أو الإصدارات المقفلة، أو تعارضات المنصات تظهر قبل أن ترى Apple أي شيء.
- استبدال كل مجموعة مطابقة بشكل متزامن وبسيط (Atomically). لا توجد حالات مستبدلة جزئيًا، ولا حاجة لتغيير أسماء المجلدات باستمرار.
يتم تخزين مفتاح واجهة برمجة التطبيقات (معرف المصدر، ومعرف المفتاح، وملف .p8) مرة واحدة في سلسلة مفاتيح macOS (Keychain). بعد الإعداد، يتم شحن كل إصدار بنقرة واحدة فقط.
أي خيار يجب أن تختار؟
مخطط قرار تقريبي:
- لغة واحدة، تطبيق واحد، تحديث نادر. رافع الويب كافٍ تمامًا.
- خط أنابيب CI، لقطات شاشة متتبعة في git، فريق يعتمد على Ruby. fastlane deliver.
- أداة مخصصة / أتمتة داخلية. واجهة برمجة التطبيقات مباشرة.
- مطور مستقل أو فريق صغير، تقوم بتصميم وشحن لقطات الشاشة بنفسك. استخدم تطبيق Mac يدمج التصميم والرفع في مسار واحد.
قبل الرفع: قائمة مرجعية
أياً كان المسار الذي تختار، فهذه هي الأخطاء الأكثر استهلاكًا للوقت:
- أن تكون لقطات الشاشة الخاصة بك بالمقاسات المدعومة تمامًا — دون زيادة أو نقصان بمقدار بكسل واحد. يمكن لـ Apple رفض الملفات غير المتطابقة أثناء الرفع أو المعالجة.
- أن يكون إصدار App Store المحدد قابلاً للتعديل (ليس "قيد المراجعة" أو "بانتظار إصدار المطور").
- أن تحتوي كل لغة تخطط لرفعها على توطين مطابق مفعل في App Store Connect على ذلك الإصدار.
- صيغة PNG أو JPEG فقط. لا تقبل صيغ HEIC، أو WebP، أو JPEG التدريجي (Progressive JPEGs).
- نظام ألوان RGB، مع عدم وجود قناة ألفا (شفافية) لقطات الشاشة.
ملخص سريع (TL;DR)
رافع الويب هو الخيار الأقل متعة لأي عملية متكررة. بينما fastlane هو الخيار الافتراضي للفرق التي تشحن تحديثات باستمرار. واجهة برمجة التطبيقات قوية ولكنها تتطلب عطلة نهاية أسبوع كاملة من العمل. إذا كنت تريد رفعاً بنقرة واحدة مباشرة من تطبيق التصميم، فهذا هو بالضبط ما تم بناء ميزة Upload to App Store Connect في Screenshot Bro لأجله — كشف تلقائي لأنواع العرض، مطابقة اللغات، فحص أولي، ومفتاح واجهة برمجة تطبيقات واحد مخزن في سلسلة المفاتيح.