ITMS-90717: إصلاح خطأ Invalid large app icon مع Expo

Q: هل يمكن إصلاح ITMS-90717 بتحديث عن بُعد؟

لا. الأيقونة مجمّعة داخل الملف الثنائي، في Assets.car. التحديث عن بُعد لا يغيّر إلا JavaScript وموارد التطبيق. أصلح الأيقونة، وأعد الـ build، ثم أرسله من جديد.

Q: هل يدعم Expo أيقونات Icon Composer في iOS 26؟

نعم، منذ SDK 54: عرّف مسار مجلد .icon في ios.icon، كنص. الـ prebuild ينسخه كما هو وXcode 26 يجمّعه. إن ظهر ITMS-90717 مع هذه الصيغة، افحص الطبقات الشفافة وتأثير Blur، أو عُد مؤقتًا إلى PNG.

بقلم Mehdi Azizi
نُشر في 4 نوفمبر 2026، 8 د

ITMS-90717 يعني أن أيقونة 1024 x 1024 في الـ build ما زالت تحتوي على شفافية أو قناة ألفا. صدّرها معتمة، وتحقق منها بـ sips، ثم أعد الـ build.

ITMS-90717 فحص تلقائي تجريه Apple على الـ build الخاص بك. يخبرك أن الأيقونة الكبيرة للتطبيق، أي أيقونة 1024 x 1024 بكسل التي يعرضها App Store، تحتوي على شفافية أو على قناة ألفا. الحل: أيقونة مربعة ومعتمة، مُصدَّرة بلا قناة ألفا، ثم build جديد.

مع Expo، نادرًا ما يكون ملف PNG الخاص بك هو المذنب: فالـ prebuild يضعه أصلًا على خلفية بيضاء. قرأت هذا الكود في SDK 57 وتحققت من أيقونات Solys وTradaZen وNolera. لذلك يأتي الخطأ في الغالب من مجلد ios مُضاف إلى git، أو من ملف Icon Composer. إليك كيف تعرف أيهما، وكيف تصلحه.

ماذا يعني الخطأ ITMS-90717؟

عنوان الرسالة هو "ITMS-90717: Invalid large app icon". وتوضح أن الأيقونة الكبيرة في كتالوج صور تطبيقك "can't be transparent or contain an alpha channel": أي لا يجوز أن تكون شفافة، ولا أن تحتوي على قناة ألفا. الرسائل القديمة كانت تتحدث عن "Invalid App Store Icon". إنها القاعدة نفسها.

هذه الأيقونة الكبيرة هي أيقونة App Store. وتشرح ذلك وثائق Xcode حول الأيقونات: التطبيق الموزَّع على App Store يجب أن يوفر أيقونته بحجم 1024 نقطة في كتالوج صوره.

قناة ألفا هي الطبقة الرابعة في ملف PNG، بجانب الأحمر والأخضر والأزرق. تخزّن شفافية كل بكسل. قد تبدو الأيقونة ممتلئة تمامًا وتحتفظ مع ذلك بهذه القناة: هذا هو الفخ الذي يتكرر في كل نقاشات المنتديات.

مثل أخطاء ITMS الأخرى، هذا ليس رفضًا من مراجع. Apple حلّلت الملف الثنائي عند التسليم. وحسب أداة الرفع، يظهر الخطأ كفشل في التحقق، مثلًا بالرمز 409.

تحقق من أيقونتك باستخدام sips

على Mac، الأداة sips مثبتة مسبقًا. يكفيك سطر واحد:

sips -g hasAlpha assets/icon.png

النتيجة التي تريدها هي hasAlpha: no. في 15 أكتوبر 2026، شغّلت هذا الأمر على الأيقونات المعرّفة في ملفات app.json الخاصة بـ Solys وTradaZen وNolera: كلها أجابت no، بحجم 1024 x 1024.

صنعت أيضًا أيقونة تجريبية: مربع أزرق معتم بالكامل، لكنه محفوظ مع قناة ألفا. أجابت sips بـ yes. لا يوجد أي بكسل شفاف، ومع ذلك القناة موجودة. لهذا يكتب كثير من المطورين "أيقونتي لا تحتوي على أي شفافية" تحت هذه الرسالة.

في تطبيق Preview، يعرض المفتش (Tools، ثم Show Inspector) أيضًا خصائص الصورة، ومنها قناة ألفا.

الإصلاح: صدّر الأيقونة بلا قناة ألفا

ثلاث طرق، من الأبسط إلى الأدق.

1. Preview. اختر File، ثم Export، بصيغة PNG، ثم ألغِ تحديد خانة Alpha. الملف المُصدَّر لن يحتوي بعدها على قناة ألفا.

2. sips، دون تثبيت أي شيء. الأداة sips لا تزيل قناة ألفا من ملف PNG. عليك المرور بصيغة JPEG، التي لا تحتوي عليها:

sips -s format jpeg -s formatOptions 100 icon.png --out icon.jpg
sips -s format png icon.jpg --out icon-opaque.png
sips -g hasAlpha icon-opaque.png

على أيقونتي التجريبية ذات الزوايا الشفافة، أصبحت الزوايا بيضاء وأجاب السطر الأخير بـ no. المرور بـ JPEG يضغط الصورة قليلًا، حتى بأعلى جودة: افحص النتيجة عن قرب.

3. ImageMagick. إن كان مثبتًا لديك، يمكنك اختيار لون الخلفية:

magick icon.png -background white -alpha remove -alpha off icon-opaque.png

حسب وثائق ImageMagick، الخيار -alpha remove يضع الصورة فوق لون الخلفية، و-alpha off يعطّل القناة.

هذه الطرق الثلاث تملأ الشفافية بلون واحد. إن كان شعارك يطفو على خلفية شفافة، فالأنظف أن تعود إلى الملف المصدر وترسم فيه خلفية حقيقية. هذا ما يطلبه Expo في دليل أيقونة التطبيق: يجب أن تملأ الأيقونة المربع كله، بلا زوايا مستديرة ولا بكسلات شفافة. iOS يطبّق القناع بنفسه.

من أين يأخذ Expo أيقونتك، وماذا يفعل بها

يقرأ Expo أولًا ios.icon، ثم الحقل icon في جذر الإعدادات. حسب مرجع إعدادات Expo، يقبل ios.icon ثلاثة أشكال: ملف PNG، أو كائنًا فيه المتغيرات light وdark وtinted، أو مجلد .icon مُنشأ بـ Icon Composer.

الجدول التالي مأخوذ من الكود الذي يولّد أيقونة iOS أثناء الـ prebuild، أي @expo/prebuild-config 57.0.16 (SDK 57)، وقد قرأته في 15 أكتوبر 2026:

ما تعرّفه	ما يفعله الـ prebuild	خطر ITMS-90717
`icon` بصيغة PNG	تسطيح على خلفية بيضاء	ضعيف
`ios.icon.light`	تسطيح على خلفية بيضاء	ضعيف
`ios.icon.tinted`	تسطيح على خلفية بيضاء	ضعيف
`ios.icon.dark`	تبقى الشفافية	مقصود من Apple
`ios.icon` بصيغة `.icon`	يُنسخ كما هو	حقيقي
مجلد `ios` في git	لا يُعاد تشغيل الـ prebuild	حقيقي

مع ملف PNG، يزيل Expo الشفافية بنفسه ويستبدلها بالأبيض. لذلك ينتهي الشعار المقصوص فوق مربع أبيض: لا خطأ، لكن الشكل قد لا يكون ما أردته. أما المتغير الداكن فيحتفظ بشفافيته، وهذا مقصود: Apple تطلب خلفية شفافة للأيقونة الداكنة، كي تظهر الخلفية التي يوفرها النظام.

في Nolera، الذي يعرّف المتغيرات الثلاثة، أجابت sips بـ no للأيقونة الفاتحة والملوّنة المولّدتين، وyes للداكنة. حسب تاريخ الـ commit الخاص بهذه المتغيرات، فإن الإصدار 1.0.2 المنشور يتضمنها. لم أتحقق من ذلك داخل ملف IPA الخاص به.

حالة مجلد ios المُضاف إلى git

هذا هو السبب الأرجح مع Expo. تقول ذلك صفحة Expo عن التوليد الأصلي المستمر: إن كان مشروعك يحتوي على المجلدين android وios، فإن EAS Build لا يشغّل الـ prebuild. عندها لا يعود ملف app.json يؤثر في الأيقونة: ملف PNG الموجود في مجلد ios هو الذي يُرسل إلى Apple.

تحقق من ذلك من جذر المشروع:

sips -g hasAlpha ios/*/Images.xcassets/AppIcon.appiconset/*.png

إن أجاب الأمر بـ yes لأيقونة 1024، استبدل هذا الملف بنسختك المعتمة، بالاسم نفسه. وإن لم تجرِ أي تعديل أصلي يدويًا، يمكنك أيضًا حذف مجلد ios وإضافته إلى .gitignore: سيعيد EAS توليده مع كل build. في Solys وTradaZen وNolera، هذا المجلد يتجاهله git.

صيغة iOS 26: Icon Composer

Icon Composer هي أداة Apple لأيقونات Liquid Glass في iOS 26. تنتج ملف .icon واحدًا متعدد الطبقات. حسب دليل Apple عن Icon Composer، يستخرج منه Xcode أيضًا الصور لإصدارات iOS الأقدم.

يدعمه Expo منذ SDK 54. تعرّف المجلد كنص، وليس أبدًا داخل كائن المتغيرات:

{
  "expo": {
    "ios": {
      "icon": "./assets/app.icon"
    }
  }
}

في هذه الحالة، ينسخ الـ prebuild المجلد دون أن يلمسه، وXcode هو من يصنع الأيقونة النهائية. لذلك تحتاج Xcode 26 أو أحدث، وهو المستخدم في صور EAS الحديثة، كما أشرح في الدليل الخاص بـ ITMS-90725.

منذ أغسطس 2025، تشير نقاشات في منتدى مطوري Apple إلى ITMS-90717 مع ملفات .icon. الأسباب المحتملة المذكورة: طبقة PNG شفافة، أو طبقة أكبر من مساحة الرسم، أو مجموعة عليها تأثير Blur قرب الحافة. والحلول البديلة المذكورة: إيقاف الـ Blur، أو الإبقاء على خلفية ممتلئة، أو العودة إلى PNG. لا تقدم هذه النقاشات أي إصلاح رسمي من Apple، وكان الخطأ لا يزال يُبلَّغ عنه في أغسطس 2026.

قواعد Apple للأيقونات تسير في الاتجاه نفسه: إن استوردت طبقة خلفية، فيجب أن تغطي المساحة كلها وأن تكون معتمة. تطبيقاتي ما زالت تستخدم PNG، لذلك لم أختبر Icon Composer في الإنتاج. إن كان ملف .icon يعرقل رفعك، أعد ios.icon إلى ملف PNG: سيسطّحه Expo، وستجتاز أيقونتك هذا الفحص.

تحقق من الأيقونة في الـ build النهائي

داخل ملف IPA، أيقونة 1024 ليست ملف PNG: Xcode يجمّعها داخل Assets.car. نزّل ملف IPA من صفحة الـ build على expo.dev، ثم شغّل:

unzip -q MyApp.ipa -d ipa
xcrun assetutil --info ipa/Payload/*.app/Assets.car | grep -B3 '"RenditionName" : "App-Icon'

كل أيقونة تعرض حقلًا اسمه Opaque. في 15 أكتوبر 2026، جمّعت باستخدام actool، أداة Xcode، أيقونة Solys وأيقونتي التجريبية ذات الزوايا الشفافة. الأولى خرجت بـ "Opaque" : true، والثانية بـ "Opaque" : false. لا توثّق Apple هذا الحقل: اعتبره مؤشرًا، لا فحص Apple نفسه.

فخ يجب أن تعرفه: لا تختبر بـ sips ملفات PNG الصغيرة الموجودة في جذر التطبيق. Xcode يكتبها مع قناة ألفا، حتى عندما يكون المصدر معتمًا. في اختباري مع أيقونة Solys، أجابت sips بـ yes لها.

أخطاء الأيقونات الأخرى

الرمز	ما تشير إليه Apple	الحل المحتمل مع Expo
ITMS-90717	أيقونة 1024 شفافة	التصدير بلا ألفا
ITMS-90704	أيقونة 1024 غائبة	مدخل 1024 ناقص
ITMS-90022	أيقونة iPhone غائبة	كتالوج غير مكتمل
ITMS-90023	أيقونة iPad غائبة	كتالوج غير مكتمل

الرسائل الثلاث الأخيرة تعود في الغالب إلى 2017 و2018، حين غيّر Xcode 9 قواعد الأيقونات.

مع Expo، أصبحت نادرة. الـ prebuild يكتب أيقونة شاملة واحدة بحجم 1024، وXcode يولّد بقية الأحجام. وإن لم تعرّف أي أيقونة، ينشئ Expo مربعًا أبيض، لتجنب الفشل عند الرفع. إن ظهر أحد هذه الأخطاء، افحص مجلد ios المُضاف إلى git: يجب أن يحتوي ملف Contents.json في AppIcon.appiconset على مدخل بحجم 1024x1024، وأن يكون ملف PNG المذكور فيه موجودًا.

قبل رفعك القادم

تصحيح الأيقونة يأخذ عشر دقائق، لكن كل خطأ يكلّفك build. الفحوص التلقائية الأخرى تتطلب الصرامة نفسها، مثل ITMS-90683 لنصوص طلب الأذونات، أو ITMS-91053 لملف الخصوصية. وبعد قبول الـ build، ثبّته عبر TestFlight لترى أيقونتك على شاشتك الرئيسية.

أما الرفض من مراجع فيتطلب تأنيًا أكبر: الخطوات موجودة في صفحة تطبيق رفضته Apple، وأكثر الأسباب شيوعًا في لماذا ترفض Apple تطبيقًا.

للتحقق من ملفك قبل الرفع، يجمع Review Kit قائمة التحقق الخاصة بي وskills لـ Claude Code تراجع مشروعك. وإن تعثّر رفعك وأردت نظرة بشرية، احجز ساعة معي: نراجع مشروعك عبر مكالمة فيديو، على شاشتك. وإن كنت تحضّر إطلاقك الأول، أجرِ التشخيص المجاني: يرتّب لك الخطوات ويرسل إليك قائمتي لتجنب رفض Apple.

الأسئلة الشائعة

لماذا ترى Apple قناة ألفا رغم أن أيقونتي بلا أي شفافية؟

لأن ملف PNG قد يحتفظ بقناة ألفا حتى عندما تكون كل بكسلاته معتمة. كثير من الأدوات تضيفها افتراضيًا عند التصدير. تحقق باستخدام sips -g hasAlpha، ثم أعد تصدير الأيقونة بلا هذه القناة.

هل يمكن إصلاح ITMS-90717 بتحديث عن بُعد؟

لا. الأيقونة مجمّعة داخل الملف الثنائي، في Assets.car. التحديث عن بُعد لا يغيّر إلا JavaScript وموارد التطبيق. أصلح الأيقونة، وأعد الـ build، ثم أرسله من جديد.

هل يمكن أن تكون الأيقونة الداكنة شفافة؟

نعم. Apple تطلب خلفية شفافة للمتغير الداكن، وExpo يحتفظ بشفافيته. أستنتج من ذلك أن الفحص يستهدف الأيقونة الرئيسية، أيقونة App Store: هي التي يجب أن تكون معتمة.

هل يجب أن أجعل زوايا أيقونة iOS مستديرة؟

لا. قدّم مربعًا ممتلئًا: iOS يطبّق القناع بنفسه. الزوايا المستديرة تترك بكسلات شفافة في الأركان، وهذا بالضبط ما يرفضه هذا الفحص.

هل يدعم Expo أيقونات Icon Composer في iOS 26؟

نعم، منذ SDK 54: عرّف مسار مجلد .icon في ios.icon، كنص. الـ prebuild ينسخه كما هو وXcode 26 يجمّعه. إن ظهر ITMS-90717 مع هذه الصيغة، افحص الطبقات الشفافة وتأثير Blur، أو عُد مؤقتًا إلى PNG.

الخلفية