Опубликуйте свою игру

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

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

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

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

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

  1. Загрузите инструмент публикации Play . Вы можете запустить его из командной строки Windows или 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 : Имя пакета вашей игры. Например, com.yourcompany.yourgame .
    • VERSION_NAME : Строка версии игры. Например, 1.0.0 .
    • INSTALLER_REQUIRES_ELEVATION : Указывает, нужно ли запускать исполняемый файл установщика от имени администратора для завершения процесса установки.

      • "true" : запустить исполняемый файл от имени администратора.

      • "false" : запустить исполняемый файл от имени текущего пользователя.

    • INSTALLER_PATH : Путь к файлу установщика в WAB-файле. Этот путь может быть как абсолютным , так и относительным к родительскому каталогу конфигурации публикации Play. Например, path\to\test\installer . Не забудьте использовать authenticode и code signing для подписи исполняемого файла установщика вашей игры.

    • 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_ESCALATION : Указывает, нужно ли запускать лаунчер или исполняемый файл игры от имени администратора каждый раз при запуске.

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

    Предположим, у вас есть двоичный файл инструмента публикации 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(Windows) из раскрывающегося списка + Добавить форм-фактор .

  3. Нажмите кнопку «Управление» , соответствующую форм-фактору Google Play Игры на ПК с правой стороны.

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

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

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

Чтобы загрузить WAB-файл:

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

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

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

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

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

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

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

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

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

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