ITMS-90717: oprava „Invalid large app icon“ v Expo

ITMS-90717 je automatická kontrola, ktorú Apple robí na tvojom builde. Hovorí, že veľká ikona appky, tá s rozmerom 1024 x 1024 pixelov, ktorú zobrazuje App Store, obsahuje priehľadnosť alebo alfa kanál. Oprava: štvorcová nepriehľadná ikona exportovaná bez alfa kanála a potom nový build.

S Expo je tvoj PNG súbor len zriedka vinníkom: prebuild ho už sám položí na biele pozadie. Tento kód som si prečítal v SDK 57 a overil som ikony appiek Solys, TradaZen a Nolera. Chyba potom najčastejšie pochádza z priečinka ios vo verziovacom systéme alebo zo súboru z Icon Composer. Tu je postup, ako zistiť, ktorý z nich to je, a ako to opraviť.

Čo znamená chyba ITMS-90717?

Správa má názov „ITMS-90717: Invalid large app icon“. Upresňuje, že veľká ikona v katalógu obrázkov tvojej appky „can't be transparent or contain an alpha channel“: nesmie byť priehľadná ani obsahovať alfa kanál. Staršie správy hovorili o „Invalid App Store Icon“. Je to to isté pravidlo.

Táto veľká ikona je ikona pre App Store. Vysvetľuje to dokumentácia Xcode o ikonách: appka distribuovaná cez App Store musí mať vo svojom katalógu obrázkov ikonu s veľkosťou 1024 bodov.

Alfa kanál je štvrtá vrstva PNG popri červenej, zelenej a modrej. Ukladá priehľadnosť každého pixelu. Ikona môže vyzerať úplne plná a ten kanál si napriek tomu ponechať: to je pasca, ktorá sa opakuje vo všetkých vláknach na fórach.

Ako pri ostatných chybách ITMS, nejde o zamietnutie od reviewera. Apple analyzoval binárku pri doručení. Podľa nástroja, ktorým build posielaš, sa chyba zobrazí ako neúspešná validácia, napríklad s kódom 409.

Over si ikonu pomocou sips

Na Macu je sips nainštalovaný automaticky. Stačí jeden riadok:

sips -g hasAlpha assets/icon.png

Chceš vidieť hasAlpha: no. 15. októbra 2026 som tento príkaz spustil na ikonách uvedených v app.json appiek Solys, TradaZen a Nolera: všetky odpovedajú no, v rozmere 1024 x 1024.

Vyrobil som si aj testovaciu ikonu: modrý štvorec, úplne nepriehľadný, ale uložený s alfa kanálom. sips odpovedá yes. Ani jeden pixel nie je priehľadný, a kanál tam napriek tomu je. Preto toľko vývojárov pod touto správou píše „moja ikona nemá žiadnu priehľadnosť“.

V appke Preview inšpektor (Tools, Show Inspector) tiež vypíše vlastnosti obrázka vrátane alfa kanála.

Oprava: exportuj ikonu bez alfa kanála

Tri metódy, od najjednoduchšej po najpresnejšiu.

1. Preview. File, Export, formát PNG a potom odškrtni políčko Alpha. Exportovaný súbor už alfa kanál nemá.

2. sips, bez inštalovania čohokoľvek. sips z PNG alfa kanál neodstráni. Treba prejsť cez JPEG, ktorý žiadny nemá:

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

Na mojej testovacej ikone s priehľadnými rohmi sa rohy zmenili na biele a posledný riadok odpovedá no. Prechod cez JPEG obrázok trochu skomprimuje, aj pri maximálnej kvalite: výsledok si pozri zblízka.

3. ImageMagick. Ak ho máš nainštalovaný, farbu pozadia si vyberieš sám:

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

Podľa dokumentácie ImageMagick -alpha remove položí obrázok na farbu pozadia a -alpha off kanál vypne.

Všetky tri metódy vyplnia priehľadnosť jednou plnou farbou. Ak tvoje logo plávalo na priehľadnom pozadí, najčistejšie je vrátiť sa k zdrojovému súboru a nakresliť do neho skutočné pozadie. Expo to vyžaduje vo svojom návode k ikone appky: ikona musí vyplniť celý štvorec, bez zaoblených rohov a bez priehľadných pixelov. Masku si iOS aplikuje sám.

Odkiaľ Expo berie tvoju ikonu a čo s ňou robí

Expo najprv číta ios.icon, potom pole icon v koreni tvojej konfigurácie. Podľa referencie konfigurácie Expo ios.icon prijíma tri formy: PNG, objekt s variantmi light, dark a tinted, alebo priečinok .icon vytvorený v Icon Composer.

Nasledujúca tabuľka vychádza z kódu, ktorý pri prebuilde generuje iOS ikonu, @expo/prebuild-config 57.0.16 (SDK 57), prečítaného 15. októbra 2026:

Čo deklaruješ	Čo urobí prebuild	Riziko ITMS-90717
icon ako PNG	Zlúčené na biele pozadie	Nízke
ios.icon.light	Zlúčené na biele pozadie	Nízke
ios.icon.tinted	Zlúčené na biele pozadie	Nízke
ios.icon.dark	Priehľadnosť zachovaná	Chce to tak Apple
ios.icon ako .icon	Skopírované bez zmeny	Reálne
Priečinok ios vo verziovaní	Prebuild sa znova nespustí	Reálne

S PNG Expo priehľadnosť odstráni sám a nahradí ju bielou. Vystrihnuté logo teda skončí na bielom štvorci: žiadna chyba, ale vzhľad, ktorý si možno nechcel. Tmavý variant si priehľadnosť ponechá, a je to zámer: Apple pre tmavú ikonu vyžaduje priehľadné pozadie, aby bolo vidieť pozadie od systému.

Pri Nolere, ktorá deklaruje všetky tri varianty, sips odpovedá no pre vygenerovanú svetlú a tónovanú ikonu a yes pre tmavú. Podľa dátumu commitu týchto variantov ich verzia 1.0.2, ktorá je online, obsahuje. V jej IPA som to neoveroval.

Prípad priečinka ios vo verziovaní

Toto je pri Expo najpravdepodobnejšia príčina. Stránka Expo o continuous native generation to hovorí: ak tvoj projekt obsahuje priečinky android a ios, EAS Build prebuild nespustí. Tvoj app.json potom ikonu vôbec neovplyvní: Apple dostane PNG z priečinka ios.

Skontroluj to z koreňa projektu:

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

Ak príkaz pri ikone 1024 odpovie yes, nahraď tento súbor svojou nepriehľadnou verziou s rovnakým názvom. Ak si ručne nerobil žiadne natívne úpravy, môžeš priečinok ios aj zmazať a pridať ho do .gitignore: EAS ho vygeneruje pri každom builde. V Solys, TradaZen aj Nolere tento priečinok git ignoruje.

Formát iOS 26: Icon Composer

Icon Composer je nástroj od Apple na ikony Liquid Glass v iOS 26. Vytvára jediný súbor .icon s viacerými vrstvami. Podľa návodu Apple k Icon Composer z neho Xcode vyrobí aj obrázky pre staršie verzie iOS.

Expo ho podporuje od SDK 54. Priečinok deklaruješ ako text, nikdy nie v objekte variantov:

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

V tom prípade prebuild priečinok skopíruje bez zmeny a finálnu ikonu vyrobí Xcode. Potrebuješ teda Xcode 26 alebo novší, ten z novších EAS image, ako to vysvetľujem v návode k ITMS-90725.

Od augusta 2025 sa na fóre vývojárov Apple objavujú vlákna, ktoré hlásia ITMS-90717 so súbormi .icon. Uvádzané možné príčiny: priehľadná PNG vrstva, vrstva väčšia ako plátno, skupina s efektom Blur blízko okraja. Spomínané obchádzky: vypnúť Blur, ponechať plné pozadie alebo sa vrátiť k PNG. Tieto vlákna neprinášajú žiadnu oficiálnu opravu od Apple a chyba sa hlásila ešte v auguste 2026.

Pravidlá Apple pre ikony idú rovnakým smerom: ak importuješ vrstvu pozadia, musí pokrývať celú plochu a byť nepriehľadná. Moje appky stále používajú PNG, takže Icon Composer som v produkcii netestoval. Ak ti súbor .icon blokuje odoslanie, prepni ios.icon späť na PNG: Expo ho zlúči a tvoja ikona touto kontrolou prejde.

Over ikonu vo finálnom builde

V IPA nie je ikona 1024 súborom PNG: Xcode ju skompiluje do Assets.car. Stiahni IPA zo stránky buildu na expo.dev a spusti:

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

Každá ikona zobrazí pole Opaque. 15. októbra 2026 som pomocou actool, nástroja z Xcode, skompiloval ikonu Solys a svoju testovaciu ikonu s priehľadnými rohmi. Prvá vyjde ako "Opaque" : true, druhá ako "Opaque" : false. Apple toto pole nedokumentuje: ber ho ako indíciu, nie ako kontrolu od Apple.

Pasca, o ktorej treba vedieť: netestuj pomocou sips malé PNG v koreni appky. Xcode ich zapisuje s alfa kanálom, aj keď je zdroj nepriehľadný. Pri mojom teste s ikonou Solys sips pri nich odpovedá yes.

Ostatné chyby ikon

Kód	Čo Apple hlási	Kde hľadať v Expo
ITMS-90717	Priehľadná ikona 1024	Exportovať bez alfy
ITMS-90704	Chýba ikona 1024	Chýbajúca položka 1024
ITMS-90022	Chýba ikona pre iPhone	Neúplný katalóg
ITMS-90023	Chýba ikona pre iPad	Neúplný katalóg

Posledné tri správy pochádzajú hlavne z rokov 2017 a 2018, keď Xcode 9 zmenil pravidlá pre ikony.

S Expo sú dnes zriedkavé. Prebuild zapíše jedinú univerzálnu ikonu 1024 a ostatné veľkosti vygeneruje Xcode. Ak nedeklaruješ žiadnu ikonu, Expo dokonca vytvorí biely štvorec, aby odoslanie nezlyhalo. Ak ťa niektorá z týchto chýb zasiahne, pozri sa na priečinok ios vo verziovaní: súbor Contents.json v AppIcon.appiconset musí obsahovať položku s veľkosťou 1024x1024 a PNG, na ktorý odkazuje, musí existovať.

Pred ďalším odoslaním

Ikonu opravíš za desať minút, ale každá chyba ťa stojí jeden build. Ostatné automatické kontroly si vyžadujú rovnakú dôslednosť, napríklad ITMS-90683 pre texty povolení alebo ITMS-91053 pre privacy manifest. Keď je build prijatý, nainštaluj si ho cez TestFlight a pozri sa na svoju ikonu na ploche.

Zamietnutia od reviewera si vyžadujú viac nadhľadu: postup nájdeš na stránke appka zamietnutá od Apple a najčastejšie dôvody v článku prečo Apple zamieta appky.

Na kontrolu podkladov pred odoslaním je tu Review Kit, ktorý obsahuje môj checklist a skills pre Claude Code, ktoré prejdú tvoj projekt. Ak sa ti odoslanie zaseklo a chceš ľudský pohľad, rezervuj si so mnou hodinu: prejdeme tvoj projekt cez videohovor, na tvojej obrazovke. A ak chystáš svoje prvé vydanie, sprav si bezplatnú diagnostiku: zoradí ti kroky do správneho poradia a pošle ti môj checklist proti zamietnutiu od Apple.

Často kladené otázky

Prečo Apple vidí alfa kanál, keď moja ikona nemá žiadnu priehľadnosť?

Pretože PNG si môže ponechať alfa kanál, aj keď sú všetky jeho pixely nepriehľadné. Veľa nástrojov ho pri exporte pridáva predvolene. Over to cez sips -g hasAlpha a potom ikonu exportuj znova bez tohto kanála.

Dá sa ITMS-90717 opraviť vzdialenou aktualizáciou?

Nie. Ikona je skompilovaná v binárke, v Assets.car. Vzdialená aktualizácia mení len JavaScript a zdroje appky. Oprav ikonu, sprav nový build a pošli ho znova.

Môže byť tmavá ikona priehľadná?

Áno. Apple pre tmavý variant vyžaduje priehľadné pozadie a Expo jeho priehľadnosť zachováva. Z toho usudzujem, že kontrola sa týka hlavnej ikony, tej pre App Store: tá musí byť nepriehľadná.

Treba iOS ikone zaobliť rohy?

Nie. Dodaj plný štvorec: masku si iOS aplikuje sám. Zaoblené rohy nechajú v rohoch priehľadné pixely, presne to, čo táto kontrola odmieta.

Podporuje Expo ikony z Icon Composer pre iOS 26?

Áno, od SDK 54: deklaruj cestu k priečinku .icon v ios.icon ako text. Prebuild ho skopíruje bez zmeny a Xcode 26 ho skompiluje. Ak s týmto formátom dostaneš ITMS-90717, skontroluj priehľadné vrstvy a efekt Blur, alebo sa dočasne vráť k PNG.