Установщик публикации

В этом документе показано, как опубликовать свою игру в Google Play Games на ПК с помощью установщика игры.

При использовании метода "Установка разработчиком" предоставленный вами установщик игры должен управлять установкой, обновлением и удалением игры.

Прежде чем начать

Интегрируйте SDK Google Play Games в свою игру.

Упакуйте свою игру в файл WAB.

Для запуска Google Play Games на ПК необходимо загрузить установщик игры в Google Play Console в виде файла пакета приложения Windows (WAB). Чтобы создать файл WAB, выполните следующие действия:

  1. Загрузите инструмент для публикации в Play Store . Вы можете запустить этот инструмент в командной строке Windows или PowerShell.

  2. Создайте файл конфигурации публикации в Play Store с любым именем. Например, 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 на 64-разрядной машине с Windows 11.

      • 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 Store

    Предположим, что в текущем рабочем каталоге находятся исполняемый файл инструмента публикации 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 на ПК в форм-факторе

Этот шаг необходим только при первой публикации игры.

  1. В меню Play Console слева выберите «Тестирование и выпуск» > «Настройка» > «Расширенные настройки» ( прямая ссылка ).

  2. Перейдите на вкладку «Форм-факторы» и добавьте Google Play Games on PC выбрав соответствующий пункт в выпадающем списке «+ Добавить форм-фактор» .

  3. В правой части экрана нажмите кнопку «Управление» , соответствующую разделу «Игры Google Play на ПК» .

  4. Выберите опцию «Использовать выделенную дорожку для игры в составе пакета приложений Windows» .

  5. Нажмите «Сохранить» , а затем еще раз «Сохранить» в диалоговом окне подтверждения.

Включите управляемую публикацию.

Чтобы включить управляемую публикацию, выполните следующие действия.

  1. На странице «Обзор издательской деятельности» в разделе «Управляемая издательская деятельность» нажмите «Включить управляемую издательскую деятельность» .
  2. Появится диалоговое окно. Включите управляемую публикацию для трека.
  3. Нажмите « Сохранить ».

Загрузите WAB-файл

Для загрузки WAB-файла выполните следующие действия:

  1. В меню Play Console слева выберите «Тестирование и выпуск» > «Расширенные настройки » ( прямая ссылка ).
  2. На странице «Расширенные настройки» перейдите на вкладку «Форм-факторы» .
  3. На вкладке «Форм-факторы» нажмите « + Добавить форм-фактор» и выберите «Google Play Games на ПК» , чтобы добавить игру.
  4. В разделе «Игры Google Play на ПК» нажмите «Управление» .
  5. Выберите « Использовать выделенную дорожку для игры в составе пакета приложений Windows» .
  6. Нажмите « Сохранить ».
  7. В консоли Play Console в левом меню выберите «Тестирование и выпуск» > «Производство» ( прямая ссылка ).
  8. На странице «Производство» выберите в выпадающем списке «Формат устройства » только игры Google Play для ПК (Windows) .
  9. На вкладке «Пакет приложений Windows» нажмите «Редактировать» и загрузите WAB-файл.

Настройте требования к ПК под управлением Windows.

Для настройки требований к ПК под управлением Windows:

  1. В консоли Play в левом меню выберите «Увеличить количество пользователей» > «Присутствие в магазине» > «Настройки магазина» ( прямая ссылка ).
  2. В разделе «Требования к ПК» нажмите кнопку «Редактировать» в правой части экрана.
  3. Обновите поля и нажмите «Сохранить» .

Настройте графическое оформление покупки внутри приложения.

Это необязательный шаг. Чтобы настроить графическое оформление покупки внутри приложения:

  1. В консоли Play в левом меню выберите «Увеличить количество пользователей» > «Присутствие в магазине» > «Списки магазинов » ( прямая ссылка ).
  2. В разделе «Список магазинов по умолчанию» на вкладке «Списки» нажмите кнопку -> (стрелка) справа. Это переведет вас на страницу списка магазинов по умолчанию .
  3. Перейдите в раздел «Игры Google Play на ПК» и загрузите изображение по ссылке «Графика для внутриигровых покупок в Google Play на ПК (Windows)» .
  4. Нажмите « Сохранить ».

Отправить изменения на проверку

  1. В меню левой панели консоли Play выберите «Обзор публикации» .
  2. В разделе «Изменения, еще не отправленные на проверку» нажмите « Отправить изменения на проверку» .

После того, как команда проверки одобрит ваши изменения, ваша игра станет доступна в Google Play.