Публикация установщика

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

Если вы выбрали этот вариант, то установщик игры должен управлять ее установкой, обновлением и удалением.

Подготовка

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

Упакуйте игру в файл WAB

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

  1. Скачайте инструмент для публикации в Google Play. Его можно запустить в командной строке Windows или PowerShell.

  2. Создайте файл конфигурации публикации в 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>
    
  3. Запустите инструмент публикации в 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 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
    

    Как включить автовоспроизведение при установке нативных игр для ПК (необязательно)

    В Google Play Играх на компьютере можно включить функцию автозапуска, которая автоматически запускает игру сразу после завершения установки. Эта функция обеспечивает удобство для пользователей, позволяя им сразу переходить к игре, пройдя аутентификацию в экосистеме Google Play Games на компьютере.

    Принцип работы

    Если вы включите эту функцию, Google Play Игры на компьютере будут передавать токен сеанса в сторонний установщик с помощью аргументов командной строки. Установщик должен извлечь этот токен и использовать его для запуска исполняемого файла игры в контексте аутентификации.

    Требования

    Чтобы использовать эту функцию, сторонний установщик должен поддерживать аргументы командной строки.

    Руководство по настройке

    1. Включите автовоспроизведение в конфигурации публикации в 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 будет добавлять токен сеанса к аргументам командной строки при запуске установщика.
    2. Как обрабатывать токен сеанса в установщике

      Когда клиент Google Play Игр запустит установщик, он получит токен сеанса в качестве аргумента командной строки.

      • Формат аргумента: --g_session_token=<TOKEN>

      Что нужно сделать

      • Извлечение. Установщик должен проанализировать аргументы командной строки, чтобы получить строку токена.
      • Передача. Если в процессе установки запускается дополнительный лаунчер или игровой процесс, установщик должен безопасно передать токен сеанса конечному игровому процессу, который использует SDK.
      • Запуск. Используйте предоставленный токен сеанса, чтобы запустить исполняемый файл игры. Это гарантирует, что игра запускается в аутентифицированном контексте Google Play Игр. В противном случае метод InitializeSDK не сработает и игроку придется перезапустить игру.
    3. Обработка ошибок и резервные варианты

      • Получение токена. Если по какой-либо причине GPG не может сгенерировать или передать токен сеанса (например, из-за ошибки генерации токена), процесс установки все равно продолжится. Однако установщик будет запущен без аргумента --g_session_token.
      • Надежность. Установщик должен быть разработан так, чтобы обрабатывать сценарии, в которых токен сеанса отсутствует. В таких случаях установщик должен выполнить стандартную установку. Не запускайте игру автоматически, так как InitializeSDK все равно не сработает.
      • Ошибки установщика. Вы несете ответственность за надежность и обработку ошибок установщика и запускаемой им последовательности запуска игры. Google Play Игры не контролируют процессы, которые происходят в установщике после его запуска.

Опубликуйте игру в Play Console.

После того как вы создадите WAB-файл для игры, загрузите его в Play Console и настройте параметры и требования. Чтобы опубликовать игру, выполните следующие действия:

Как добавить тип устройств "Google Play Игры на компьютере"

Этот шаг требуется только при первой публикации игры.

  1. В Play Console в меню слева выберите Тестирование и выпуск > Настройка > Расширенные настройки (прямая ссылка).
  2. Перейдите на вкладку Типы устройств и в раскрывающемся меню Добавить тип устройства выберите Google Play Games on PC.

  3. Справа нажмите кнопку Настроить рядом с типом устройств Google Play Игры на компьютере.

  4. Выберите Использовать отдельный тип версии игры с набором Windows App Bundle.

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

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

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

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

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

Чтобы загрузить файл WAB, выполните следующие действия:

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

Как настроить требования к ПК с Windows

Чтобы настроить требования к ПК с Windows:

  1. В Play Console в меню слева выберите Привлечение пользователей > Страница приложения > Настройки для Google Play (прямая ссылка).
  2. В разделе Требования к ПК нажмите кнопку Изменить справа.
  3. Измените данные в полях и нажмите Сохранить.

Как настроить изображение для покупки в приложении

Это необязательный шаг. Чтобы настроить изображение для покупки в приложении, выполните следующие действия:

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

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

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

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