Guideline 2.5.4: Apple דוחה מצב רקע באפליקציה

הנחיה 2.5.4 מגבילה את מצבי הרקע לשימוש שלשמו הם נועדו: צליל, מיקום, שיחות VoIP, סיום משימה, התראות מקומיות. הדחייה מגיעה כשה-Info.plist שלך מצהיר על אחד מהמצבים האלה והבודק לא מוצא שום פיצ'ר שצריך אותו. אם שום דבר לא משתמש במפתח, תסיר אותו. אחרת, תראה לבודק את הפיצ'ר תוך שלושים שניות.

אני מפרסם את אפליקציות ה-iOS שלי עם Expo. Solys, השעון המעורר שלי עם מיני-משחקים, מצהיר על מצב audio: הסרתי אותו, ואז החזרתי אותו מסיבה אחרת. המדריך הזה מבוסס על הטקסט של Apple, על דחיות שמפתחים אחרים פרסמו ועל הפרויקטים שלי. לתמונה הכללית של סיבות הדחייה, תקרא למה Apple דוחה אפליקציה.

מה אומרת הנחיה 2.5.4?

הכלל נכנס במשפט אחד, בסעיף 2 "Performance", חלק 2.5 "Software Requirements", של ה-App Review Guidelines: "Multitasking apps may only use background services for their intended purposes: VoIP, audio playback, location, task completion, local notifications, etc."

בפשטות: שירות רקע משמש רק למה שבשבילו הוא קיים. מכאן הכותרת "Guideline 2.5.4 - Performance - Software Requirements".

כברירת מחדל, אפליקציה שעוברת לרקע מושהית. כדי להמשיך לרוץ, היא מצהירה על מצב אחד או יותר במפתח UIBackgroundModes של ה-Info.plist שלה. התיעוד של Apple על מצבי רקע מבקש להשתמש בהם במשורה, בגלל הסוללה, ולהעדיף פתרון אחר כשיש כזה. כל מצב שמוצהר הוא הבטחה שהבודק יכול לבדוק.

מצבי הרקע והשימוש שלשמו הם נועדו

מצב	מפתח	שימוש מיועד
Audio, AirPlay, PiP	audio	צליל שנשמע ברקע
מיקום	location	מיקום רציף
Voice over IP	voip	שיחות עם CallKit
Background fetch	fetch	תוכן רשת באופן קבוע
Background processing	processing	משימות מתוזמנות
Remote notifications	remote-notification	Push של תוכן חדש

הטבלה הזו מסכמת את הדף של Apple. בדחיות שמתפרסמות בפורומים, audio, location ו-voip חוזרים הכי הרבה.

מה אומרת הודעת הדחייה של 2.5.4?

ההודעה מציינת את המצב הבעייתי. שתי דוגמאות שמפתחים פרסמו בפורומים של Apple:

• Audio: "Your app still declares support for audio in the UIBackgroundModes key in your Info.plist but did not include features that require persistent audio." ההמשך מבהיר שהמפתח audio מיועד לאפליקציות שמשמיעות תוכן ברקע, כמו נגן מוזיקה. הוא מציע שתי דרכים: להוסיף תוכן כזה או להסיר את המפתח (השרשור בפורום).
• מיקום: בשרשור מדצמבר 2024, Apple לא מצאה שום פיצ'ר מלבד מעקב אחרי עובדים שדורש מיקום קבוע, וכתבה שהשימוש הזה לבדו לא מתאים.

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

יש גם מקרה הפוך. בשרשור ממאי 2026, אפליקציה להקראה בקול, שבאמת השתמשה במצב audio, נדחתה כמה פעמים: הבודק לא הצליח להפעיל את הצליל. מפתח אחר כותב שם שלדעתו סרטון מצורף הוא מה ששחרר את המקרה שלו. זו עדות, לא כלל של Apple.

מאיפה המפתח הגיע אם לא הוספת אותו?

עם Expo, תוספי הקונפיגורציה (config plugins) הם אלה שממלאים את ה-Info.plist בזמן ה-prebuild. כלומר, מצב רקע יכול להיכנס לבינארי שלך בלי שהחלטת על זה.

התוסף expo-audio, בהגדרות ברירת המחדל

התיעוד של expo-audio אומר את זה: האפשרות enableBackgroundPlayback שווה true כברירת מחדל, וב-iOS היא מוסיפה את מצב audio. כלומר, מספיק להצהיר על התוסף בצורה הקצרה, "expo-audio", כדי להצהיר על המצב.

זה מה שמצאתי כשעברתי על TradaZen לפני ההגשה הראשונה שלה: צלילי ממשק קצרים בחזית, אבל תוסף שהוצהר בצורה קצרה. התיקון נכנס ב-app.json:

{
  "expo": {
    "plugins": [["expo-audio", { "enableBackgroundPlayback": false }]]
  }
}

חבילות אחרות מוסיפות מצב בדרך שלהן. האפשרות isIosBackgroundLocationEnabled של expo-location מוסיפה location רק אם אתה מפעיל אותה. expo-background-task, לעומת זאת, מוסיף processing ב-prebuild ברגע שהוא מותקן.

תיקיית ios/ שמחזיקה את המפתח הישן

מלכודת שנייה, שנפלתי בה עם Solys ביולי 2026. הסרתי את audio מ-app.json, אבל המפתח נשאר ב-ios/Solys/Info.plist, שנוצר קודם. prebuild בלי --clean משנה את הפרויקט הזה במקום ליצור אותו מחדש, והתוסף מוסיף את המפתח בלי להסיר אותו אף פעם. build מקומי היה מכניס אותו. build של EAS בענן מתחיל מ-prebuild חדש כש-ios/ מוחרג ב-git, וזה היה המצב אצלי.

לפני כל build, אני בודק מה באמת ייצא:

npx expo config --type introspect --json | grep -o '"UIBackgroundModes":\[[^]]*\]'
npx expo prebuild --clean --platform ios

הפקודה הראשונה מציגה את המצבים שה-prebuild יכתוב ב-Info.plist. השנייה יוצרת מחדש את הפרויקט הנייטיב ל-build מקומי, ומוחקת את תיקיית ios/. ב-Solys, הראשונה מציגה "UIBackgroundModes":["audio"], ב-TradaZen כלום: שני המצבים מכוונים.

הוספה או הסרה של מצב משנה את ה-Info.plist, כלומר את הבינארי: צריך build חדש, עדכון מרחוק לא מספיק. התיעוד של EAS Update מסווג שינויים כאלה בין אלה שדורשים בינארי חדש, כמו ב-ITMS-90683.

Solys: מצב audio מוצהר, עם סיבה אמיתית

Solys הוא שעון מעורר, אבל מצב audio לא משמש להשמעת ההתראה: הצלצול עובר דרך AlarmKit, שירות ההתראות של Apple שזמין מאז iOS 26 (התיעוד של AlarmKit). המערכת היא זו שמצלצלת, גם במצב שקט, לא האפליקציה.

ההיסטוריה של המפתח, כי ההיגיון חשוב יותר מהשורה:

1. בסוף יולי 2026 הסרתי אותו. שום דבר לא השמיע צליל ברקע: אפקטי הסאונד של המיני-משחקים נשארים בחזית, וההתראה לא תלויה באפליקציה.
2. יומיים אחר כך החזרתי אותו, עם האזנת הלילה. האפשרות הזו מקליטה את רעשי הלילה שלך עם המיקרופון ומנתחת אותם על האייפון. ההקלטה צריכה להמשיך כשהמסך נעול, והתיעוד של expo-audio מציין שגם אפשרות ההקלטה ברקע מוסיפה את מצב audio.

ההצדקה שינתה את אופייה: המצב משמש להקלטה, לא להשמעה. שלושה אמצעי הגנה, גלויים באפליקציה:

• ההאזנה היא אפשרות כבויה כברירת מחדל, שמופעלת מההגדרות או מטקס הערב;
• יש לה מסך הסכמה משלה, כמו שכלל 2.5.14 דורש לכל הקלטה, ושום דבר לא יוצא מהטלפון;
• המיקרופון נסגר עשר דקות לפני ההתראה, כדי שההאזנה והצלצול אף פעם לא יפריעו זה לזה.

אני לא יכול להבטיח שבודק תמיד יקבל את ההצהרה הזו. אני כן יודע להסביר, לכל רכיב, למה הוא משמש ואיפה רואים אותו.

שעונים מעוררים שהשאירו את האפליקציה ערה

לפני AlarmKit, אפליקציית שעון מעורר של צד שלישי לא יכלה לצלצל כמו ההתראה של Apple. לכן ספריות מסוימות השאירו את האפליקציה ערה: התיעוד של חבילת Flutter‏ alarm2 מתאר נגן אודיו שקט שרץ עד ההתראה. אבל צליל מושתק לא משמיע כלום. מאז iOS 26, AlarmKit הופך את העקיפה הזו למיותרת.

להשאיר או להסיר את המצב: טבלת החלטה

המצב שלך	מה לעשות
צלילים קצרים בחזית	להסיר את audio
מוזיקה או ספר שמע	להשאיר, ולהראות את זה
הקלטה ארוכה	להשאיר + הסכמה
שעון מעורר או טיימר	AlarmKit (iOS 26)
מיקום מדי פעם	שינויים משמעותיים
סנכרון לא דחוף	fetch או processing
שיחות אודיו או וידאו	voip עם CallKit

לגבי מיקום, הדף של Apple מציין את שירות השינויים המשמעותיים (significant location changes) כחלופה למצב location.

הסעיפים האחרים של 2.5: ‏2.5.1 ו-2.5.2

2.5.1: API ציבוריים ו-frameworks במקום שלהם

"Apps may only use public APIs and must run on the currently shipping OS." האפליקציה משתמשת רק ב-API ציבוריים, רצה על הגרסה הנוכחית של המערכת ונוטשת את מה שהוצא משימוש. כמו ב-2.5.4, כל framework משמש לשימוש המיועד שלו, שמוזכר בתיאור: HealthKit לבריאות, HomeKit לבית החכם. אם ספרייה קוראת ל-API פרטי, האפליקציה שלך היא זו שתיפול בדחייה.

2.5.2: בלי קוד שמורד ומשנה את האפליקציה

האפליקציה נשארת עצמאית בתוך החבילה שלה. היא לא יכולה "download, install, or execute code which introduces or changes features or functionality of the app". רק לאפליקציות חינוכיות שמלמדות לתכנת יש חריגה מוגבלת, עם קוד שגלוי לגמרי למשתמש וניתן לעריכה על ידו.

עם Expo, השאלה נוגעת ב-EAS Update, שהתיעוד שלו מזכיר שעדכונים חייבים לעמוד בכללי ה-App Store. תשמור את העדכונים מרחוק לתיקונים, אף פעם לא כדי לשחרר פיצ'ר שהבודק לא ראה. תיקון שקשור לבדיקה עובר דרך build חדש, כמו שאני מסביר במדריך של הנחיה 2.1.

איך לענות לדחייה של 2.5.4?

השיחה מתנהלת בחלק App Review של האפליקציה שלך, שם אתה עונה להודעה של App Review. שני מקרים:

• המצב לא משמש לכלום: תסיר אותו, תעשה build מחדש, תבדוק את ה-introspection, ואז תענה בשני משפטים.
• המצב משמש פיצ'ר אמיתי: תענה עם המסלול המדויק וסרטון קצר, ואז תעתיק את הטקסט הזה להערות לבודק (review notes) בכל גרסה.

התבנית שהייתי משתמש בה, להתאמה (תמחק את המשפט על ההתראה אם אין באפליקציה שלך כזו):

Hello,

The "audio" background mode is used only by [feature], an
optional feature that [records / plays] audio while the
device is locked. It is off by default.

How to test:
1. Open [screen] and turn on [feature].
2. Accept the microphone permission if asked.
3. Tap [button], then lock the device.
   [What the reviewer will hear or see.]

Our alarm does not use this mode: it is scheduled with
AlarmKit and rings through the system.

Attached: a short screen recording of these steps.

Best regards,

צ'קליסט 2.5.4 לפני הגשה

• ה-introspection של Expo מציג רק את המצבים שרצית, ואתה יודע לציין את הפיצ'ר של כל אחד.
• אף תוסף לא מוצהר בצורה קצרה אם הוא מוסיף מצב כברירת מחדל, כמו expo-audio.
• תיקיית ios/ המקומית שלך לא מחזיקה שום מפתח ישן, או שאתה מקמפל מ-prebuild נקי.
• הפיצ'ר מופעל מהר, בלי הגדרה מוסתרת, וההערות לבודק אומרות איזה מצב משמש למה ואיך לבדוק אותו.
• כל הקלטה מבקשת הסכמה מפורשת ומציגה אינדיקטור גלוי. הכללים על בקשות הרשאה נמצאים במדריך של הנחיה 5.1.1.
• בשעון מעורר, הצלצול עובר דרך AlarmKit, לא דרך צליל שמושמע מהאפליקציה.

לבדוק את התיק שלך לפני השליחה

ה-Review Kit מרכז את הצ'קליסט שלי לפני השליחה, תבניות של הערות לבודק ו-skills של Claude Code שעוברים על הפרויקט שלך. לעין אנושית, תקבע איתי שעה: נקרא יחד את ההודעה של Apple ואת ה-Info.plist שלך, בשיחת וידאו. התהליך המלא נמצא בדף אפליקציה שנדחתה על ידי Apple.

מכין את ההשקה הראשונה שלך? תעשה את האבחון החינמי: הוא מסדר את השלבים לפי הסדר ושולח לך את הצ'קליסט שלי נגד דחיות של Apple.

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

שאלות נפוצות

מה פירוש "Guideline 2.5.4 - Performance - Software Requirements"?

זו הכותרת של הדחייה כש-Apple חושבת שמצב רקע ב-Info.plist שלך לא משמש לשימוש המיועד שלו. ההודעה מציינת את המצב ומציעה להראות את הפיצ'ר שמשתמש בו או להסיר את המפתח.

צריך build חדש אחרי דחייה של 2.5.4?

אם אתה מסיר או משנה מצב, כן: המפתח נמצא ב-Info.plist, כלומר בבינארי. אם המצב מוצדק, תשובה עם המסלול המדויק וסרטון יכולה להספיק.

אפשר להשאיר את מצב audio בשביל כמה צלילי ממשק?

לא. צלילים קצרים שמושמעים בחזית לא צריכים אותו. עם Expo, תגדיר את enableBackgroundPlayback ל-false בתוסף expo-audio.

אפליקציית שעון מעורר צריכה את מצב audio?

לא בשביל לצלצל, אם היא נשענת על AlarmKit, שזמין מאז iOS 26: המערכת היא זו שמשמיעה את ההתראה. ב-Solys, מצב audio משמש להאזנת הלילה, שמקליטה כשהמסך נעול.

למה Apple מצטטת את 2.5.4 כשלא הצהרתי על כלום?

כנראה תוסף עשה את זה בשבילך: expo-audio מוסיף את מצב audio כברירת מחדל, ותיקיית ios/ ישנה יכולה להחזיק מפתח שהסרת מהקונפיגורציה. תבדוק עם npx expo config --type introspect.