این سند به شما نشان میدهد که چگونه بازی خود را در «بازیهای Google Play در رایانه» بااستفاده از نصبکننده بازیتان منتشر کنید.
با جریان «نصبشده توسط توسعهدهنده»، نصبکننده بازی که ارائه میدهید باید نصب، بهروزرسانی، و حذف نصب بازی را مدیریت کند.
قبلاز شروع
کیت توسعه نرمافزار «بازیهای Google Play» را در بازیتان ادغام کنید.
بازیتان را بهصورت فایل WAB بستهبندی کنید
«بازیهای Google Play در رایانه» نیاز دارد که نصبکننده بازی شما بهعنوان فایل Windows App Bundle (WAB) در «کنسول Google Play» بارگذاری شود. برای ایجاد فایل WAB، این مراحل را دنبال کنید:
ابزار انتشار Play را بارگیری کنید. میتوانید این ابزار را در خط فرمان Windows یا PowerShell اجرا کنید.
فایل پیکربندی انتشار 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 acceptsCommandLineArguments=ACCEPTS_COMMAND_LINE_ARGUMENTS> <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»: فایل اجرایی را بهعنوان «سرپرست» اجرا کنید.
- «نادرست»: فایل اجرایی را بهعنوان کاربر فعلی اجرا کنید.
ACCEPTS_COMMAND_LINE_ARGUMENTS: مقدار بولی که نشان میدهد آیا نصبکننده میتواند آرگومانهای خط فرمان را برای فعال کردن ویژگی پخش خودکار بپذیرد یا نه. این مقدار اختیاری است و مقدار پیشفرض نادرست است. برای اطلاعات بیشتر، فعال کردن پخش خودکار را ببینید.
INSTALLER_PATH: مسیر فایل نصبکننده شما در WAB. این مسیر میتواند مطلق یا نسبی به دایرکتوری والد پیکربندی انتشار Play باشد. برای مثال،path\to\test\installer. یادتان باشد که از authenticode و امضای کد برای امضا کردن فایل اجرایی نصبکننده بازیتان استفاده کنید.<installation-path-registry-location>: مسیر رجیستری که «بازیهای Google Play» برای تشخیص نصب بودن بازی استفاده میکند. حتی اگر بازیتان از راهانداز سفارشی استفاده میکند، این مسیر باید به کلید ثبت منحصربهفرد بازی اشاره کند، نه کلید ثبت راهانداز.
UNIQUE_REGISTRY_PATH: مسیر کلید رجیستری Windows. این مسیر باید نسبتبه کندوی رجیستری مانندHKEY_LOCAL_MACHINEیاHKEY_CURRENT_USERارائه شود؛ نام کندو را در رشته مسیر وارد نکنید. برای مثال، اگر نصبکننده شما درHKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueNameمینویسد، فقطSoftware\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueNameرا مشخص کنید. «بازیهای Google Play در رایانه» این مسیر را ابتدا درHKEY_LOCAL_MACHINEو سپس درHKEY_CURRENT_USERجستجو میکند و از اولین مقدار منطبقی که پیدا میکند استفاده میکند.فایل اجرایی مشخصشده در
این مسیر باید در دستگاه کاربر منحصربهفرد باشد. برای مثال:INSTALLER_PATHباید این کلیدهای رجیستری را ایجاد کند. پیشاز تکمیل نصب، این جفتهای کلید-مقدار رجیستری که درinstallation-path-registry-location،launch-path-registry-location، وuninstall-path-registry-locationمشخص شدهاند باید ایجاد شوند. درحالیکه این مثال ازInstallLocationوUninstallStringاستفاده میکند، میتوانید هر نامی را در این برچسبهای<value-name>مشخص کنید، بهشرطی که نصبکننده شما ورودیهای رجیستری مربوطه را برای هر سه ایجاد کند. «بازیهای Google Play در رایانه» از این مقادیر برای راهاندازی و حذف نصب بازی استفاده میکند. اگر بازیتان از راهانداز استفاده میکند، مقدار ورودی دفتر ثبت مشخصشده توسطlaunch-path-registry-locationباید به دایرکتوری راهانداز اشاره کند (درحالیکهinstallation-path-registry-locationباید به کلید دفتر ثبت منحصربهفرد بازی اشاره کند، نه کلید دفتر ثبت راهانداز).SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName.اگر نصبکننده بازی شما برنامهای ۳۲ بیتی است که در Windows ۶۴ بیتی اجرا میشود، Windows از تغییر مسیر رجیستری برای نوشتن ورودیهای رجیستری در
HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Nodeاستفاده میکند. برای مثال، نوشتن درHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueNameبهHKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueNameهدایت میشود.LAUNCHER_REQUIRES_ELEVATION: نشان میدهد که آیا راهانداز یا فایل اجرایی بازی باید هربار که راهاندازی میشود بهعنوان «سرپرست» اجرا شود یا نه.- «true»: فایل اجرایی را بهعنوان «سرپرست» اجرا کنید.
- «نادرست»: فایل اجرایی را بهعنوان کاربر فعلی اجرا کنید.
RELATIVE_PATH_TO_LAUNCHER_EXE: مسیر راهانداز یا فایل اجرایی بازی در فهرست نصب. این باید شامل نام فایل اجرایی راهانداز یا بازی شما باشد. برای مثال، اگر نام راهانداز یا فایل بازی شما mygame.exe باشد و در {INSTALL_DIR}\Resources\mygame.exe قرار داشته باشد، باید Resources\mygame.exe را وارد کنیدLAUNCHER_ARGS_IF_ANY: هرگونه متغیر مستقل خط فرمان که باید به راهانداز یا بازی شما منتقل شود. این ورودی اختیاری است.- درصورت وجود چند آرگومان مرتبط با فایل اجرایی، باید آنها را با فاصله از هم جدا کنید.
- اگر فایل اجرایی نیاز داشته باشد، متغیرهای مستقل باید با «--» یا «-» شروع شوند.
UNINSTALLER_REQUIRES_ELEVATION: نشان میدهد که آیا برای تکمیل فرایند حذف نصب، فایل اجرایی حذف نصب باید بهعنوان «سرپرست» اجرا شود یا نه.- «true»: فایل اجرایی را بهعنوان «سرپرست» اجرا کنید.
- «نادرست»: فایل اجرایی را بهعنوان کاربر فعلی اجرا کنید.
نمونه فایل پیکربندی انتشار 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> <!-- The package name for your game. --> <package-name>com.mycompany.mygame</package-name> <!-- The game's version string. --> <version-name>1.0.0</version-name> </application> <!-- If requiresElevation is "true", installer runs as Administrator and a UAC prompt is displayed. This is required for system-wide installs (e.g., to Program Files) or writing to HKLM. --> <!-- If acceptsCommandLineArguments is "true", the installer must be able to accept command-line arguments to enable the auto-play feature. --> <installer requiresElevation="true" acceptsCommandLineArguments="true"> <!-- Path to your installer executable. --> <path>game_installer.exe</path> <!-- The registry location where the installer writes the installation path. --> <installation-path-registry-location> <!-- Registry key path (typically under HKLM or HKCU). game_installer.exe MUST create this key. --> <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey</key-name> <!-- game_installer.exe, specified in <path>, creates the registry value called 'InstallLocation' within SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey by the time it exits. --> <value-name>InstallLocation</value-name> </installation-path-registry-location> </installer> <!-- If requiresElevation is "true", launcher runs as Administrator and a UAC prompt is displayed on every game launch. --> <launcher requiresElevation="true"> <!-- Specifies the registry location where Google Play Games reads the installation path in order to launch the game. --> <launch-path-registry-location > <!-- Registry key path (typically under HKLM or HKCU) where the launch path can be found. --> <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey</key-name> <!-- Google Play Games reads the installation directory from this registry value, for example InstallLocation, to launch the game. --> <value-name>InstallLocation</value-name> </launch-path-registry-location> <executable-invocation> <!-- Game executable or launcher filename, relative to the directory path specified in the InstallLocation registry value. --> <filename>launcher.exe</filename> <!-- Optional arguments to pass to the executable. CDATA is used here to avoid issues with special characters like & or >. --> <arguments><![CDATA[arg1&arg2>arg3]]></arguments> </executable-invocation> </launcher> <!-- If requiresElevation is "true", uninstaller runs as Administrator and a UAC prompt is displayed for uninstall. --> <uninstaller requiresElevation="true"> <!-- Registry key where Google Play Games finds the uninstallation command. --> <uninstall-path-registry-location> <!-- Registry key path (typically under HKLM or HKCU) where uninstall command can be found. --> <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey</key-name> <!-- game_installer.exe also creates the registry value, for example, 'UninstallString' within SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey, containing the command Google Play Games executes to uninstall the game. --> <value-name>UninstallString</value-name> </uninstall-path-registry-location> </uninstaller> </play-publishing-config>-
ابزار انتشار 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، پیکربندی انتشار Playplay_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
فعال کردن «پخش خودکار» پساز نصب «بازیهای بومی رایانه» (اختیاری)
«بازیهای Google Play در رایانه» به شما امکان میدهد ویژگی «پخش خودکار» را فعال کنید که بلافاصله پساز تکمیل فرایند نصب، بازی را بهطور خودکار راهاندازی میکند. این ویژگی با انتقال مستقیم بازیکن به بازی، تجربه کاربری یکپارچهای را ارائه میدهد و اصالتسنجی کامل را در بومسازگان «بازیهای Google Play در رایانه» انجام میدهد.
روش کار
وقتی ویژگی را فعال کنید، «بازیهای Google Play در رایانه» بااستفاده از آرگومانهای خط فرمان، یک کد جلسه را به فرایند نصبکننده طرف سوم (3P) شما ارسال میکند. سپس نصبکننده شما مسئول استخراج این کد و استفاده از آن برای راهاندازی فایل اجرایی بازی در بافت اصالتسنجیشده است.
پیشنیازها
برای استفاده از این ویژگی، نصبکننده طرف سوم شما باید بتواند آرگومانهای خط فرمان را مدیریت کند.
مراحل پیادهسازی
فعال کردن پخش خودکار در پیکربندی انتشار Play
برای موافقت با این ویژگی، مشخصه
acceptsCommandLineArgumentsرا به عنصر<installer>درplay_publishing_config.xmlخود اضافه کنید.نمونهای از گزیده محتوای
play_publishing_config.xml:<installer requiresElevation="true" acceptsCommandLineArguments="true"> <path>path/to/installer.exe</path> <installation-path-registry-location> <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\key</key-name> <value-name>InstallPath</value-name> </installation-path-registry-location> </installer>
- ویژگی:
acceptsCommandLineArguments - نوع:
Boolean - پیشفرض:
false - رفتار: وقتی آن را روی true تنظیم کنید، GPG هنگام اجرای نصبکننده شما، کد جلسه را به آرگومانهای خط فرمان اضافه میکند.
- ویژگی:
مدیریت کردن کد جلسه در نصبکننده
وقتی نصبکننده شما توسط کارخواه «بازیهای Google Play» راهاندازی میشود، کد جلسه را بهعنوان آرگومان خط فرمان دریافت میکند.
- قالب متغیر مستقل:
--g_session_token=<TOKEN>
آنچه باید انجام دهید:
- استخراج: نصبکننده شما باید آرگومانهای خط فرمان را تجزیه کند تا رشته کد را بازیابی کند.
- انتشار: اگر جریان نصب شما شامل راهاندازی یک راهانداز ثانویه یا فرایند بازی باشد، نصبکننده شما مسئول انتقال ایمن کد جلسه به فرایند نهایی بازی است که از کیت توسعه نرمافزار استفاده میکند.
- راهاندازی: از کد جلسه ارائهشده برای شروع فایل اجرایی بازی استفاده کنید. این کار تضمین میکند که بازی در بافت اصالتسنجیشده «بازیهای Google Play» اجرا میشود. درغیراینصورت، InitializeSDK ناموفق خواهد بود و بازیکن باید بازی را بازراهاندازی کند.
- قالب متغیر مستقل:
مدیریت کردن خطا و بازگشتها
- بازیابی کد: اگر به هر دلیلی «بازیهای Google Play» نتواند کد جلسه تولید کند یا آن را ارسال کند (برای مثال، ناموفق بودن تولید کد)، فرایند نصب همچنان ادامه خواهد یافت. بااینحال، نصبکننده شما بدون آرگومان
--g_session_tokenراهاندازی خواهد شد. - استحکام: نصبکننده شما باید بهگونهای طراحی شود که بتواند سناریوهایی را که در آن کد جلسه وجود ندارد مدیریت کند. در چنین مواردی، نصبکننده باید نصب استاندارد را ادامه دهد؛ نباید راهاندازی خودکار بازی را فعال کنید زیرا InitializeSDK بههرحال ناموفق خواهد بود.
- خطاهای نصبکننده: شما مسئول استحکام و رسیدگی به خطاهای نصبکننده و توالی راهاندازی بازی هستید که نصبکننده آغاز میکند. «بازیهای Google Play» کنترلی بر فرایندهایی که پساز راهاندازی نصبکننده در آن رخ میدهد ندارد.
- بازیابی کد: اگر به هر دلیلی «بازیهای Google Play» نتواند کد جلسه تولید کند یا آن را ارسال کند (برای مثال، ناموفق بودن تولید کد)، فرایند نصب همچنان ادامه خواهد یافت. بااینحال، نصبکننده شما بدون آرگومان
بازی را بااستفاده از «کنسول Play» منتشر کنید
پساز اینکه WAB را باموفقیت برای بازیتان ایجاد کردید، آن را در «کنسول Play» بارگذاری کنید و تنظیمات و الزامات آن را مدیریت کنید. مراحل انتشار بازی را دنبال کنید:
افزودن ضریب شکل «بازیهای Google Play در رایانه»
این مرحله فقط برای اولینباری که بازی را منتشر میکنید لازم است.
- در منوِ سمت راست «کنسول Play»، آزمایش و انتشار > راهاندازی > تنظیمات پیشرفته (پیوند مستقیم) را انتخاب کنید.
به برگه ضریبهای شکل بروید و
Google Play Games on PCرا از منو کرکرهای + افزودن ضریب شکل اضافه کنید.روی دکمه مدیریت مربوط به ضریب شکل بازیهای Google Play در رایانه در سمت راست کلیک کنید.
گزینه استفاده از بسته هدف اختصاصی برای بازی بسته برنامه Windows را انتخاب کنید.
روی ذخیره و سپس دوباره روی ذخیره در کادر گفتگوی تأیید کلیک کنید.
روشن کردن «انتشار مدیریتشده»
برای روشن کردن «انتشار مدیریتشده»، این مراحل را دنبال کنید.
- در صفحه نمای کلی انتشار، در بخش انتشار مدیریتشده، روی روشن کردن انتشار مدیریتشده کلیک کنید.
- کادر گفتگویی نشان داده میشود. برای دسته هدف، به انتشار مدیریتشده روشن است بروید.
- روی ذخیره کلیک کنید.
بارگذاری فایل WAB
برای بارگذاری فایل WAB، این مراحل را دنبال کنید:
- در منوِ سمت راست «کنسول Play»، آزمایش و انتشار > تنظیمات پیشرفته (پیوند مستقیم) را انتخاب کنید.
- در صفحه تنظیمات پیشرفته، روی برگه ضریبهای شکل کلیک کنید.
- در برگه ضریبهای شکل، روی + افزودن ضریب شکل کلیک کنید و بازیهای Google Play در رایانه را برای افزودن انتخاب کنید.
- در بخش «بازیهای Google Play» در رایانه، روی مدیریت کلیک کنید.
- استفاده از بسته هدف اختصاصی برای بازی بسته برنامه Windows را انتخاب کنید.
- روی ذخیره کلیک کنید.
- در منوِ سمت راست «کنسول Play»، آزمایش و انتشار > نسخه نهایی (پیوند مستقیم) را انتخاب کنید.
- در صفحه نسخه نهایی، فقط «بازیهای Google Play در رایانه» (Windows) را از منوِ کرکرهای ضریب شکل انتخاب کنید.
- در زبانه بسته برنامه Windows، روی ویرایش کلیک کنید و فایل WAB را بارگذاری کنید.
پیکربندی الزامات رایانه Windows
برای پیکربندی الزامات رایانه Windows:
- در منوِ سمت راست «کنسول Play»، رشد دادن تعداد کاربران > حضور در فروشگاه > تنظیمات فروشگاه (پیوند مستقیم) را انتخاب کنید.
- در بخش الزامات رایانه، روی دکمه ویرایش در سمت راست کلیک کنید.
- فیلدها را بهروز کنید و روی ذخیره کلیک کنید.
پیکربندی گرافیک خرید درونبرنامه
این مرحله اختیاری است. برای پیکربندی گرافیک خرید درونبرنامه:
- در منوِ سمت راست «کنسول Play»، رشد دادن تعداد کاربران > حضور در فروشگاه > فهرستگانهای فروشگاه (پیوند مستقیم) را انتخاب کنید.
- در بخش فهرستگان پیشفرض فروشگاه در برگه فهرستگانها، روی دکمه -> (پیکان) در سمت چپ کلیک کنید. با این کار به صفحه فهرستگان پیشفرض فروشگاه هدایت میشوید.
- به بخش «بازیهای Google Play» در رایانه بروید و تصویر را در تصویر خرید درونبرنامه در «بازیهای Google Play» در رایانه (Windows) بارگذاری کنید.
- روی ذخیره کلیک کنید.
ارسال تغییرات برای مرور
- در منوِ سمت راست «کنسول Play»، نمای کلی انتشار را انتخاب کنید.
- در بخش تغییرات هنوز برای بازبینی ارسال نشده است، روی ارسال تغییرات برای بازبینی کلیک کنید.
وقتی تیم «بازبینی» تغییراتتان را تأیید کرد، بازیتان در Google Play قابلکشف خواهد بود.