רשימת משימות להשקה

כדאי להשתמש ברשימת המשימות הזו כדי לוודא שהמשחק עומד בכל הדרישות ופועל לפי שיטות מומלצות לפני ששולחים אותו לבדיקה ב-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. מידע נוסף זמין במדריך בנושא מקורות תנועה להתקנות.
• טיפול בשגיאות אתחול: כדי להשתמש ב-SDK, צריך לקרוא ל-GooglePlayInitialize (C++) או ל-GooglePlayInitialization.InitializeAsync (C#) כדי לאתחל את ה-API. כדי להשתמש בממשקי API אחרים, צריך לקרוא ל-API הזה ולוודא שהקריאה החוזרת להמשך מסתיימת עם InitializeResult::ok() (C++) או שהפונקציה Result.IsOk (C#) מחזירה true.
• טיפול בהשבתה חובה: טיפול ב-kActionRequiredShutdownClientProcess על ידי השבתת תהליך הלקוח בהקדם האפשרי.
• טיפול בדרישות ההתקנה של Google Play Games: צריך לטפל בkSdkRuntimeUnavailable על ידי הודעה למשתמשים שהם צריכים להתקין את Google Play Games ואת זמן הריצה של ה-SDK כדי להמשיך.
• טיפול בעדכונים של Google Play Games: טיפול ב-kSdkRuntimeUpdateRequired על ידי הודעה למשתמשים שנדרש עדכון של זמן הריצה של Google Play Games.

הטמעה של חיוב ב-Play

• בדיקת סוגי הרכישות: מוודאים שהמשחק מסתמך רק על רכישות מתוך האפליקציה, כי אין תמיכה בתשלומים חוזרים ובמינויים. מידע נוסף זמין בשאלות נפוצות בנושא חיוב.
• שאילתות על פרטי מוצרים: אפשר להשתמש ב-QueryProductDetails כדי לאחזר נתונים של חנויות מקומיות. אם יש לכם יותר מ-50 מוצרים, צריך לפצל את הבקשה לכמה קריאות. מידע נוסף זמין במדריך לשאילתות על מוצרים.
• הפעלת תהליך הרכישה: אפשר להשתמש ב-LaunchPurchaseFlow כדי לעבד עסקאות באופן מקורי. אם סוגרים את הדפדפן של התשלום בלי לשלם, מתרחשת שגיאת זמן קצוב לתפוגה של חמש דקות. מידע נוסף זמין במדריך לתהליך הרכישה.
• שחזור רכישות קיימות: קוראים ל-QueryPurchases בהפעלה ובמעבר לחזית כדי לזהות רכישות שלא אושרו במכשירים שונים. מידע נוסף זמין במדריך לשחזור רכישות.
• עיבוד מאובטח בקצה העורפי: מאמתים את purchaseToken בקצה העורפי לפני שמעניקים הרשאות ומבצעים את הפעולה הסופית באמצעות AcknowledgePurchase או ConsumePurchase. מידע נוסף זמין במדריך לעיבוד מאובטח.

בדיקה במצב פיתוח וביצוע בקרת איכות לפני ההשקה

• בדיקה במצב פיתוח: מוסיפים את <IsDeveloperMode>true</IsDeveloperMode> למניפסט ומגדירים את ה-GUID של השותף עם הגישה המוקדמת לבדיקה מקומית של סביבת פיתוח משולבת (IDE). אם אין לכם מזהה GUID של שותף עם גישה מוקדמת, אתם יכולים למלא את טופס ההתעניינות.
• ניהול רכישות במצב פיתוח: כשבודקים רכישות במצב פיתוח, צריך להשלים את הרכישה תוך שלוש דקות כדי למנוע החזרים כספיים אוטומטיים. מידע נוסף זמין בשאלות הנפוצות בנושא בדיקות.
• הסרת מצב הפיתוח: צריך להסיר את התג <IsDeveloperMode> לפני אריזת גרסת build להפצה, בהקדם האפשרי. מידע נוסף זמין במדריך למצב פיתוח.
• העברת ארגומנטים באמצעות מפעילים של צד שלישי: כל הארגומנטים הלא מוכרים של שורת הפקודה שמתקבלים מהמפעיל מלקוח Google Play Games מועברים ישירות לתהליך המשחק שנוצר. מידע נוסף זמין במדריך בנושא ריבוי תהליכים.
• בדיקה באמצעות VPN: אם אתם מבצעים בדיקה מאזור שלא נתמך, אתם יכולים להשתמש ברשת וירטואלית פרטית (VPN) עם מצב TUN מופעל כדי לקבל כתובת IP נתמכת. מידע נוסף זמין בשאלות הנפוצות בנושא בדיקות VPN.
• תמיכה בקיצורי דרך בשולחן העבודה: כדי לקבל תמיכה חלקה בקיצורי דרך, אפשר לעיין בשאלות הנפוצות בנושא קיצורי דרך. הפעלה ישירה של המשחק או של משגר של צד שלישי באמצעות קיצור דרך עלולה להוביל לשגיאות אתחול.

אריזה, בדיקה ופרסום של המשחק

• אריזת קובץ WAB: משתמשים בכלי הפרסום של Play כדי לארוז את המשחק בפורמט Windows App Bundle‏ (WAB). גודל קובץ ה-WAB צריך להיות קטן מ-10GB. מידע נוסף זמין במדריך האריזה.
• שליחת קובצי התקנה של מרכז אפליקציות של צד שלישי: אם אתם משתמשים במרכז אפליקציות של צד שלישי, אתם צריכים לשלוח את קובץ ההתקנה שלו בתוך ה-WAB. מידע נוסף זמין במדריך לפרסום כלי התקנה.
• עדכון המשחק ומפעיל האפליקציות או קובץ ההתקנה: התוכן בחבילה, כולל קובצי ההתקנה של מפעיל האפליקציות, חייב להיות ניתן לעדכון עצמי. לנהל את כל המשאבים שהמשחק צריך, כולל עדכון של מרכז ההפעלה עצמו.
• שיתוף פרטי ההשקה עם Google: צריך לפנות לשותף Play שלכם ולשתף את שם החבילה, את המדינות שבהן האפליקציה תושק (באמצעות קודי ISO בני 2 תווים, לדוגמה US,‏ CA,‏ MX) ואת תאריך ושעת ההשקה לפי זמן אוניברסלי מתואם (UTC).
• הגדרת גישה לבדיקות: צריך לספק קבוצת Google חיצונית כדי להוסיף אותה לרשימת ההיתרים לצורך בדיקות, תיעוד וגישה ל-Google Drive. כדאי לשתף עם השותף שלכם ב-Play רשימת כתובות אימייל של חשבונות בדיקה, כי מסלולי בדיקה ב-Play Console לא נתמכים במחשב.
• מוסיפים את גורם הצורה למחשב: מוסיפים באופן מפורש את גורם הצורה 'Google Play Games במחשב' לאפליקציה ב-Google Play Console. אם אין לכם גישה לכרטיסייה הזו, אתם צריכים לפנות לשותף שלכם ב-Play כדי להוסיף את החשבון שלכם לרשימת ההיתרים.
• הגדרת הדרישות למחשבים: מזינים את דרישות החומרה (זיכרון RAM, כרטיס מסך, נפח אחסון) למחשבים עם Windows. מידע נוסף זמין במדריך לדרישות המחשב.
• העלאת נכסי החנות: מעלים את קובץ ה-WAB הארוז למסלול לסביבת הייצור ומגדירים נכסים חזותיים. מידע נוסף זמין במדריך להעלאת נכסים.
• פרסום לבדיקה בסביבת משתמש: בוחרים באפשרות פרסום ב-Google Play Console. בשונה מגרסת Android, בחירה באפשרות פרסום ב-WAB לא מפעילה פרסום לציבור. במקום זאת, האפליקציה תהיה זמינה לחיפוש בחשבונות הבדיקה המשותפים שלכם כדי שתוכלו לבצע בדיקות בסביבת משתמש אחרי תהליך הבדיקה של Google.
• השקה רשמית: Google שולטת בהשקה על סמך תאריך ההשקה הרשמי ששיתפתם עם השותף שלכם ב-Play.

מעבר מ-API ל-SDK

המעבר מ-API ל-SDK הוא שלב אופציונלי. אם בוחרים לבצע מיגרציה, כדאי לפעול לפי ההמלצות הבאות:

• הסרת ממשקי API מדור קודם של REST: מיפוי קריאות ל-Play Developer API מדור קודם (לדוגמה, purchases.products.get) לפונקציות של Native SDK בצד הלקוח. מידע נוסף זמין במדריך להעברת נתונים.
• אימות הארגומנטים בשורת הפקודה: הארגומנטים בשורת הפקודה בסביבת ה-SDK עשויים להיות שונים מאלה שבסביבת ה-API. מוודאים שהחבילה מטפלת בכל הארגומנטים ומעבירה אותם בצורה נכונה. מידע נוסף זמין במאמר בנושא אימות.
• אימות נתיב הרישום: כדי שהמעבר ל-Native SDK יהיה חלק, הגדרת הרישום צריכה להיות עקבית עם הגרסאות הקודמות. מידע נוסף זמין במדריך לקובץ WAB.

למידע נוסף

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