В этом документе рассказывается, как опубликовать игру в Google Play Играх на компьютере с помощью установщика.
Если вы выбрали этот вариант, то установщик игры должен управлять ее установкой, обновлением и удалением.
Подготовка
Интегрируйте Google Play Games SDK в свою игру.
Упакуйте игру в файл WAB
Чтобы игра была доступна в Google Play Играх на компьютере, загрузите ее установщик в Google Play Console в виде файла Windows App Bundle (WAB). Чтобы создать файл WAB, выполните следующие действия:
Скачайте инструмент для публикации в Google Play. Его можно запустить в командной строке Windows или PowerShell.
Создайте файл конфигурации публикации в Google 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 – запускать исполняемый файл от имени администратора.
- false – запустить исполняемый файл от имени текущего пользователя.
ACCEPTS_COMMAND_LINE_ARGUMENTS– логическое значение, указывающее, может ли установщик принимать аргументы командной строки для включения функции автозапуска. Это необязательный параметр, значение по умолчанию – false. Подробнее о включении автовоспроизведения…INSTALLER_PATH– путь к файлу установщика в WAB. Путь может быть абсолютным или относительным по отношению к родительскому каталогу конфигурации публикации в Google 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.Если установщик игры – это 32-разрядное приложение, запущенное в 64-разрядной версии 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 – запускать исполняемый файл от имени администратора.
- 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 – запустить исполняемый файл от имени текущего пользователя.
Пример файла конфигурации для публикации в Google 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>Запустите инструмент публикации в Google 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– путь к конфигурации публикации в Google Play. напримерpath\to\play_publishing_config.xml.WAB_OUTPUT_PATH– путь к файлу WAB. напримерpath\to\output_bundle.wab.
Как использовать инструмент публикации в Google Play
Предположим, что в текущем рабочем каталоге у вас есть двоичный файл инструмента публикации Google Play
playpublishingtool.exe, файл конфигурации публикации Google 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 Games на компьютере.
Принцип работы
Если вы включите эту функцию, Google Play Игры на компьютере будут передавать токен сеанса в сторонний установщик с помощью аргументов командной строки. Установщик должен извлечь этот токен и использовать его для запуска исполняемого файла игры в контексте аутентификации.
Требования
Чтобы использовать эту функцию, сторонний установщик должен поддерживать аргументы командной строки.
Руководство по настройке
Включите автовоспроизведение в конфигурации публикации в Google 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>
Что нужно сделать
- Извлечение. Установщик должен проанализировать аргументы командной строки, чтобы получить строку токена.
- Передача. Если в процессе установки запускается дополнительный лаунчер или игровой процесс, установщик должен безопасно передать токен сеанса конечному игровому процессу, который использует SDK.
- Запуск. Используйте предоставленный токен сеанса, чтобы запустить исполняемый файл игры. Это гарантирует, что игра запускается в аутентифицированном контексте Google Play Игр. В противном случае метод InitializeSDK не сработает и игроку придется перезапустить игру.
- Формат аргумента:
Обработка ошибок и резервные варианты
- Получение токена. Если по какой-либо причине GPG не может сгенерировать или передать токен сеанса (например, из-за ошибки генерации токена), процесс установки все равно продолжится. Однако установщик будет запущен без аргумента
--g_session_token. - Надежность. Установщик должен быть разработан так, чтобы обрабатывать сценарии, в которых токен сеанса отсутствует. В таких случаях установщик должен выполнить стандартную установку. Не запускайте игру автоматически, так как InitializeSDK все равно не сработает.
- Ошибки установщика. Вы несете ответственность за надежность и обработку ошибок установщика и запускаемой им последовательности запуска игры. Google Play Игры не контролируют процессы, которые происходят в установщике после его запуска.
- Получение токена. Если по какой-либо причине GPG не может сгенерировать или передать токен сеанса (например, из-за ошибки генерации токена), процесс установки все равно продолжится. Однако установщик будет запущен без аргумента
Опубликуйте игру в Play Console.
После того как вы создадите WAB-файл для игры, загрузите его в Play Console и настройте параметры и требования. Чтобы опубликовать игру, выполните следующие действия:
Как добавить тип устройств "Google Play Игры на компьютере"
Этот шаг требуется только при первой публикации игры.
- В Play Console в меню слева выберите Тестирование и выпуск > Настройка > Расширенные настройки (прямая ссылка).
Перейдите на вкладку Типы устройств и в раскрывающемся меню Добавить тип устройства выберите
Google Play Games on PC.Справа нажмите кнопку Настроить рядом с типом устройств Google Play Игры на компьютере.
Выберите Использовать отдельный тип версии игры с набором Windows App Bundle.
Нажмите Сохранить, а затем ещё раз Сохранить в диалоговом окне подтверждения.
Как включить управляемую публикацию
Чтобы включить управляемую публикацию, выполните следующие действия:
- На странице Обзор публикации в разделе Управляемая публикация нажмите Включить управляемую публикацию.
- Появится диалоговое окно. Установите переключатель в положение Управляемая публикация включена.
- Нажмите Сохранить.
Загрузите файл WAB
Чтобы загрузить файл WAB, выполните следующие действия:
- В Play Console в меню слева выберите Тестирование и выпуск > Расширенные настройки (прямая ссылка).
- На странице Расширенные настройки откройте вкладку Типы устройств.
- На вкладке Типы устройств нажмите Добавить тип устройства и выберите Google Play Игры на компьютере.
- В разделе Google Play Игры на компьютере нажмите Настроить.
- Выберите Использовать отдельный тип версии игры с набором Windows App Bundle.
- Нажмите Сохранить.
- В Play Console в меню слева выберите Тестирование и выпуск > Рабочая версия (прямая ссылка).
- На странице Рабочая версия в раскрывающемся списке с типами устройств выберите Только для Google Play Games на компьютере (Windows).
- На вкладке Набор Windows App Bundle нажмите Изменить и загрузите файл WAB.
Как настроить требования к ПК с Windows
Чтобы настроить требования к ПК с Windows:
- В Play Console в меню слева выберите Привлечение пользователей > Страница приложения > Настройки для Google Play (прямая ссылка).
- В разделе Требования к ПК нажмите кнопку Изменить справа.
- Измените данные в полях и нажмите Сохранить.
Как настроить изображение для покупки в приложении
Это необязательный шаг. Чтобы настроить изображение для покупки в приложении, выполните следующие действия:
- В Play Console в меню слева выберите Привлечение пользователей > Страница приложения > Страницы приложения (прямая ссылка).
- В разделе Основная страница приложения на вкладке Страницы приложения нажмите кнопку со стрелкой -> справа. Откроется страница Основная страница приложения в Google Play.
- Перейдите в раздел Google Play Игры на компьютере и загрузите изображение в поле Фоновое изображение при покупке в приложении из Google Play Игр на компьютере с Windows.
- Нажмите Сохранить.
Отправка изменений на проверку
- В Play Console в меню слева выберите Обзор публикации.
- В разделе Изменения, ещё не отправленные на рассмотрение нажмите Отправить на проверку.
После того как команда проверки одобрит изменения, ваша игра станет доступна в Google Play.