הגשה ל-⁠App Review ושחרור

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

הכלים שמאחורי הבקשות האלה: כל כלי ה-⁠MCP › App Review ופרודקשן ו-⁠דחיות.

מי עושה מה

‏App Store

1. הגשה ל-⁠App Review

   הסוכן שלך בוחר את הבנייה ב-⁠TestFlight ומבקש; אתה מאשר. המוצרים בתוך האפליקציה שמוכנים נשלחים איתה. קודם דף החנות צריך להיות שלם:‏ Ploa אומרת מה חסר, וגם preflight.

2. ‏App Review מחליטים

   בדרך כלל תוך יום או יומיים.‏ Ploa שומעת את התשובה תוך דקות ומודיעה לך במכשירים שלך.

3. שחרור

   כשנבחר "אוטומטית", Apple משחררת את הגרסה בעצמה. כשנבחר "ידני", היא מחכה לך (Pending Developer Release): הסוכן שלך מבקש לשחרר אותה, לכולם או בשחרור הדרגתי.

4. שחרור הדרגתי

   במשך 7 ימים, חלק הולך וגדל מהאנשים שהעדכונים האוטומטיים אצלם פועלים מקבל אותה; כל אחד עדיין יכול להוריד אותה מהחנות. אפשר להשהות (עד 30 יום בסך הכול), להמשיך, או לשחרר לכולם עכשיו.

אפשרות השחרור: אוטומטית אחרי האישור, או ידנית.‏ Ploa שומרת אותה לאפליקציה ומגדירה אותה בכל גרסה הבאה לפני שהיא נשלחת לבדיקה של App Review.‏ Apple מקבלת שינוי בגרסה עד שהיא מאשרת אותה; אחרי זה הגרסה יוצאת כמו שהוגדר, והמתג בכרטיס App Review, שנקרא עכשיו "הגרסאות הבאות", חל על הגרסאות שאחריה. הסוכן שלך מבקש לשנות אותה (ploa_appstore_release_type), או שאתה משנה אותה מכרטיס App Review.

צעדים ש-⁠Apple משאירה לך

לחלק מהטפסים ב-⁠App Store Connect אין API, וחלק רק ה-⁠Account Holder או Admin יכולים למלא. כשהסוכן שלך מבקש App Review, כש-⁠App Review דוחים גרסה, וכש-⁠Apple מסרבת לבקשה בגלל הסכם,‏ Ploa פותחת כל צעד כזה כמשימה באישורים שלך, עם צעדים ממוספרים, התשובה שהיא מציעה והקישור. הסוכן שלך מפרט אותן (ploa_person_tasks) ומוביל אותך בכל אחת.

• ‏App Privacy, לפי תשובות הפרטיות (ראה פרטיות).
• ההצהרה על מכשיר רפואי מפוקח, לאפליקציות בקטגוריות Health & Fitness או Medical, או לאפליקציות עם מידע רפואי תכוף, שנמכרות באיחוד האירופי או ב-⁠EEA, בבריטניה או בארצות הברית.
• מעמד סוחר באיחוד האירופי (Digital Services Act), פעם אחת לחשבון ופעם אחת לכל אפליקציה.
• ‏Paid Applications Agreement עם טופסי המס והבנק שלו, כשהאפליקציה מוכרת משהו (ראה רכישות בתוך האפליקציה).
• שאלות דירוג גיל ש-⁠Apple מוסיפה ו-⁠Ploa עוד לא מכירה, זכויות תוכן כל עוד אין ל-⁠Apple תשובה, תשובות או מסמכים של תאימות לייצוא שעוד חסרים, והסכם מעודכן שצריך לאשר.

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

החלפה או משיכה

• בנייה חדשה יותר בזמן שבנייה אחרת בבדיקה: אישור אחד מושך את הגרסה מהבדיקה, שם עליה את הבנייה החדשה ומגיש שוב. הבדיקה מתחילה מההתחלה.
• משיכה: מוציאה את הגרסה מהבדיקה (Remove from review ב-⁠App Store Connect), כך שאפשר לערוך אותה שוב, והבנייה שלה נשארת ב-⁠TestFlight.
• אחרי דחייה: מתקנים את מה ש-⁠App Review ביקשו ומגישים שוב, עם בנייה חדשה או עם אותה בנייה.‏ Ploa מחזירה את הגרסה בהגשה ש-⁠App Review החזירו, כמו Resubmit to App Review ב-⁠App Store Connect, ולכן לא עושים את זה שם ביד. אם App Review דחו בה גם משהו אחר, למשל אירוע באפליקציה,‏ Ploa אומרת את זה: מתקנים או מסירים אותו קודם ב-⁠App Store Connect.
• אישור אחד מספיק: אם Apple עדיין סוגרת הגשה קודמת של הגרסה,‏ Ploa מנסה שוב בעצמה כ-⁠20 דקות תחת אותו אישור, ואם הפעלה מחדש של Ploa קטעה הגשה, היא רצה שוב מעצמה. אף אחד לא מאשר את אותו צעד פעמיים.

בלשונית הגרסאות של האפליקציה › עמוד שחרור מופיע כרטיס הבדיקה של ה-⁠App Store: הגרסה, הבנייה והמצב שלה, אפשרות השחרור, היום בשחרור ההדרגתי, החלטות קודמות, והצעדים שאפשר לעשות עכשיו.

‏Google Play

1. קידום

   הסוכן שלך מבקש להעביר גרסה מבדיקה פנימית לפרודקשן, או לבדיקה סגורה או פתוחה; אתה מאשר. היא שומרת את "מה חדש" שאיתו יצאה, וגרסה שיצאה בלי הערות מקבלת את אלה שנכתבו מאז ("מה חדש" בשתי החנויות).

2. הפצה הדרגתית

   אפשר קודם לחלק מהמשתמשים (נגיד 10%), ואז להרחיב, לעצור או להשלים, כל אחד באישור שלך.

3. הבדיקה של Google

   בדרך כלל בין כמה שעות ליומיים; עד שבוע לפני שהגרסה הראשונה של אפליקציה יוצאת.‏ Ploa קוראת את מצב הבדיקה של הגרסה מ-⁠Google ומודיעה לך על התשובה, כמו על זו של App Review.

פרסום מנוהל. כשפרסום מנוהל (managed publishing) פועל ב-⁠Play Console, גרסה מאושרת מחכה עד שמפרסמים אותה שם. ל-⁠Google אין API לקרוא או לשנות פרסום מנוהל, או לפרסם את מה שהוא מחזיק. לכן Ploa יודעת שהוא פועל ברגע ש-⁠Google החזיקה גרסה מאושרת, ואז הכפתור שחרור ב-⁠Google Play בכרטיס של Google Play פותח את Publishing overview. ההפעלה והכיבוי שלך, ב-⁠Play Console › Publishing overview › Managed publishing. ב-⁠App Store אותה בחירה היא אפשרות השחרור של הגרסה (למעלה), ו-⁠Ploa כן משנה אותה, באישור שלך.

שינויים שממתינים ב-⁠Play Console. כשפרסום מנוהל פועל, או כש-⁠Google לא שולחת שינוי לבדיקה מעצמה,‏ Google Play שומרת את השינויים של Ploa בלי לשלוח אותם לבדיקה. ה-⁠API של Google לא יכול לשלוח אותם, אז Ploa מודיעה לך במכשירים ובעמוד השחרור, עם כפתור ל-⁠Publishing overview, ושם לוחצים "Send changes for review".

השחרור הראשון של אפליקציה חדשה לפרודקשן

‏Google מקבלת את השחרור הראשון של אפליקציה לפרודקשן רק ב-⁠Play Console. לפניו צריך לסיים את ההגדרה של Play Console עצמה: טופסי App content ודף החנות (ראה פרטיות), ובחשבון מפתח אישי חדש גם את הבדיקה הסגורה ואת Apply for production (ראה בודקים). ואז:

1. הסוכן שלך מבקש לקדם לפרודקשן

   אתה מאשר, ו-⁠Ploa מכניסה את הגרסה ל-⁠Production כטיוטה, כי Google מסרבת לכל דבר אחר באפליקציה שעוד לא פורסמה.

2. אתה מתחיל את ההפצה ב-⁠Play Console

   ‏Production › שחרור הטיוטה › Next (או Edit release) › Save › Start rollout to Production (או Publishing overview › Send for review). עמוד השחרור שומר את הצעדים האלה, עם הקישור, עד שזה נעשה.

3. ‏Google בודקת אותה

   לאפליקציה חדשה, לעיתים קרובות תוך כמה ימים. מכאן והלאה Ploa משחררת כל עדכון בעצמה.

מי מאשר

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

בלי סוכן, אותן בקשות יוצאות מ-⁠ה-⁠CLI:

ploa release ios --release <id> --submit            # ask to submit for App Review
ploa release ios --release <id> --submit --replace  # a newer build in place of the one in review
ploa release ios --release <id> --withdraw          # ask to take it out of review
ploa release ios --release <id> --app-store         # ask to release the approved version
ploa release ios --release <id> --phased pause      # pause | resume | complete
ploa release android --release <id> --promote production --rollout 10

כשחנות אומרת לא

‏Ploa אוספת למקום אחד את כל מה שהחנויות דחו: הגרסה ב-⁠App Store, בניות שהעיבוד של Apple דחה, בדיקת הבטא, מוצרים בתוך האפליקציה, אירועים, דפי מוצר, וגרסאות ב-⁠Google Play. לכל אחד: המצב, הסיבות שה-⁠API של החנויות נותן, הקישור לטקסט המלא, ומה עושים עכשיו.

1. נותנים את ההודעה לסוכן שלך

   ה-⁠API של Apple לא כולל את ההודעה של App Review או את מספרי ההנחיות, וב-⁠API של Google אין כזו לדחיות מטעמי מדיניות. מדביקים את ההודעה ב-⁠Ploa או נותנים אותה לסוכן, והיא נשמרת עם הדחייה, ביומן הפעולות. הסיבה של Google נמצאת ב-⁠Publishing overview של Play Console ובאימייל של Google.

2. הסוכן שלך מתקן את הסיבה

   בקוד או בדף החנות, ואז מבקש להחזיר את הגרסה, עם בנייה חדשה או עם אותה בנייה, לאישור שלך.

3. תשובה, רק אם App Review שאלו משהו

   הודעה שמבקשת תיקון לא צריכה תשובה: הבנייה המתוקנת היא התשובה, והיא חוזרת בלי שום טקסט. הודעה ששואלת שאלה או מבקשת מידע (למשל הנחיה 2.1, Information Needed) צריכה תשובה, שנשלחת לפני שהגרסה חוזרת, כי App Store Connect סוגר את השרשור ברגע הזה.‏ Ploa אומרת במה מדובר.

שליחת התשובה. ה-⁠API של Apple לא יכול לכתוב בשרשור של App Review, ולכן את התשובה שולח אתה. הסוכן שלך מנסח אותה באנגלית, קצרה וענינית, ומראה לך אותה; היא נשמרת מתחת לגרסה בעמוד השחרור עם להעתיק את התשובה, קישור לשרשור של ההגשה ב-⁠App Store Connect, ושלחתי. מדביקים אותה שם ולוחצים Send. הסוכן שלך יכול גם להכניס את התשובה ל-⁠App Review Information › Notes של הגרסה יחד עם ההגשה החוזרת (עד 4,000 תווים), כדי ש-⁠App Review יקראו אותה גם שם. כדי לערער על החלטה של Google, משתמשים בקישור שבאימייל של Google.

לפני שמרחיבים הפצה

‏Ploa קוראת את היציבות מהחנויות עצמן.‏ Google Play: שיעורי קריסות ו-⁠ANR על פני 28 ימים, לכל גרסה, מול הספים של Play להתנהגות רעה (1.09% קריסות, 0.47% ANR), והקריסות שאנשים נתקלים בהן הכי הרבה.‏ App Store: ל-⁠API של Apple אין שיעורי קריסות, ולכן Ploa נותנת את מה ש-⁠Apple מציעה: המדדים של Xcode לכל גרסה (זמן פתיחה, תקיעות, זיכרון, כתיבות לדיסק) עם הנסיגות ש-⁠Apple מזהה, והאבחונים של כל בנייה. לשונית החנות של האפליקציה › איכות מציגה את אותו דבר.