לפני שאתם שולחים את המשחק לבדיקה ב-Google Play Games במחשב, כדאי להשתמש ברשימת המשימות הזו כדי לוודא שהמשחק עומד בכל הדרישות והשיטות המומלצות.
הגדרת הפרויקט
- מורידים ומייבאים את ה-SDK: משלבים את הגרסה העדכנית של Play Games PC SDK בסביבה שלכם. מידע נוסף זמין במדריך ל-Unity או במדריך ל-C++.
- יצירת מניפסט האפליקציה: יוצרים קובץ
manifest.xmlשממפה את<PackageName>לחבילה שלכם ב-Play Console. למידע נוסף, ראו את המדריך למניפסט. - חתימה דיגיטלית על קובץ ההפעלה: חתמו על המשחק באמצעות חתימה דיגיטלית של Authenticode ושמרו את האישור לכל העדכונים העתידיים. אפשר לדלג על השלב הזה במהלך הפיתוח המקומי על ידי הפעלת מצב פיתוח, אבל צריך לחתום על הקובץ הבינארי הסופי באמצעות אישור ייצור בפועל מרשות אישורים מוכרת. מידע נוסף זמין במאמר חתימה דיגיטלית על המשחק.
- פורמט ושליחת האישור: שולחים את פרטי האישור לנציג Google. קובץ האישור צריך להכיל רק מידע שקשור לאישור. ודאו שכל הבלוקים שלא קשורים לאישור הוסרו. אתם יכולים להשתמש ב-OpenSSL כדי להמיר קובצי DER או CER לפורמט PEM הנדרש.
שילוב של ממשקי API ותכונות
- מאתחלים את ה-SDK: מטמיעים את לוגיקת האתחול של ה-SDK, לדוגמה
InitializeAsync, במהלך ההפעלה לפני שמשתמשים בתכונות אחרות. מידע נוסף זמין במדריך להפעלה. - הטמעת כניסה חלקה: מאמתים את השחקנים באופן אוטומטי באמצעות חשבון הלקוח של Play Games דרך Recall API. מידע נוסף זמין במדריך לכניסה חלקה לחשבון.
- שילוב Play Integrity: משתמשים ב-
IntegrityClientכדי לבקש אסימונים ולאמת את הלגיטימיות של סשנים של משחקים בקצה העורפי. מידע נוסף זמין במדריך של Play Integrity. - הוספת Play Install Referrer: אם אתם צריכים לעקוב אחרי מקורות של צירוף משתמשים במחשב, שלבו את Install Referrer API. מידע נוסף זמין במדריך בנושא Install Referrer.
- טיפול בשגיאות אתחול: כדי להשתמש ב-SDK, צריך להפעיל את
GooglePlayInitialize(C++) או אתGooglePlayInitialization.InitializeAsync(C#) כדי לאתחל את ה-API. כדי להשתמש בכל API אחר, צריך להפעיל את הפונקציה הזו ולוודא שהקריאה החוזרת (callback) של ההמשך מסתיימת עםInitializeResult::ok()(C++) או ש-Result.IsOk(C#) מחזירה את הערךtrue. - טיפול בהשבתה חובה: טיפול ב-
kActionRequiredShutdownClientProcessעל ידי השבתת תהליך הלקוח בהקדם האפשרי. - טיפול בדרישות ההתקנה של Google Play Games: מטפלים ב-
kSdkRuntimeUnavailableעל ידי הודעה למשתמשים שצריך להתקין את Google Play Games ואת סביבת זמן הריצה של ה-SDK כדי להמשיך. - טיפול בעדכונים של Google Play Games: טיפול ב-
kSdkRuntimeUpdateRequiredעל ידי הודעה למשתמשים שנדרש עדכון של Google Play Games Runtime.
הטמעת החיוב ב-Play
- בדיקת סוגי רכישות: ודאו שהמשחק שלכם מסתמך רק על רכישות באפליקציה, כי אין תמיכה בתשלומים קבועים ובמינויים. מידע נוסף זמין בשאלות הנפוצות בנושא חיוב.
- שאילתה על פרטי המוצר: משתמשים ב-
QueryProductDetailsכדי לאחזר נתוני חנות מקומיים. אם יש לכם יותר מ-50 מוצרים, פצלו את הבקשה לכמה קריאות. מידע נוסף זמין במדריך לשאילתות על מוצרים. - הפעלת תהליך הרכישה: משתמשים ב-
LaunchPurchaseFlowכדי לעבד עסקאות באופן מקורי. אם סוגרים את הדפדפן בלי לשלם, אחרי חמש דקות מופיעה הודעת שגיאה על זמן קצוב לתפוגה. מידע נוסף זמין במדריך לתהליך הרכישה. - שחזור רכישות קיימות: מפעילים את
QueryPurchasesבהפעלה ובהעברה לחזית כדי לזהות רכישות שלא אושרו במכשירים שונים. מידע נוסף זמין במדריך לשחזור רכישות. - עיבוד מאובטח בקצה העורפי: מאמתים את ה-
purchaseTokenבקצה העורפי לפני שמעניקים הרשאות ומסיימים את התהליך באמצעותAcknowledgePurchaseאוConsumePurchase. מידע נוסף זמין במדריך לעיבוד מאובטח. - הביאו בחשבון את העיכוב בהפצה של מפתחות הרישוי: כשמגדירים מפתחות חיוב או רישוי חדשים ב-Play Console, צריך להמתין כמה שעות עד שהמטמון של הקצה העורפי יסתנכרן בין סביבות ההצגה של המסחר לפני שמבצעים בדיקות רכישה בזמן אמת. ניסיונות רכישה לפני שהסנכרון מסתיים יחזירו את קוד השגיאה 6.
בדיקה במצב פיתוח וביצוע בקרת איכות טרום-השקה
- בדיקה במצב פיתוח: מוסיפים את
<IsDeveloperMode>true</IsDeveloperMode>למניפסט ומגדירים את ה-GUID של השותף בתוכנית הגישה המוקדמת לבדיקה בסביבת פיתוח משולבת (IDE) מקומית. אם אין לכם GUID של שותף בגישה מוקדמת, מלאו את טופס ההתעניינות. - ניהול רכישות במצב פיתוח: כשבודקים רכישות במצב פיתוח, צריך להשלים את הרכישה תוך שלוש דקות כדי למנוע החזרים כספיים אוטומטיים. מידע נוסף זמין בשאלות הנפוצות בנושא בדיקות.
- הסרת מצב הפיתוח: צריך להסיר את התג
<IsDeveloperMode>לפני שאורזים את גרסת ה-build להפצה, בהקדם האפשרי. מידע נוסף זמין במדריך למצב פיתוח. - העברת ארגומנטים באמצעות מרכזי אפליקציות של צד שלישי: מעבירים את כל הארגומנטים הלא ידועים של שורת הפקודה שמתקבלים במרכז האפליקציות מהלקוח של Google Play Games ישירות לתהליך המשחק שנוצר. מידע נוסף זמין במדריך לריבוי תהליכים.
- בדיקה באמצעות VPN: אם אתם מבצעים בדיקה מאזור לא נתמך, השתמשו ב-VPN עם מצב TUN מופעל כדי לקבל כתובת IP נתמכת. מידע נוסף זמין במאמר שאלות נפוצות בנושא בדיקת VPN.
- תמיכה בקיצורי דרך בשולחן העבודה: כדי לקבל תמיכה חלקה בקיצורי דרך, עיינו בשאלות הנפוצות בנושא קיצורי דרך כדי להפעיל קיצורי דרך. אם תפעילו את המשחק או מרכז אפליקציות של צד שלישי ישירות באמצעות קיצור דרך, יכול להיות שתקבלו הודעות שגיאה באתחול.
אריזה, בדיקה ופרסום של המשחק
- אריזת ה-WAB: משתמשים בכלי הפרסום של Play כדי לארוז את המשחק ב-Windows App Bundle (WAB). גודל הקובץ של ה-WAB צריך להיות קטן מ-10GB כדי לפרסם אותו באמצעות Installer Publishing, וקטן מ-200GB כדי לפרסם אותו באמצעות Play Managed Publishing (פרסום מנוהל). למידע נוסף, קראו את המדריך לאריזה.
- משתמשים בגרסאות העדכניות ביותר של ערכות ה-SDK והכלים: צריך להדר ולארוז את הגרסה של האפליקציה באמצעות הגרסאות העדכניות ביותר של Play Games PC SDK, Play Games PC Unity SDK, הכלי למפתחים של Play PC וכלי הפרסום של Play.
- בודקים אם נדרשת הרשאה: אם צריך להפעיל את תוכנת ההתקנה, מרכז האפליקציות או תוכנת הסרת ההתקנה כאדמין בכל פעם שמפעילים אותם, חשוב לבדוק אם הגדרתם את
INSTALLER_REQUIRES_ELEVATION,LAUNCHER_REQUIRES_ELEVATIONאוUNINSTALLER_REQUIRES_ELEVATIONלערךtrue. אחרת, הם לא יפעלו עם הרשאות אדמין, וההפעלה תיכשל. למידע נוסף, ראו פורמט קובץ התצורה של WAB. - שליחת קובצי התקנה של מרכזי אפליקציות של צד שלישי: אם אתם משתמשים במרכז אפליקציות של צד שלישי, שלחו את קובץ ההתקנה שלו בתוך ה-WAB. מידע נוסף זמין במדריך לפרסום חבילות התקנה.
- טיפול בטוקן לסשן של הפעלה אוטומטית: אם מפעילים את ההפעלה האוטומטית על ידי הגדרת
acceptsCommandLineArguments="true"ב-play_publishing_config.xml, צריך לוודא שתוכנת ההתקנה מחלצת את הארגומנט--g_session_token=<token>של שורת הפקודה ומשתמשת בו כדי להפעיל את המשחק. חשוב לוודא שהמתקין מטפל במקרה החלופי שבו הטוקן לא קיים. מידע נוסף זמין במאמר שאלות נפוצות על מרכז האפליקציות. - עדכון המשחק ומרכז האפליקציות או מנהל ההתקנה: תוכן החבילה, כולל מנהלי ההתקנה של מרכז האפליקציות, חייב להיות ניתן לעדכון עצמי. לנהל את כל המשאבים שהמשחק צריך, כולל עדכון של מרכז האפליקציות עצמו.
- שיתוף פרטי ההשקה עם Google: פנו לשותף שלכם ב-Play ושתפו את שם החבילה, המדינות שבהן תתבצע ההשקה (באמצעות קודי ISO בני 2 תווים, למשל US, CA, MX) ואת תאריך ושעת ההשקה בזמן אוניברסלי מתואם (UTC).
- הגדרת גישה לבדיקה: צריך לספק קבוצת Google חיצונית כדי להוסיף אותה לרשימת ההיתרים לבדיקה, לתיעוד ולגישה ל-Google Drive. שתפו רשימת אימיילים של חשבונות בדיקה עם השותף שלכם ב-Play, כי מסלולי הבדיקה ב-Play Console לא נתמכים במחשב.
- הוספת גורם הצורה של המחשב: מוסיפים באופן מפורש את גורם הצורה "Google Play Games במחשב" לאפליקציה ב-Google Play Console. אם אין לכם גישה לכרטיסייה הזו, אתם צריכים לפנות לשותף Play כדי להוסיף את החשבון שלכם לרשימת ההיתרים.
- הגדרת הדרישות למחשבים: מזינים את דרישות החומרה (RAM, GPU, נפח אחסון) למחשבים עם Windows. מידע נוסף זמין במדריך לדרישות למחשבים.
- העלאת נכסים לחנות: מעלים את קובץ ה-WAB הארוז למסלול הייצור ומגדירים נכסים חזותיים. מידע נוסף זמין במדריך להעלאת נכסים.
- פרסום לבדיקה בסביבת המשתמש: בוחרים באפשרות פרסום ב-Google Play Console. בניגוד לגרסת Android, לחיצה על Publish (פרסום) ב-WAB לא מפעילה גרסה זמינה לכולם. במקום זאת, היא מאפשרת לחשבונות הבדיקה המשותפים שלכם לחפש את האפליקציה כדי לבצע בדיקות בסביבת משתמש אחרי תהליך הבדיקה של Google.
- השקה רשמית: Google שולטת בהשקה על סמך תאריך ההשקה הרשמי ששיתפתם עם השותף שלכם ב-Play.
- בדיקה במהלך הרישום מראש: במהלך שלב הרישום מראש, צריך לבצע בדיקה פנימית במדינה שלא נכללת באזורים שנבחרו לרישום מראש.
- אימות סיום תהליך ההתקנה: מוודאים שתהליך ההתקנה הראשי נשאר פעיל עד שכל מפתחות הרישום הנדרשים נוצרים ונרשמים. אם התהליך מסתיים לפני הזמן, אימות ההתקנה נכשל. מידע נוסף זמין במאמר פרסום של מנהל ההתקנה.
- שמירה על עקביות בכוורות הרישום וניקוי בזמן הסרת ההתקנה:
Google Play Games במחשב בודק את
HKEY_LOCAL_MACHINEלפניHKEY_CURRENT_USERומשתמש בערך התואם הראשון. חשוב לשמור על עקביות בכוורת הרישום בין עדכונים ובין כותרות של מרכזי אפליקציות משותפים, ולהסיר מפתחות רישום במהלך הסרת ההתקנה כדי שרשומותHKEY_LOCAL_MACHINEלא עדכניות לא יסתירו נתיביHKEY_CURRENT_USERתקינים. מידע נוסף זמין במאמר פרסום של מנהל ההתקנה.
מעבר מה-API ל-SDK
המעבר מה-API ל-SDK הוא שלב אופציונלי. אם אתם בוחרים להעביר את האתר, כדאי לפעול לפי ההמלצות הבאות:
- הסרת ממשקי API מדור קודם בארכיטקטורת REST: ממפים קריאות ל-Play Developer API מדור קודם (לדוגמה,
purchases.products.get) לפונקציות של Native SDK בצד הלקוח. מידע נוסף זמין במדריך להעברת נתונים (מיגרציה). - אימות הארגומנטים בשורת הפקודה: הארגומנטים בשורת הפקודה בסביבת ה-SDK עשויים להיות שונים מאלה שבסביבת ה-API. מוודאים שהחבילה מטפלת בכל הארגומנטים ומעבירה אותם בצורה נכונה. מידע נוסף זמין במאמר אימות.
- אימות נתיב הרישום: כדי שהמעבר ל-Native SDK יהיה חלק, הגדרת הרישום צריכה להיות זהה לגרסאות הקודמות. מידע נוסף זמין במדריך לקובצי WAB.