פרסם את המשחק שלך

במאמר הזה מוסבר איך לפרסם את המשחק ב-Google Play Games במחשב.

לפני שמתחילים

משלבים את Google Play Games SDK במשחק.

אריזת המשחק כקובץ WAB

כדי להשתמש ב-Google Play Games במחשב, צריך להעלות את קובץ ההתקנה של המשחק ל-Google Play Console כ-Windows App Bundle ‏ (WAB). כדי ליצור קובץ WAB, ​פועלים לפי השלבים הבאים:

1. מורידים את כלי הפרסום של Play. אפשר להריץ את הכלי הזה בשורת הפקודה של Windows או ב-PowerShell.

2. יוצרים את קובץ ההגדרות לפרסום ב-Play, עם שם כלשהו. לדוגמה, play_publishing_config.xml בפורמט הבא:

   <?xml version="1.0" encoding="UTF-8"?>
   <play-publishing-config version="1.0">
     <application>
       <package-name>PACKAGE_NAME</package-name>
       <version-name>VERSION_NAME</version-name>
     </application>
     <installer requiresElevation=INSTALLER_REQUIRES_ELEVATION>
       <path>INSTALLER_PATH</path>
       <installation-path-registry-location>
         <key-name>UNIQUE_REGISTRY_PATH</key-name>
         <value-name>InstallLocation</value-name>
       </installation-path-registry-location>
     </installer>
     <launcher requiresElevation=LAUNCHER_REQUIRES_ELEVATION>
       <launch-path-registry-location>
         <key-name>UNIQUE_REGISTRY_PATH</key-name>
         <value-name>InstallLocation</value-name>
       </launch-path-registry-location>
       <executable-invocation>
         <filename>RELATIVE_PATH_TO_LAUNCHER_EXE</filename>
         <arguments>LAUNCHER_ARGS_IF_ANY</arguments>
       </executable-invocation>
     </launcher>
     <uninstaller requiresElevation=UNINSTALLER_REQUIRES_ELEVATION>
       <uninstall-path-registry-location>
         <key-name>UNIQUE_REGISTRY_PATH</key-name>
         <value-name>UninstallString</value-name>
       </uninstall-path-registry-location>
     </uninstaller>
   </play-publishing-config>

   מחליפים את מה שכתוב בשדות הבאים:

   • ‫PACKAGE_NAME: שם החבילה של המשחק. לדוגמה, com.yourcompany.yourgame.
   • ‫VERSION_NAME: מחרוזת הגרסה של המשחק. לדוגמה, 1.0.0.

   • ‫INSTALLER_REQUIRES_ELEVATION: מציין אם צריך להפעיל את קובץ ההפעלה של מנהל ההתקנה כאדמין כדי להשלים את תהליך ההתקנה.

     • ‫true: הפעלת קובץ ההפעלה כמנהל.

     • ‫false: הפעלת קובץ ההפעלה בתור המשתמש הנוכחי.

   • ‫INSTALLER_PATH: הנתיב לקובץ ההתקנה ב-WAB. הנתיב הזה יכול להיות מוחלט או יחסי לספריית האב של קובץ ההגדרות לפרסום ב-Play. לדוגמה, path\to\test\installer. חשוב לזכור להשתמש ב-Authenticode ובחתימת קוד כדי לחתום על קובץ ההפעלה של תוכנת ההתקנה של המשחק.

   • ‫UNIQUE_REGISTRY_PATH: מפתח הבסיס שיכיל את כל פרטי הרישום שלכם. הוא צריך להיות ייחודי במחשב של המשתמש. זה יהיה הנתיב היחסי מעל HKLM. לדוגמה, SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\YourUniqueName. הערך הזה ייצור מפתח בסיס ב-HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName במחשב Windows 11 בגרסת ‎64-bit.

   • ‫LAUNCHER_REQUIRES_ESCALATION: מציין אם צריך להפעיל את קובץ ההפעלה של המשחק או של מרכז ההפעלה כאדמין בכל פעם שמפעילים אותו.

     • ‫true: הפעלת קובץ ההפעלה כמנהל.

     • ‫false: הפעלת קובץ ההפעלה בתור המשתמש הנוכחי.

   • ‫RELATIVE_PATH_TO_LAUNCHER_EXE: הנתיב לקובץ ההפעלה של המשגר או המשחק בספריית ההתקנה. הוא צריך לכלול את שם הקובץ של משגר המשחקים או של קובץ ההפעלה של המשחק. לדוגמה, אם קובץ המשגר או המשחק נקרא mygame.exe והוא ממוקם בתיקייה {INSTALL_DIR}\Resources\mygame.exe, צריך להזין Resources\mygame.exe

   • ‫LAUNCHER_ARGS_IF_ANY: ארגומנטים בשורת הפקודה שצריך להעביר למפעיל או למשחק. הערך הזה הוא אופציונלי.

   • ‫UNINSTALLER_REQUIRES_ELEVATION: מציין אם צריך להפעיל את קובץ ההפעלה של כלי ההסרה כאדמין כדי להשלים את תהליך ההסרה.

     • ‫true: הפעלת קובץ ההפעלה כמנהל.

     • ‫false: הפעלת קובץ ההפעלה בתור המשתמש הנוכחי.

   קובץ תצורה לדוגמה לפרסום ב-Play

   נניח שיש משחק בשם MyGame, עם קובץ התקנה game_installer.exe ומפעיל משחקים launcher.exe. בדוגמה מוצג גם אופן השימוש ב-CDATA. כך נראה play_publishing_config.xml:

   <?xml version="1.0" encoding="UTF-8"?>
   
   <play-publishing-config version="1.0">
     <application>
       <package-name>com.mycompany.mygame</package-name>
       <version-name>1.0.0</version-name>
     </application>
     <installer requiresElevation="true">
       <path>game_installer.exe</path>
       <installation-path-registry-location>
         <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MySystemWideUniqueKey</key-name>
         <value-name>InstallLocation</value-name>
       </installation-path-registry-location>
     </installer>
   
     <launcher requiresElevation="true">
       <launch-path-registry-location >
         <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MySystemWideUniqueKey</key-name>
         <value-name>InstallLocation</value-name>
       </launch-path-registry-location>
       <executable-invocation>
         <filename>launcher.exe</filename>
         <arguments><![CDATA[arg1&arg2>arg3]]></arguments>
       </executable-invocation>
     </launcher>
   
     <uninstaller requiresElevation="true">
       <uninstall-path-registry-location>
         <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MySystemWideUniqueKey</key-name>
         <value-name>UninstallString</value-name>
       </uninstall-path-registry-location>
     </uninstaller>
   </play-publishing-config>
   

3. מריצים את כלי הפרסום ב-Play בשורת הפקודה של Windows או ב-PowerShell.

   playpublishingtool.exe build-installer-bundle --input=PLAY_PUBLISHING_CONFIG_PATH --output=WAB_OUTPUT_PATH
   

   כדי להחליף קובץ WAB קיים עם אותו שם, משתמשים בארגומנט --force.

   playpublishingtool.exe build-installer-bundle --input=PLAY_PUBLISHING_CONFIG_PATH --output=WAB_OUTPUT_PATH --force
   

   מחליפים את מה שכתוב בשדות הבאים:

   • PLAY_PUBLISHING_CONFIG_PATH: הנתיב להגדרות הפרסום ב-Play. לדוגמה, path\to\play_publishing_config.xml.
   • ‫WAB_OUTPUT_PATH: הנתיב לקובץ ה-WAB. לדוגמה, path\to\output_bundle.wab.

   איך משתמשים בכלי הפרסום ב-Play

   נניח שיש לכם את הקובץ הבינארי של כלי הפרסום ב-Play‏ playpublishingtool.exe, את קובץ ההגדרות של הפרסום ב-Play‏ play_publishing_config.xml ואת קובץ ההתקנה של המשחק game_installer.exe בספריית העבודה הנוכחית.

   ספריית העבודה הנוכחית אמורה להיראות כך:

   .\
   ├── game_installer.exe
   ├── play_publishing_config.xml
   ├── playpublishingtool.exe
   

   כדי ליצור WAB בשם installer_bundle.wab באותה ספרייה, הפקודה תיראה כך:

   playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab
   

   עם הארגומנט --force, הפקודה תיראה כך:

   playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab --force
   

   אם הפקודה תצליח, הפלט ייראה כך:

   Successfully built the installer bundle at installer_bundle.wab
   

   מוצאים את קובץ ה-WAB בתיקייה:

     .\
     ├── game_installer.exe
     ├── installer_bundle.wab
     ├── play_publishing_config.xml
     ├── playpublishingtool.exe
   

פרסום המשחק באמצעות Play Console

אחרי שיוצרים בהצלחה את חבילת ה-WAB למשחק, מעלים אותה ל-Play Console ומנהלים את ההגדרות והדרישות שלה. פועלים לפי השלבים לפרסום המשחק:

הוספת גורם הצורה Google Play Games במחשב

צריך לבצע את השלב הזה רק בפעם הראשונה שמפרסמים משחק.

1. בתפריט הימני של Play Console, בוחרים באפשרות בדיקה והפצה > הגדרה > הגדרות מתקדמות (קישור ישיר).

2. עוברים לכרטיסייה גורמי צורה ומוסיפים Google Play Games on PC(Windows) מהתפריט הנפתח + הוספת גורם צורה.

3. בצד שמאל, לוחצים על הלחצן ניהול לצד גורם הצורה Google Play Games במחשב.

4. בוחרים באפשרות שימוש במסלול ייעודי למשחק ב-Windows App Bundle.

5. לוחצים על שמירה ואז שוב על שמירה בתיבת הדו-שיח לאישור.

העלאת קובץ WAB

כדי להעלות את קובץ ה-WAB:

1. בתפריט הימני ב-Play Console, בוחרים באפשרות בדיקה והשקה > גרסת ייצור (קישור ישיר).
2. בדף Production (ייצור), בוחרים באפשרות Google Play Games on PC (Windows) only (‫Google Play Games במחשב (Windows) בלבד) בתפריט הנפתח של גורם הצורה בצד שמאל.
3. בכרטיסייה Windows app bundle (קובץ Windows App Bundle), לוחצים על הלחצן Upload a Windows app bundle (העלאת קובץ Windows App Bundle) ומעלים את קובץ ה-WAB. לחלופין, אפשר גם ללחוץ על הלחצן העלאת חבילת אפליקציות ל-Windows בצד שמאל של התפריט הנפתח 'גורם צורה'.
4. לוחצים על שמירה.

הגדרת הדרישות למחשבי PC עם Windows

כדי להגדיר את הדרישות למחשבי PC עם Windows:

1. בתפריט הימני ב-Play Console, לוחצים על הגדלת מספר המשתמשים > נוכחות בחנות Play > הגדרות החנות (קישור ישיר).
2. בקטע דרישות למחשב, לוחצים על הלחצן עריכה בצד שמאל.
3. מעדכנים את השדות ולוחצים על שמירה.

הגדרת הגרפיקה של רכישה באפליקציה

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

1. בתפריט הימני של Play Console, בוחרים באפשרות הגדלת מספר המשתמשים > נוכחות בחנות > דף האפליקציה בחנות(קישור ישיר).
2. בקטע Default store listing (דף האפליקציה בחנות שמוגדר כברירת מחדל) בכרטיסייה Listings (דפי האפליקציה בחנות), לוחצים על הלחצן -> (חץ) בצד שמאל. פעולה זו תעביר אתכם לדף דף האפליקציה בחנות שמוגדר כברירת מחדל.
3. עוברים לקטע Google Play Games במחשב ומעלים את התמונה בגרפיקה של רכישה מתוך האפליקציה ב-Google Play Games במחשב (Windows).
4. לוחצים על שמירה.

שליחת שינויים לבדיקה

1. בתפריט הימני ב-Play Console, בוחרים באפשרות סקירת תהליך הפרסום.
2. בקטע השינויים עדיין לא נשלחו לבדיקה, לוחצים על שליחת השינויים לבדיקה.

אחרי שצוות הבדיקה יאשר את השינויים, המשחק שלכם יוצג ב-Google Play.