# Build number ב-App Store Connect: גרסה ומספר build

> הגרסה היא המספר שהלקוחות שלך רואים, וה-build number מזהה כל העלאה. הצמד חייב להיות ייחודי, ועם Expo, EAS מעלה את מספר ה-build בשבילך.

עמוד מקורי: [Build number ב-App Store Connect: גרסה ומספר build](https://devoria.fr/he/blog/app-store-connect-build-number-version)
כותב: [Mehdi Azizi](https://devoria.fr/he/mehdi-azizi)
פרסום: 2026-11-04
עדכון תוכן אחרון: 2026-11-04


ה-build number של App Store Connect הוא מספר ה-build: המפתח `CFBundleVersion`, שמזהה כל העלאה. הגרסה, `CFBundleShortVersionString`, היא המספר שהלקוחות שלך רואים ב-App Store. **אפל דורשת שהצמד של גרסה ומספר build יהיה ייחודי: מספר build משמש פעם אחת בלבד לאותה גרסה.**

עם Expo, את הגרסה אתה קובע בעצמך, ו-EAS יכול להעלות את מספר ה-build בכל build של production. המדריך הזה מסביר את שני המספרים, את הכללים של אפל, את השגיאות ITMS-90062 ו-ITMS-90189, ומה לבדוק כשה-build שלך לא מופיע.

אני מפרסם את אפליקציות ה-iOS שלי עם Expo ו-EAS, ביניהן Solys, TradaZen ו-Nolera. ההגדרות שמוצגות בהמשך לקוחות מקובצי ה-`eas.json` שלהן.

## גרסה ומספר build: מה ההבדל?

שני מפתחות ב-Info.plist מזהים את האפליקציה שלך. [התיעוד של אפל על CFBundleShortVersionString](https://developer.apple.com/documentation/bundleresources/information-property-list/cfbundleshortversionstring) מתאר אותו כגרסה שהמשתמש רואה: שלושה מספרים שלמים מופרדים בנקודות, כמו 10.14.1. [התיעוד על CFBundleVersion](https://developer.apple.com/documentation/bundleresources/information-property-list/cfbundleversion) מדבר על גרסת ה-build: אחד עד שלושה מספרים שלמים, עם ספרות ונקודות בלבד.

| רכיב       | מפתח iOS                   | מי רואה אותו | שדה Expo          |
| ---------- | -------------------------- | ------------ | ----------------- |
| גרסה       | CFBundleShortVersionString | הלקוחות שלך  | `version`         |
| מספר build | CFBundleVersion            | אתה ואפל     | `ios.buildNumber` |

דוגמה בדויה: לגרסה 1.4.0 אתה מעלה את ה-builds ‏12, 13 ו-14 בזמן הבדיקות, ואז בוחר אחד מהם לבדיקה. [העזרה של App Store Connect](https://developer.apple.com/help/app-store-connect/manage-builds/upload-builds) מסכמת את זה: הגרסה מקשרת את ה-build לדף שלו, ומספר ה-build מזהה אותו בכל המערכת.

## כללי ההעלאה של אפל

1. **הצמד חייב להיות ייחודי.** לפי [התיעוד של Xcode Cloud](https://developer.apple.com/documentation/xcode/setting-the-next-build-number-for-xcode-cloud-builds), ‏App Store Connect דורש שילוב ייחודי של גרסה ומספר build. לכן אפליקציית iPhone יכולה להתחיל שוב מ-1 בגרסה חדשה. אפליקציית Mac לא: המספר שלה חייב תמיד לעלות.
2. **גרסה מאושרת נסגרת.** ברגע שאפל אישרה את גרסה 1.4.0, אי אפשר להוסיף לה עוד build. הגרסה הבאה חייבת לשאת מספר גבוה יותר.
3. **כל מספר מושווה כמספר שלם.** 1.10 בא אחרי 1.9, כי 10 גדול מ-9. גרסה 1.9 שנשלחת אחרי 1.20 מאושרת תידחה.

הטיפ שלי: **תשמור על מספר build שלם שתמיד עולה, בלי לאפס אותו ל-1.** איפוס ל-1 מותר ב-iPhone, אבל מספר ייחודי לכל חיי האפליקציה מונע בלבול בין שני builds ב-TestFlight. זה מה שאני רואה באפליקציות שלי במצב remote: המונה ממשיך מגרסה לגרסה.

## ניהול גרסה ו-build עם Expo ו-EAS

[הדף של Expo על גרסאות](https://docs.expo.dev/build-reference/app-versions/), שעודכן ב-25 בספטמבר 2026, מפריד בין התפקידים. הגרסה (`version` ב-app.json) נשארת באחריותך: אתה משנה אותה כשאתה מכין שחרור חדש. את מספר ה-build ‏(`ios.buildNumber`) אפשר להפקיד בידי EAS. Expo אגב מציינת ששכחה להעלות אותו היא סיבה נפוצה לדחייה בהעלאה.

הכול מוגדר ב-eas.json:

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

- **`"remote"`**: השרתים של EAS שומרים את מספר ה-build. זו ההתנהגות המומלצת מאז EAS CLI 12. המונה מתחיל מהערך שבקונפיגורציה שלך, או מ-1, ואז `ios.buildNumber` מתעלמים ממנו.
- **`"local"`**: הקונפיגורציה שלך קובעת. עם `autoIncrement`, ‏EAS משנה את `ios.buildNumber` בקובץ שלך, ואתה צריך לעשות commit לשינוי בכל build.
- **`autoIncrement`**: [הרפרנס של eas.json](https://docs.expo.dev/eas/json/) מקבל `true` או `"buildNumber"` עבור ה-build, ו-`"version"` כדי להעלות את הספרה האחרונה של הגרסה. במצב remote, ‏Expo מציינת ש-`"version"` לא נתמך.

אצלי, TradaZen ו-Nolera ב-`remote`. ‏Solys נשארה ב-`local`: מספר ה-build שלה יושב ב-app.json וכל build של production מעלה אותו בקובץ. **שתי השיטות עובדות, אבל מצב remote מבטל את הסיכון של commit שנשכח.**

שתי פקודות משלימות את התמונה. `eas build:version:set` מאתחלת את המונה המרוחק: תכניס את המספר האחרון שנשלח לאפל. `eas build:version:sync` מעתיקה את הערכים המרוחקים לפרויקט שלך, שימושי אם יום אחד תקמפל עם Xcode. עם EAS Update, מצב remote לא עובד עם מדיניות `nativeVersion`: ‏Expo ממליצה על `appVersion`.

## ITMS-90062: הגרסה כבר אושרה

ההודעה נראית ככה (מספרים בדויים):

```text
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].
```

אפל כבר אישרה את גרסה 1.4.0: אי אפשר להוסיף לה עוד build. **תעלה את הגרסה ב-app.json, למשל ל-1.4.1, ותריץ build מחדש.** לשנות רק את מספר ה-build לא מספיק.

אם השגיאה חוזרת למרות ש-`version` מעודכן, חפש שדה `ios.version`. לפי [הרפרנס של הקונפיגורציה של Expo](https://docs.expo.dev/versions/latest/config/app/), הוא גובר על `version` ב-iOS. אותו פתרון לשגיאה הקרובה ITMS-90186, ‏"Invalid Pre-Release Train", שמסמנת גרסה שסגורה ל-builds חדשים.

## ITMS-90189: Redundant Binary Upload

כאן מספר ה-build הוא הבעיה:

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

הצמד 1.4.0 (12) כבר קיים אצל אפל. עם Expo, ארבע סיבות חוזרות:

- **לפרופיל שבשימוש אין `autoIncrement`.** אם יצרת פרופיל נפרד ל-TestFlight, כמו זה של Nolera, תוסיף לו את האפשרות.
- **המונה המרוחק מפגר.** עברת ל-`remote` אחרי העלאות ידניות: תריץ `eas build:version:set` עם המספר האחרון שאפל מכירה.
- **שכחת commit במצב local.** ה-build הבא מתחיל מהמספר הישן.
- **אתה שולח שוב את אותו בינארי.** עם `eas submit`, תבחר את ה-build החדש, לא את הישן.

**התיקון תמיד אותו דבר: build חדש עם מספר גבוה יותר.**

## "No builds available": ה-build שלך לא מופיע

ה-build נשלח, אבל הדף שלך לא מציע אותו. תבדוק לפי הסדר הזה.

1. **הוא עדיין בעיבוד.** אפל מעבדת כל build לפני שהיא מציגה אותו ושולחת לך מייל בסוף. [Expo](https://docs.expo.dev/submit/ios/) מדברת בדרך כלל על 10 עד 15 דקות. [לפי אפל](https://developer.apple.com/help/app-store-connect/manage-builds/view-builds-and-metadata), אחרי יותר מ-24 שעות בעיבוד צריך לפתוח פנייה ב-Feedback Assistant.
2. **הוא מחכה להצהרת ההצפנה שלך.** זה הסטטוס Missing Compliance, שמפורט בהמשך.
3. **הגרסה לא תואמת.** build בגרסה 1.4.1 לא ישויך לדף שהוכן לגרסה 1.5.0 ב-App Store Connect. תיישר בין השניים.
4. **בינתיים יצאה גרסה.** לפי [העזרה על בחירת build](https://developer.apple.com/help/app-store-connect/manage-builds/choose-a-build-to-submit), הרשימה מציגה אז רק builds שנשלחו מאז השחרור הזה.
5. **הבודק הוא זה שלא רואה אותו.** באפליקציית TestFlight, ‏"no builds available" אומר לרוב שה-build לא נמצא באף קבוצה, מחכה לבדיקת בטא או שפג תוקפו. הפירוט נמצא ב-[TestFlight לבדיקת אפליקציית ה-iPhone שלך](https://devoria.fr/he/blog/testflight-test-iphone-app-before-submission).

### הסטטוסים שכדאי להכיר

הסטטוסים שהכי הרבה פעמים מסבירים build חסר, לפי [הרשימה של אפל](https://developer.apple.com/help/app-store-connect/reference/app-build-statuses). ‏Processing ו-Failed לא מופיעים בה: אלה סטטוסי העלאה שמתוארים ב-[מעקב ה-builds](https://developer.apple.com/help/app-store-connect/manage-builds/view-builds-and-metadata).

| סטטוס              | מה זה אומר              | התיקון שלך                 |
| ------------------ | ----------------------- | -------------------------- |
| Processing         | אפל מעבדת את ה-build    | לחכות למייל                |
| Failed             | שגיאה בעיבוד            | לקרוא את השגיאה, לשלוח שוב |
| Missing Compliance | הצפנה לא הוצהרה         | לענות או Info.plist        |
| Invalid Binary     | העלאה לא תקינה          | לתקן, build חדש            |
| Expired            | עברו 90 יום             | build חדש                  |
| Ready to Submit    | מוכן לבדיקה או ל-review | להוסיף אותו לקבוצה         |

### להצהיר על הצפנה פעם אחת ולתמיד

בלי המפתח `ITSAppUsesNonExemptEncryption`, [אפל](https://developer.apple.com/documentation/bundleresources/information-property-list/itsappusesnonexemptencryption) תשאל אותך את שאלות התאימות בכל גרסה חדשה. עם Expo, השדה נקרא `ios.config.usesNonExemptEncryption`:

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

`false` אומר: אין הצפנה, או רק הצפנה פטורה. [אפל מבהירה](https://developer.apple.com/documentation/security/complying-with-encryption-export-regulations) שהצפנה מובנית במערכת, כמו חיבורי HTTPS, פטורה בדרך כלל, ושהתשובה מכסה גם את הספריות שלך. שלוש האפליקציות שלי מצהירות `false`. **תשים `false` רק אם זה נכון לאפליקציה שלך: ההצהרה מחייבת אותך.**

## אפשר לשנות את המספר של build שכבר נשלח?

לא. המספר כתוב בתוך הבינארי החתום: כדי לתקן אותו צריך build חדש.

מה שאפשר לשנות זה את ה-build שמשויך לגרסה שלך. אפל מאפשרת build אחד לכל גרסה, אבל [אפשר להחליף אותו כמה פעמים שרוצים](https://developer.apple.com/help/app-store-connect/manage-builds/choose-a-build-to-submit) עד השליחה ל-review:

1. פתח את הגרסה ב-App Store Connect, באזור Build.
2. רחף מעל ה-build הנוכחי ולחץ על כפתור ההסרה, סימן המינוס.
3. לחץ על כפתור ההוספה, סימן הפלוס, בחר את ה-build הנכון ושמור.

הסרת build מגרסה לא מוחקת אותו מהחשבון שלך. אם הגרסה כבר ב-review, [קודם תמשוך את ההגשה](https://developer.apple.com/help/app-store-connect/manage-submissions-to-app-review/remove-a-submission-from-review): ה-review יתחיל מאפס.

## לפני ההעלאה הבאה שלך

מספר ה-build הוא רק אחת הבדיקות בהעלאה. ה-image של ה-build יכול לגרום ל-[ITMS-90725](https://devoria.fr/he/blog/itms-90725-sdk-version-issue-expo), ולחתימה יש מלכודות משלה, שמפורטות ב-[תעודת מפתח iOS ו-provisioning profile](https://devoria.fr/he/blog/ios-certificate-provisioning-profile-expo). השרשרת המלאה, מה-build ועד TestFlight, נמצאת ב-[לפרסם אפליקציית iOS בלי Mac](https://devoria.fr/he/blog/publish-ios-app-without-mac-expo-eas), וזמני ה-review ב-[כמה זמן לוקח אישור ב-App Store](https://devoria.fr/he/blog/app-store-review-time-how-long). כל השלבים מרוכזים בדף [לפרסם אפליקציה ב-App Store](https://devoria.fr/he/expertise/publish-an-app-on-the-app-store).

אם אתה מכין את השחרור הראשון שלך, [תעשה את האבחון החינמי](https://devoria.fr/he/diagnostic): הוא אומר לך מה תקוע בפרויקט שלך ושולח לך את הצ'קליסט שלי נגד דחיות של אפל. כדי לבנות את האפליקציה, לחבר מנויים ולפרסם אותה, ה-[iOS & Android Kit](https://devoria.fr/he/kits/ios) מלווה אותך במסלול של ארבעה שלבים עם קוד ההתחלה של האפליקציות שלי, בקצב שלך.

## שאלות נפוצות

### מה ההבדל בין גרסה ל-build number ב-App Store Connect?

הגרסה היא המספר הציבורי של השחרור שלך, כמו 1.4.0. ה-build number מזהה בינארי מסוים שנשלח לאפל עבור הגרסה הזו. אפשר לשלוח כמה builds לאותה גרסה, כל אחד עם מספר משלו.

### צריך לשנות את מספר ה-build בכל העלאה?

כן, לאותה גרסה. אפל דוחה העלאה שנייה עם אותו צמד של גרסה ומספר build, זו השגיאה ITMS-90189. עם EAS, ‏`autoIncrement` מטפל בזה בכל build של production.

### מספר ה-build צריך להתאפס ל-1 בכל גרסה?

זה לא חובה. ב-iPhone, אפל מקבלת מספר נמוך יותר לגרסה חדשה, כי רק הצמד צריך להיות ייחודי. מונה שתמיד עולה נשאר פשוט יותר למעקב.

### איך משנים את ה-build number ב-App Store Connect?

אי אפשר לשנות את המספר של build שכבר נשלח. אבל אפשר להחליף את ה-build שמשויך לגרסה שלך, מאזור Build בדף, כל עוד היא לא ב-review. בשביל מספר חדש, תעשה build מחדש.

### למה ה-build שלי לא מופיע ב-App Store Connect?

לרוב הוא עדיין בעיבוד או מחכה להצהרת ההצפנה שלך. תבדוק גם שהגרסה שלו תואמת לגרסה שבדף שלך. אחרי יותר מ-24 שעות בעיבוד, אפל מבקשת לפתוח פנייה.


## הפרויקט שלך

[Review Kit](https://devoria.fr/he/kits/app-review): הצ'קליסט שלי לבדיקת App Store, הדחיות שקיבלתי מ-Apple ואיך תיקנתי אותן, הצ'קליסט ל-Google Play ושלושה skills ל-Claude Code. ‏169 ‏⁦₪⁩.

[iOS & Android Kit](https://devoria.fr/he/kits/ios): תבנה אפליקציה לאייפון ולאנדרואיד עם Claude Code: קוד ההתחלה של האפליקציות שלי, כל הדרך עד החנויות וכל הקיטים. ‏349 ‏⁦₪⁩.

[אבחון: מה מפריד בינך לבין אפליקציית האייפון שלך](https://devoria.fr/he/diagnostic): 7 שאלות, 60 שניות: תדע מה באמת חוסם אותך מלפרסם את אפליקציית האייפון שלך, תקבל מסלול ב-4 שלבים ואת הקיט שמתאים לך.