انتشار نصب‌کننده

این سند به شما نشان می‌دهد که چگونه با استفاده از نصب‌کننده بازی، بازی خود را در Google Play Games روی رایانه شخصی منتشر کنید.

در جریان نصب توسط توسعه‌دهنده، نصب‌کننده بازی که شما ارائه می‌دهید باید نصب، به‌روزرسانی و حذف بازی را مدیریت کند.

قبل از اینکه شروع کنی

کیت توسعه نرم‌افزاری بازی‌های گوگل پلی را در بازی خود ادغام کنید.

بازی خود را به صورت یک فایل WAB بسته‌بندی کنید

بازی‌های گوگل پلی روی کامپیوتر نیاز دارند که نصب‌کننده بازی شما به عنوان یک فایل بسته نرم‌افزاری ویندوز (WAB) در کنسول گوگل پلی آپلود شود. برای ایجاد یک فایل WAB، این مراحل را دنبال کنید:

1. ابزار انتشار Play را دانلود کنید. می‌توانید این ابزار را در خط فرمان ویندوز یا 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 در یک دستگاه ویندوز ۱۱ ۶۴ بیتی ایجاد می‌کند.

     • LAUNCHER_REQUIRES_ELEVATION : نشان می‌دهد که آیا لانچر یا فایل اجرایی بازی هر بار که اجرا می‌شود، باید به عنوان Administrator اجرا شود یا خیر.

       • "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 لانچر بازی 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 را در خط فرمان ویندوز یا 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_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 منتشر کنید

بعد از اینکه با موفقیت WAB بازی خود را ایجاد کردید، آن را در Play Console آپلود کنید و تنظیمات و الزامات آن را مدیریت کنید. برای انتشار بازی خود، مراحل زیر را دنبال کنید:

بازی های گوگل پلی را به فرم فاکتور کامپیوتر اضافه کنید

این مرحله فقط برای اولین باری که بازی را منتشر می‌کنید، لازم است.

1. در کنسول بازی در منوی سمت چپ، گزینه Test and release > Setup > Advanced settings ( لینک مستقیم ) را انتخاب کنید.

2. به برگه «فاکتورهای فرم» بروید و از منوی کشویی «افزودن فاکتور فرم» (+) Google Play Games on PC را اضافه کنید.

3. روی دکمه مدیریت مربوط به فرم فاکتور Google Play Games on PC در سمت راست کلیک کنید.

4. گزینه « استفاده از یک مسیر اختصاصی برای بازی بسته نرم‌افزاری ویندوز» را انتخاب کنید.

5. روی ذخیره کلیک کنید و سپس دوباره در کادر تأیید، ذخیره را انجام دهید .

فعال کردن انتشار مدیریت‌شده

برای فعال کردن انتشار مدیریت‌شده، این مراحل را دنبال کنید.

1. در صفحه مرور کلی انتشارات ، در بخش انتشارات مدیریت‌شده ، روی «فعال کردن انتشارات مدیریت‌شده» کلیک کنید.
2. یک کادر محاوره‌ای ظاهر می‌شود. برای آهنگ، گزینه انتشار مدیریت‌شده را فعال کنید.
3. روی ذخیره کلیک کنید.

فایل WAB را آپلود کنید

برای آپلود فایل WAB، مراحل زیر را دنبال کنید:

1. در کنسول بازی در منوی سمت چپ، گزینه Test and release > Advanced settings ( لینک مستقیم ) را انتخاب کنید.
2. در صفحه تنظیمات پیشرفته ، روی تب Form factors کلیک کنید.
3. در تب Form factors ، روی + Add form factor کلیک کنید و Google Play Games on PC را برای افزودن انتخاب کنید.
4. در بخش «بازی‌های گوگل پلی روی کامپیوتر» ، روی «مدیریت» کلیک کنید.
5. گزینه «استفاده از یک مسیر اختصاصی برای بازی بسته نرم‌افزاری ویندوز» را انتخاب کنید.
6. روی ذخیره کلیک کنید.
7. در کنسول بازی در منوی سمت چپ، گزینه Test and release > Production ( لینک مستقیم ) را انتخاب کنید.
8. در صفحه تولید ، از منوی کشویی مربوط به فرم فاکتور، گزینه «فقط بازی‌های گوگل پلی روی کامپیوتر (ویندوز)» را انتخاب کنید.
9. در برگه بسته نرم‌افزاری ویندوز ، روی ویرایش کلیک کنید و فایل WAB را آپلود کنید.

پیکربندی الزامات کامپیوتر ویندوزی

برای پیکربندی الزامات رایانه شخصی ویندوز:

1. در کنسول Play در منوی سمت چپ، گزینه‌ی «افزایش کاربران» > «حضور در فروشگاه» > «تنظیمات فروشگاه » ( لینک مستقیم ) را انتخاب کنید.
2. در بخش نیازمندی‌های رایانه شخصی ، روی دکمه ویرایش در سمت راست کلیک کنید.
3. فیلدها را به‌روزرسانی کنید و روی ذخیره کلیک کنید.

پیکربندی نمودار خرید درون‌برنامه‌ای

این یک مرحله اختیاری است. برای پیکربندی گرافیک خرید درون‌برنامه‌ای:

1. در کنسول Play در منوی سمت چپ، گزینه‌ی «افزایش کاربران > حضور در فروشگاه > فهرست فروشگاه‌ها » ( لینک مستقیم ) را انتخاب کنید.
2. در بخش فهرست فروشگاه‌های پیش‌فرض در تب فهرست‌ها ، روی دکمه -> (فلش) در سمت راست کلیک کنید. این شما را به صفحه فهرست فروشگاه‌های پیش‌فرض می‌برد.
3. به بخش بازی‌های گوگل پلی روی کامپیوتر بروید و تصویر را در قسمت «گرافیک خرید درون‌برنامه‌ای بازی‌های گوگل پلی روی کامپیوتر (ویندوز)» آپلود کنید.
4. روی ذخیره کلیک کنید.

ارسال تغییرات برای بررسی

1. در کنسول Play در منوی سمت چپ، نمای کلی انتشار را انتخاب کنید.
2. در بخش «تغییرات هنوز برای بررسی ارسال نشده‌اند» ، روی «ارسال تغییرات برای بررسی» کلیک کنید.

وقتی تیم بررسی تغییرات شما را تأیید کرد، بازی شما در گوگل پلی قابل مشاهده خواهد بود.