eas submit iOS -virheet ja niiden korjaus

Kun eas submit --platform ios epäonnistuu, viesti kertoo melkein aina, mistä kannattaa katsoa. Joko EAS-asetuksesi ovat puutteelliset, Apple-tilisi estää lähetyksen tai Apple hylkää binäärin. Kaksi ensimmäistä tapausta korjaantuvat muutamassa minuutissa ilman uutta buildia. Kolmannen tunnistaa ITMS-koodista, ja se vaatii melkein aina uuden buildin.

Julkaisen iOS-sovellukseni, muun muassa Solysin, TradaZenin ja Noleran, Expolla ja EAS:llä. Tässä lainatut viestit on kopioitu EAS CLI:n lähdekoodista Expon virallisesta GitHub-repositoriosta, jonka luin läpi 3. marraskuuta 2026. Expon vanha foorumi ohjaa nykyään Discordiin, joten koodi on edelleen varmin lähde. Jos haluat koko polun eas.json-tiedostosta tarkastukseen lähettämiseen asti, lue ensin EAS Submit iOS: Expo-sovelluksen julkaisu App Storeen. Tässä keskitytään korjaamiseen.

Mitä eas submit tekee ja mitä se tarvitsee

Expon dokumentaation mukaan komento lähettää .ipa-tiedostosi App Store Connectiin. Build ilmestyy TestFlightiin, kun Apple on käsitellyt sen, yleensä 10-15 minuutissa. Komento ei lähetä sovellustasi tarkastukseen: se pitää tehdä edelleen App Store Connectissa.

Expon iOS-lähetyssivu listaa kolme edellytystä:

• maksullinen Apple Developer -tili, jota vaaditaan kaikkiin App Store -lähetyksiin;
• bundle-tunniste kentässä ios.bundleIdentifier;
• EAS CLI asennettuna ja kirjautuneena Expo-tiliisi.

Jos haluat lähettää ilman vuorovaikutusta, sama sivu lisää kaksi asetusta:

• ascAppId eas.json-tiedoston submit-profiilissa, eli App Store Connect -sovelluksesi numero;
• App Store Connect API-avain, jota EAS hallinnoi tai jonka annat itse. Sen luonti, rooli ja peruminen on käyty läpi artikkelissa App Store Connect API-avain (.p8).

Minimiprofiili mahtuu muutamalle riville. Arvo on keksitty:

{
  "submit": {
    "production": {
      "ios": {
        "ascAppId": "1234567890"
      }
    }
  }
}

Jos EAS säilyttää jo API-avaintasi, tämä profiili riittää. Näin on useimmissa sovelluksissani.

Viestin lukeminen: kolme virheperhettä

Ennen kuin etsit korjausta, katso, missä vaiheessa komento pysähtyy. Tämä taulukko on se ruudukko, jota käytän jokaisen epäonnistumisen kohdalla.

Epäonnistumisen hetki	Perhe	Uusi build?
Ennen mitään lähetystä	EAS-asetukset	Ei
Yhteys Appleen, sovellustietueen luonti	Apple-tili	Ei
Lähetyksen jälkeen, koodi ITMS-90xxx	Hylätty binääri	Melkein aina

Yksityiskohdat näkyvät lähetyksen sivulla Expon hallintapaneelissa. Expo neuvoo lukemaan sieltä lokit ja etsimään "Build Annotations" -kuplan, joka kertoo yleisimmistä epäonnistumisen syistä. Terminaalissa --verbose-valitsin näyttää EAS Submitin lokit aina, EAS CLI:n referenssin mukaan.

EAS-asetusten virheet

"Set ascAppId in the submit profile (eas.json) or re-run this command in interactive mode."

Ajoit komennon valitsimella --non-interactive, esimerkiksi jatkuvassa integraatiossa, eikä profiilissasi ole ascAppId:tä. EAS CLI:n koodi pysähtyy silloin: se ei voi kysyä sinulta mitään eikä luoda sovellustietuetta puolestasi.

Korjaus: kopioi sovelluksesi numero kenttään ascAppId. Expo kertoo, mistä sen löytää: avaa sovelluksesi App Store Connectissa ja sitten App Information. Se on Apple ID -kenttä kohdassa General Information, noin kymmennumeroinen luku. Se ei ole Apple-sähköpostiosoitteesi eikä bundle-tunnisteesi.

Nolerassa komento vaati ilman ascAppId:tä Apple Developer -istunnon, joka vanhenee. Siitä asti kun numero on ollut eas.json-tiedostossa, lähetys ei ole kysynyt mitään.

Lisää ascAppId ennen buildia, ei sen jälkeen. SDK 57:ään asti Expon laskema sormenjälki sisältää aina eas.json-tiedoston. Vigiessä, jonka ajonaikainen versio noudattaa fingerprint-käytäntöä, numeron lisääminen buildin jälkeen muutti sormenjäljen: sen jälkeen julkaistu päivitys ei olisi koskaan päätynyt asennettuun buildiin. SDK 58:sta lähtien sormenjäljen oletusasetus balanced ohittaa eas.json-tiedoston, Expon muutoslokin mukaan.

"App Store Connect API Keys cannot be set up in --non-interactive mode."

Profiilissasi ei ole avainta, eikä EAS:llä ole yhtään sovellukseesi liitettyä avainta. Expo tarkentaa: ei-interaktiivisessa tilassa komento ei voi pyytää sinulta avainta, ja se kaatuu tähän viestiin.

Kaksi mahdollista korjausta:

• Anna EAS:n luoda ja säilyttää avain. Aja kerran eas credentials --platform ios interaktiivisessa tilassa omalla koneellasi ja anna sen määrittää App Store Connect API-avain sovelluksellesi.
• Tuo oma avaimesi kenttiin ascApiKeyPath, ascApiKeyIssuerId ja ascApiKeyId. eas.json-referenssin mukaan nämä kolme kenttää hyväksyvät ympäristömuuttujia, kuten $ASC_API_KEY_PATH.

Viimeisimmässä sovelluksessani --auto-submit-valitsin halusi Apple-tunnuksen luodakseen lähetysavaimensa. Laitoin oman avaimeni kolme kenttää työkopioni profiiliin, jota en koskaan commitoinut. Sitten lähetin valmiin buildin valitsimilla --id ja --non-interactive.

"EXPO_APPLE_APP_SPECIFIC_PASSWORD must be in the format xxxx-xxxx-xxxx-xxxx, where x is a lowercase letter."

Muuttuja sisältää jotain muuta kuin sovelluskohtaisen salasanan, usein itse Apple-salasanasi. EAS CLI tarkistaa tämän muodon ennen mitään lähetystä.

Applen ohjeen mukaan sovelluskohtainen salasana luodaan osoitteessa account.apple.com kohdassa App-Specific Passwords, kun kaksivaiheinen todennus on päällä. Se perutaan heti, kun vaihdat Apple-tilisi salasanan. Expo pitää tätä tapaa vähemmän turvallisena kuin API-avainta, joka on sen oletus ja suositus.

Apple-tilin virheet

"… agree to the latest Program License Agreement in your developer account."

Koko viesti alkaa sanoilla "You currently don't have access to this membership resource". Applen raaka vastaus voi sisältää "Unable to process request - PLA Update available". EAS:n uudemmat lähetysvaiheet näyttävät mieluummin "A required Apple agreement is missing or has expired".

Syy on sama: Apple on päivittänyt sopimuksen, eikä kukaan ole hyväksynyt sitä. Vain tilin omistaja, Account Holder, voi hyväksyä sopimukset, Applen roolitaulukon mukaan. EAS:n koodi pyytää häntä käymään App Store Connectin Business-sivulla ja sitten, jos Apple sitä tarjoaa, omalla tilillään osoitteessa developer.apple.com. Aja komento sen jälkeen uudelleen. Maksullisten sovellusten sopimukselle on oma oppaansa: Paid Apps Agreement App Store Connectissa.

"App Store Connect rejected the API authentication credentials."

Apple vastasi virheellä 401, NOT_AUTHORIZED. EAS mainitsee kolme syytä: avain ei ole enää aktiivinen, avain kuuluu toiseen App Store Connect -tiliin, tai Key ID, avaimen sisältö tai Issuer ID on väärin.

Tarkista molemmat tunnisteet App Store Connectissa: valikko Users and Access, välilehti Integrations. Applen mukaan Issuer ID näkyy sivun yläreunassa ja Key ID aktiivisten avainten listassa. Perutettua avainta ei voi koskaan aktivoida uudelleen. Apple näyttää sen 30 päivää kohdassa Revoked: sinun pitää luoda uusi.

"App Store Connect app for application identifier … was not found."

ascAppId:n osoittamaa sovellustietuetta ei löydy avaimellasi. EAS pyytää tarkistamaan numeron ja sen, että avaimella on pääsy sovellukseen oikealla tilillä. Se jopa listaa muutaman avaimella näkyvän sovelluksen. Applen omilla lähetystyökaluilla sama ongelma näkyy muodossa "No suitable application records were found".

Kolme syytä toistuu, joista kaksi on mainittu tässä Applen foorumiketjussa:

• Sovellustietuetta ei ole olemassa. Luo se App Store Connectissa tai poista ascAppId, jotta komento luo sen.
• Numero on toiselta tililtä. Kopioit ascAppId:n toiselta tiimiltä tai toisesta projektista.
• Käyttäjällä ei ole pääsyä sovellukseen. App Manager tai Developer voi olla rajattu tiettyihin sovelluksiin. Tiimiavaimella taas on pääsy kaikkiin tilin sovelluksiin.

"… is not available to team" tai "… is not available to provider"

Tämä viesti tulee, kun EAS luo sovellustietueen puolestasi, koska ascAppId puuttuu. Bundle-tunniste on jo toisen tiimin käytössä. EAS pyytää vaihtamaan sen sovelluksesi asetuksissa ja ajamaan komennon uudelleen.

"App name "…" is already taken. Using generated name "…""

Tämä ei ole epäonnistuminen. Kun nimi on jo varattu App Storessa, EAS lisää kuusi satunnaista merkkiä ja yrittää uudelleen, enintään viisi kertaa. Voit nimetä sovellustietueen myöhemmin uudelleen App Store Connectissa. Välttääksesi tämän täytä profiiliin appName ja language ennen ensimmäistä lähetystä: ilman language-kenttää ensisijainen kieli on en-US.

Binäärin virheet: ITMS-koodit

Lähetyksen jälkeen Apple käsittelee buildin. Jos se hylkää sen, lokissa mainitaan yksi tai useampi ITMS-koodi. Tässä ne, jotka EAS:n lähetysvaihe tunnistaa ja selittää:

ITMS-koodi	Mitä Apple hylkää	Korjaus
90189	Build-numero on jo käytössä	autoIncrement
90062, 90186, 90478	Versio suljettu tai jo ohitettu	Nosta version
90683	Käyttöoikeuden perustelu puuttuu	ios.infoPlist
90725	Liian vanha iOS SDK	iOS-image tai Expo SDK
90054, 90055	Bundle eri kuin kohdesovelluksen	Korjaa ascAppId
90022, 90023, 90391, 90713	Ikonit puuttuvat tai väärin määritelty	Tarkista ikonit
90771	Taustatehtävien tunnisteet puuttuvat	ios.infoPlist

Kolme tarkennusta näistä viesteistä:

• Build-numero on yksilöllinen versiota kohden. Koodille 90189 EAS suosittelee "autoIncrement": true eas.json-tiedostossa. Kaikki on kerrottu artikkelissa build-numero ja versio.
• Koodille 90725 EAS neuvoo valitsemaan uudemman iOS-imagen eas.json-tiedostossa ja tarvittaessa siirtymään tuettuun Expo SDK:hon.
• Koodissa 90771 Info.plist ilmoittaa taustatilan processing mutta ei avainta BGTaskSchedulerPermittedIdentifiers.

Koodeja 90054 ja 90055 lukuun ottamatta, joissa riittää osoittaa oikeaan sovellukseen tai toiseen buildiin, korjaus koskee binääriä: tee uusi build ja lähetä se uudelleen. Kahdelle koodille on oma oppaansa: ITMS-90683 Expolla ja ITMS-90725.

Syyskuun lopussa 2026 Solysin build hylättiin toimituksessa koodilla ITMS-90683. Olin poistanut kuvia koskevan käyttöoikeuden perustelun siivotessani asetustiedostoa. Solys ei käytä kuvia, mutta yksi projektin kirjastoista kutsuu iOS:n Photos-rajapintaa. Apple analysoi binäärin, ei todellista käyttöä: siitä lähtien en ole enää koskaan poistanut näitä perusteluja.

Missing Compliance -tila taas ei ole lähetysvirhe. Siitä puuttuu salausta koskeva ilmoituksesi, jota käsitellään EAS-julkaisuoppaassa.

Tarkistuslistani ennen jokaista lähetystä

• ascAppId on submit-profiilissa, lisättynä ennen buildia.
• API-avainta hallinnoi EAS, tai sen kolme kenttää osoittavat repositorion ulkopuolella säilytettyyn .p8-tiedostoon.
• Account Holder on hyväksynyt uusimmat sopimukset App Store Connectissa.
• autoIncrement on päällä yhdessä asetuksen "appVersionSource": "remote" kanssa, jota Expo suosittelee EAS CLI 12:sta lähtien.
• version on suurempi kuin viimeisin hyväksytty versio.
• Jokaisella binäärissä olevalla arkaluonteisella rajapinnalla on käyttöoikeuden perustelunsa.
• Uudelle sovellukselle appName ja language on täytetty ennen ensimmäistä lähetystä.

Lähetä ensimmäinen sovelluksesi jumittumatta

Komento on vain yksi vaihe. iOS & Android Kit lähtee liikkeelle sovellusteni aloituskoodista tilauksineen ja etenee neljässä vaiheessa App Storeen asti, omaan tahtiisi.

Jos valmistelet ensimmäistä julkaisuasi, tee ilmainen diagnoosi: se kertoo, mikä sinua oikeasti jarruttaa, ja lähettää sinulle tarkistuslistani Applen hylkäysten välttämiseen. Sovellussivun, kuvakaappausten ja hyväksynnän osalta sivu sovelluksen julkaisu App Storessa käy läpi jokaisen vaiheen.

Usein kysytyt kysymykset

Miksi eas submit epäonnistuu vain jatkuvassa integraatiossa?

--non-interactive-tilassa komento ei voi kysyä sinulta mitään. Se tarvitsee profiiliin ascAppId:n ja sovellukseen jo liitetyn API-avaimen, tai avaimen kolme kenttää eas.json-tiedostoon. Omalla koneellasi se olisi kysynyt nämä sinulta.

Pitääkö eas submit -virheen jälkeen tehdä uusi build?

Vain jos Apple hylkää binäärin ITMS-koodilla. Poikkeus: koodeissa ITMS-90054 ja 90055 build osoitti väärään sovellukseen, ja riittää lähettää se oikeaan. Asetus- ja tilivirheet korjataan eas.json-tiedostossa, App Store Connectissa tai Apple-tililläsi. Sen jälkeen lähetät saman buildin uudelleen, esimerkiksi valitsimella --latest tai --id.

Mistä näen EAS Submit -lähetyksen lokit?

Lähetyksen sivulta Expon hallintapaneelista. Expo neuvoo lukemaan sieltä lokit ja "Build Annotations" -kuplan. Terminaalissa lisää --verbose, niin lokit näkyvät aina.

Voiko eas submitia käyttää ilmaisella Apple-tilillä?

Ei. Expo vaatii maksullisen Apple Developer -tilin sovelluksen lähettämiseen App Storeen. Ilmaisella tilillä voit testata omalla iPhonellasi, mutta et käyttää App Store Connectia.

Mikä rooli API-avaimelle kannattaa antaa eas submitia varten?

Expon opas antaa avaimelle Admin-roolin. Applen roolitaulukon mukaan buildien lähettäminen on sallittu myös rooleille App Manager ja Developer. Expo-buildini pyörivät tiimiavaimella, jonka rooli on App Manager. Vain Account Holder ja Adminit voivat luoda tiimiavaimen.

Mitä "Increment Build Number" tarkoittaa EAS:ssä?

Apple hylkäsi buildin koodilla ITMS-90189: tämä build-numero on jo olemassa tälle versiolle. Ota käyttöön "autoIncrement": true eas.json-tiedostossa tai nosta ios.buildNumber, ja tee sitten uusi build.