Build number App Store Connect: versiune și număr de build

Build number-ul din App Store Connect e numărul de build: cheia CFBundleVersion, care identifică fiecare upload. Versiunea, CFBundleShortVersionString, e numărul pe care clienții tăi îl văd în App Store. Apple cere ca perechea versiune și număr de build să fie unică: un număr de build se folosește o singură dată pentru aceeași versiune.

Cu Expo, versiunea o setezi tu, iar EAS poate incrementa numărul de build la fiecare build de producție. Ghidul ăsta explică cele două numere, regulile Apple, erorile ITMS-90062 și ITMS-90189, plus ce să verifici când build-ul tău nu apare.

Îmi public aplicațiile iOS cu Expo și EAS, printre ele Solys, TradaZen și Nolera. Setările de mai jos sunt cele din fișierele lor eas.json.

Versiune și număr de build: care e diferența?

Două chei din Info.plist îți identifică aplicația. Documentația Apple despre CFBundleShortVersionString o descrie ca versiunea vizibilă pentru utilizator: trei numere întregi separate prin puncte, de exemplu 10.14.1. Cea despre CFBundleVersion vorbește despre versiunea build-ului: unul până la trei numere întregi, doar cu cifre și puncte.

Element	Cheie iOS	Cine o vede	Câmp Expo
Versiune	CFBundleShortVersionString	Clienții tăi	version
Număr de build	CFBundleVersion	Tu și Apple	ios.buildNumber

Exemplu fictiv: pentru versiunea 1.4.0, trimiți build-urile 12, 13 și 14 în timpul testelor, apoi alegi unul pentru review. Ajutorul App Store Connect rezumă: versiunea leagă build-ul de pagina lui, numărul de build îl identifică peste tot în sistem.

Regulile Apple de incrementare

1. Perechea trebuie să fie unică. Conform documentației Xcode Cloud, App Store Connect cere o combinație unică de versiune și număr de build. Deci o aplicație de iPhone poate reporni de la 1 pentru o versiune nouă. O aplicație de Mac, nu: numărul ei trebuie să crească mereu.
2. O versiune aprobată e închisă. Odată ce Apple a validat versiunea 1.4.0, nu-i mai poți adăuga build-uri. Următoarea trebuie să aibă un număr mai mare.
3. Fiecare număr se compară ca întreg. 1.10 vine după 1.9, pentru că 10 e mai mare decât 9. O versiune 1.9 trimisă după o 1.20 aprobată va fi respinsă.

Sfatul meu: păstrează un număr de build întreg care crește mereu, fără să-l resetezi la 1. Repornirea de la 1 e permisă pe iPhone, dar un număr unic pe toată viața aplicației te ferește să încurci două build-uri în TestFlight. Asta văd la aplicațiile mele în modul remote: contorul continuă de la o versiune la alta.

Gestionarea versiunii și a build-ului cu Expo și EAS

Pagina Expo despre versiuni, actualizată pe 25 septembrie 2026, separă rolurile. Versiunea (version în app.json) rămâne la tine: o schimbi când pregătești o lansare nouă. Numărul de build (ios.buildNumber) îl poți lăsa în grija EAS. De altfel, Expo menționează uitarea incrementării lui ca o cauză frecventă de respingere la upload.

Totul se setează în eas.json:

{
  "cli": {
    "appVersionSource": "remote"
  },
  "build": {
    "production": {
      "autoIncrement": true
    }
  }
}

• "remote": serverele EAS păstrează numărul de build. E comportamentul recomandat din EAS CLI 12. Contorul pornește de la valoarea din configurația ta, sau de la 1, apoi ios.buildNumber e ignorat.
• "local": configurația ta e sursa de adevăr. Cu autoIncrement, EAS modifică ios.buildNumber în fișierul tău, iar tu trebuie să faci commit la schimbare după fiecare build.
• autoIncrement: referința eas.json acceptă true sau "buildNumber" pentru build, și "version" pentru a crește ultima cifră a versiunii. În modul remote, Expo precizează că "version" nu e suportat.

La mine, TradaZen și Nolera sunt pe remote. Solys a rămas pe local: numărul ei de build stă în app.json și fiecare build de producție îl crește în fișier. Ambele merg, dar modul remote elimină riscul unui commit uitat.

Două comenzi completează sistemul. eas build:version:set inițializează contorul remote: introdu ultimul număr trimis la Apple. eas build:version:sync copiază valorile remote în proiectul tău, util dacă vreodată compilezi cu Xcode. Cu EAS Update, modul remote nu merge cu politica nativeVersion: Expo recomandă appVersion.

ITMS-90062: versiunea e deja aprobată

Mesajul arată cam așa (numere fictive):

ERROR ITMS-90062: This bundle is invalid. The value for key
CFBundleShortVersionString [1.4.0] in the Info.plist file must
contain a higher version than that of the previously approved
version [1.4.0].

Apple a aprobat deja versiunea 1.4.0: nu mai poți adăuga build-uri la ea. Crește versiunea în app.json, de exemplu la 1.4.1, apoi pornește un build nou. Doar schimbarea numărului de build nu ajunge.

Dacă eroarea revine deși version e la zi, caută un câmp ios.version. Conform referinței configurației Expo, are prioritate față de version pe iOS. Același remediu pentru eroarea înrudită ITMS-90186, „Invalid Pre-Release Train”, care semnalează o versiune închisă pentru build-uri noi.

ITMS-90189: Redundant Binary Upload

Aici numărul de build e problema:

ERROR ITMS-90189: Redundant Binary Upload. You've already uploaded
a build with build number '12' for version number '1.4.0'.

Perechea 1.4.0 (12) există deja la Apple. Cu Expo, apar des patru cauze:

• Profilul folosit nu are autoIncrement. Dacă îți faci un profil separat pentru TestFlight, cum e cel de la Nolera, pune opțiunea și acolo.
• Contorul remote e în urmă. Ai trecut pe remote după upload-uri manuale: rulează eas build:version:set cu ultimul număr cunoscut de Apple.
• Commit-ul a fost uitat în modul local. Build-ul următor pornește de la numărul vechi.
• Retrimiți același binar. Cu eas submit, alege build-ul nou, nu pe cel vechi.

Corectura e mereu aceeași: un build nou cu un număr mai mare.

„No builds available”: build-ul tău nu apare

Build-ul a plecat, dar pagina ta nu ți-l propune. Verifică în ordinea asta.

1. E încă în procesare. Apple procesează fiecare build înainte să-l afișeze și îți trimite un e-mail la final. Expo vorbește în general de 10 până la 15 minute. Conform Apple, dacă stă peste 24 de ore în procesare, trebuie să deschizi un tichet în Feedback Assistant.
2. Așteaptă declarația ta de criptare. E statusul Missing Compliance, detaliat mai jos.
3. Versiunea nu corespunde. Un build 1.4.1 nu se încadrează sub o pagină pregătită ca 1.5.0 în App Store Connect. Aliniază-le.
4. Între timp a ieșit o versiune. Conform ajutorului despre alegerea build-ului, lista arată atunci doar build-urile trimise de la acea lansare.
5. Testerul e cel care nu-l vede. În aplicația TestFlight, „no builds available” înseamnă des că build-ul nu e în niciun grup, așteaptă review-ul beta sau a expirat. Detaliile sunt în TestFlight pentru testarea aplicației de iPhone.

Statusurile de știut

Statusurile care explică cel mai des un build lipsă, conform listei Apple. Processing și Failed nu apar acolo: sunt statusurile de upload descrise în urmărirea build-urilor.

Status	Ce înseamnă	Ce faci
Processing	Apple procesează build-ul	Aștepți e-mailul
Failed	Eroare la procesare	Citești eroarea, retrimiți
Missing Compliance	Criptare nedeclarată	Răspunzi sau Info.plist
Invalid Binary	Upload neconform	Corectezi, build nou
Expired	Peste 90 de zile	Build nou
Ready to Submit	Gata pentru test sau review	Îl adaugi într-un grup

Declară criptarea o dată pentru totdeauna

Fără cheia ITSAppUsesNonExemptEncryption, Apple îți pune întrebările de conformitate la fiecare versiune nouă. Cu Expo, câmpul se numește ios.config.usesNonExemptEncryption:

{
  "expo": {
    "ios": {
      "config": {
        "usesNonExemptEncryption": false
      }
    }
  }
}

false înseamnă: fără criptare, sau doar criptare scutită. Apple precizează că criptarea integrată în sistem, cum sunt conexiunile HTTPS, e în general scutită, și că răspunsul acoperă și bibliotecile tale. Toate trei aplicațiile mele declară false. Pune false doar dacă e adevărat pentru aplicația ta: declarația te angajează.

Poți schimba numărul unui build deja trimis?

Nu. Numărul e înscris în binarul semnat: ca să-l corectezi, îți trebuie un build nou.

Ce poți schimba e build-ul atașat versiunii tale. Apple permite un singur build per versiune, dar îl poți înlocui de câte ori vrei până la trimiterea în review:

1. Deschide versiunea în App Store Connect, secțiunea Build.
2. Treci cu mouse-ul peste build-ul actual și dă clic pe butonul de ștergere, semnul minus.
3. Dă clic pe butonul de adăugare, semnul plus, alege build-ul corect, apoi salvează.

Scoaterea unui build dintr-o versiune nu-l șterge din contul tău. Dacă versiunea e deja în review, retrage întâi trimiterea: review-ul va reîncepe de la zero.

Înainte de următorul upload

Numărul de build e doar una dintre verificările de la upload. Imaginea de build poate declanșa ITMS-90725, iar semnarea are capcanele ei, detaliate în certificat de developer iOS și provisioning profile. Tot lanțul, de la build la TestFlight, e în publicarea unei aplicații iOS fără Mac, iar timpii de review în durata de validare App Store. Toți pașii sunt adunați pe pagina publicarea unei aplicații în App Store.

Dacă îți pregătești prima lansare, fă diagnosticul gratuit: îți spune ce blochează în proiectul tău și îți trimite checklist-ul meu anti-respingere Apple. Ca să construiești aplicația, să conectezi abonamentele și s-o publici, iOS & Android Kit urmează parcursul în patru etape cu codul de pornire al aplicațiilor mele, în ritmul tău.

Întrebări frecvente

Care e diferența dintre versiune și build number în App Store Connect?

Versiunea e numărul public al lansării tale, de exemplu 1.4.0. Build number-ul identifică un binar anume trimis la Apple pentru acea versiune. Poți trimite mai multe build-uri pentru aceeași versiune, fiecare cu numărul lui.

Trebuie să schimb numărul de build la fiecare upload?

Da, pentru aceeași versiune. Apple respinge un al doilea upload cu aceeași pereche versiune și număr de build, e eroarea ITMS-90189. Cu EAS, autoIncrement se ocupă de asta la fiecare build de producție.

Numărul de build trebuie să repornească de la 1 la fiecare versiune?

Nu e obligatoriu. Pe iPhone, Apple acceptă un număr mai mic pentru o versiune nouă, pentru că doar perechea trebuie să fie unică. Un contor care crește mereu rămâne mai ușor de urmărit.

Cum schimb build number-ul în App Store Connect?

Nu poți modifica numărul unui build deja trimis. Poți în schimb înlocui build-ul atașat versiunii tale, din secțiunea Build a paginii, cât timp nu e în review. Pentru un număr nou, refă build-ul.

De ce nu apare build-ul meu în App Store Connect?

Cel mai des, e încă în procesare sau așteaptă declarația ta de criptare. Verifică și că versiunea lui corespunde cu cea a paginii tale. Peste 24 de ore în procesare, Apple cere să deschizi un tichet.