פרסום של קובץ התקנה

במאמר הזה מוסבר איך לפרסם את המשחק ב-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: שם החבילה של המשחק. זהו המזהה הייחודי שישויך למשחק שלכם ב-Google Play. לדוגמה, com.yourcompany.yourgame. שם החבילה חייב לעמוד בכללים הבאים:
     • הוא צריך לכלול לפחות שני מקטעים (נקודה אחת או יותר).
     • כל פלח חייב להתחיל באות.
     • כל התווים חייבים להיות אלפאנומריים או קו תחתון ([a-zA-Z0-9_]).

   • ‫VERSION_NAME: מחרוזת הגרסה של המשחק. המחרוזת יכולה להיות שרירותית, אבל היא חייבת להיות ייחודית בכל קובצי ה-WAB שהועלו למשחק. לדוגמה: 1.0, 1.0.1-beta, 2025.11.24, v1.rc1.

     • ‫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_ELEVATION: מציין אם צריך להריץ את קובץ ההפעלה של המשחק או של מרכז ההפעלה כאדמין בכל פעם שמפעילים אותו.

       • ‫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 מהתפריט הנפתח + הוספת גורם צורה.

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

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

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

הפעלת הפרסום המנוהל

כדי להפעיל את התכונה 'פרסום מנוהל', פועלים לפי השלבים הבאים.

1. בדף סיכום השינויים לפרסום, בקטע פרסום מנוהל, לוחצים על הפעלת פרסום מנוהל.
2. תופיע תיבת דו-שיח. עוברים אל הפרסום המנוהל פועל בנושא.
3. לוחצים על שמירה.

העלאת קובץ WAB

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

1. בתפריט הימני ב-Play Console, בוחרים באפשרות בדיקה והפצה > הגדרות מתקדמות (קישור ישיר).
2. בדף הגדרות מתקדמות, לוחצים על הכרטיסייה גורמי צורה.
3. בכרטיסייה גורמי צורה, לוחצים על + הוספת גורם צורה ובוחרים באפשרות Google Play Games במחשב כדי להוסיף אותה.
4. בקטע Google Play Games on PC (משחקי Google Play במחשב), לוחצים על Manage (ניהול).
5. בוחרים באפשרות שימוש במסלול ייעודי למשחק ב-Windows App Bundle.
6. לוחצים על שמירה.
7. בתפריט הימני ב-Play Console, בוחרים באפשרות בדיקה והפצה > גרסת ייצור (קישור ישיר).
8. בדף Production, בוחרים באפשרות Google Play Games on PC (Windows) only מהתפריט הנפתח של גורם הצורה.
9. בכרטיסייה Windows app bundle (חבילת אפליקציות ל-Windows), לוחצים על Edit (עריכה) ומעלים את קובץ ה-WAB.

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

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

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

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

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

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

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

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

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