Publikowanie instalatora

Z tego dokumentu dowiesz się, jak opublikować grę w Grach Google Play na PC za pomocą instalatora gry.

W przypadku procesu instalacji przez dewelopera instalator gry, który udostępniasz, musi zarządzać instalacją, aktualizacją i odinstalowywaniem gry.

Zanim zaczniesz

Zintegruj pakiet SDK do gier Google Play ze swoją grą.

Pakowanie gry jako pliku WAB

Gry Google Play na PC wymagają przesłania instalatora gry do Konsoli Play jako pliku pakietu aplikacji na Windows (WAB). Aby utworzyć plik WAB:

  1. Pobierz narzędzie do publikowania w Google Play. To narzędzie możesz uruchomić w wierszu poleceń systemu Windows lub w powłoce PowerShell.

  2. Utwórz plik konfiguracji publikowania w Google Play o dowolnej nazwie. Na przykładplay_publishing_config.xml w tym formacie:

    <?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>

    Zastąp te elementy:

    • PACKAGE_NAME: Nazwa pakietu gry. Jest to unikalny identyfikator, który będzie powiązany z Twoją grą w Google Play. Na przykład: com.yourcompany.yourgame. Nazwa pakietu musi być zgodna z tymi regułami:
      • Musi zawierać co najmniej 2 segmenty (co najmniej 1 kropkę).
      • Każdy segment musi zaczynać się od litery.
      • Wszystkie znaki muszą być alfanumeryczne lub podkreśleniem ([a-zA-Z0-9_]).

    • VERSION_NAME: ciąg znaków wersji gry. Może to być dowolny ciąg znaków, ale musi być unikalny wśród wszystkich przesłanych plików WAB w przypadku Twojej gry. Przykłady: 1.0, 1.0.1-beta, 2025.11.24, v1.rc1.

      • INSTALLER_REQUIRES_ELEVATION: wskazuje, czy plik wykonywalny instalatora musi być uruchomiony jako administrator, aby zakończyć proces instalacji.

        • „true”: uruchom plik wykonywalny jako administrator.
        • „false”: uruchom plik wykonywalny jako bieżący użytkownik.

      • INSTALLER_PATH: Ścieżka do pliku instalacyjnego w WAB. Ścieżka może być bezwzględna lub względna w stosunku do katalogu nadrzędnego konfiguracji publikowania w Google Play. Na przykład: path\to\test\installer. Pamiętaj, aby używać authenticode i podpisywania kodu do podpisywania pliku wykonywalnego instalatora gry.

      • UNIQUE_REGISTRY_PATH: klucz główny, który będzie zawierać wszystkie informacje o rejestrze. Musi być unikalny na komputerze użytkownika. Będzie to ścieżka względna na HKLM. Na przykład: SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\YourUniqueName. Ten wpis utworzy klucz główny w ścieżce HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName na 64-bitowym komputerze z systemem Windows 11.

      • LAUNCHER_REQUIRES_ELEVATION: wskazuje, czy program uruchamiający lub plik wykonywalny gry musi być uruchamiany jako administrator za każdym razem, gdy jest uruchamiany.

        • „true”: uruchom plik wykonywalny jako administrator.
        • „false”: uruchom plik wykonywalny jako bieżący użytkownik.

      • RELATIVE_PATH_TO_LAUNCHER_EXE: Ścieżka do pliku wykonywalnego programu uruchamiającego lub gry w katalogu instalacyjnym. Musi ona zawierać nazwę pliku wykonywalnego programu uruchamiającego lub gry. Jeśli na przykład plik programu uruchamiającego lub gry ma nazwę mygame.exe i znajduje się w folderze {INSTALL_DIR}\Resources\mygame.exe, musisz wpisać Resources\mygame.exe.

      • LAUNCHER_ARGS_IF_ANY: argumenty wiersza poleceń, które należy przekazać do programu uruchamiającego lub gry. Ten wpis jest opcjonalny.

        • Jeśli z plikiem wykonywalnym jest powiązanych kilka argumentów, należy je oddzielić spacją.
        • Argumenty muszą być poprzedzone znakiem „--” lub „-”, jeśli jest to wymagane przez plik wykonywalny.

      • UNINSTALLER_REQUIRES_ELEVATION: wskazuje, czy plik wykonywalny deinstalatora musi być uruchomiony jako administrator, aby zakończyć proces deinstalacji.

        • „true”: uruchom plik wykonywalny jako administrator.
        • „false”: uruchom plik wykonywalny jako bieżący użytkownik.

    Przykładowy plik konfiguracji publikowania w Google Play

    Rozważmy grę o nazwie MyGame, z instalatorem game_installer.exe i programem uruchamiającym launcher.exe. Przykład pokazuje też, jak używać CDATA. Oto jak będzie wyglądać 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. Uruchom narzędzie do publikowania w Google Play w wierszu poleceń systemu Windows lub w powłoce PowerShell.

    playpublishingtool.exe build-installer-bundle --input=PLAY_PUBLISHING_CONFIG_PATH --output=WAB_OUTPUT_PATH

    Aby zastąpić istniejący plik WAB o tej samej nazwie, użyj argumentu --force.

    playpublishingtool.exe build-installer-bundle --input=PLAY_PUBLISHING_CONFIG_PATH --output=WAB_OUTPUT_PATH --force

    Zastąp te elementy:

    • PLAY_PUBLISHING_CONFIG_PATH: ścieżka do konfiguracji publikowania w Google Play. Na przykład: path\to\play_publishing_config.xml.
    • WAB_OUTPUT_PATH: ścieżka do pliku WAB. Na przykład: path\to\output_bundle.wab.

    Jak korzystać z narzędzia do publikowania w Google Play

    Załóżmy, że w bieżącym katalogu roboczym masz plik binarny narzędzia do publikowania w Google Playplaypublishingtool.exe, konfigurację publikowania w Google Playplay_publishing_config.xml i instalator grygame_installer.exe.

    Aktualny katalog roboczy powinien wyglądać tak:

    .\
├── game_installer.exe
├── play_publishing_config.xml
├── playpublishingtool.exe

    Aby utworzyć WAB o nazwie np. installer_bundle.wab w tym samym katalogu, użyj tego polecenia:

    playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab

    Z argumentem --force polecenie będzie wyglądać tak:

    playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab --force

    Jeśli operacja się powiedzie, zobaczysz dane wyjściowe podobne do tych:

    Successfully built the installer bundle at installer_bundle.wab

    Znajdź plik WAB w folderze:

      .\
  ├── game_installer.exe
  ├── installer_bundle.wab
  ├── play_publishing_config.xml
  ├── playpublishingtool.exe

Publikowanie gry za pomocą Konsoli Play

Po utworzeniu WAB dla gry prześlij go do Konsoli Play i zarządzaj jego ustawieniami oraz wymaganiami. Aby opublikować grę, wykonaj te czynności:

Dodawanie formatu Gier Google Play na PC

Ten krok jest wymagany tylko przy pierwszej publikacji gry.

  1. W menu po lewej stronie w Konsoli Play kliknij Testowanie i publikowanie > Konfiguracja > Ustawienia zaawansowane (link bezpośredni).

  2. Otwórz kartę Formaty i dodaj Google Play Games on PC z menu + Dodaj format.

  3. Po prawej stronie kliknij przycisk Zarządzaj obok formatu Gry Google Play na PC.

  4. Wybierz opcję Użyj dedykowanej ścieżki dla gry z pakietu aplikacji dla systemu Windows.

  5. Kliknij Zapisz, a następnie w oknie z potwierdzeniem ponownie kliknij Zapisz.

Włączanie publikowania zaplanowanego

Aby włączyć publikowanie zarządzane, wykonaj te czynności.

  1. Na stronie Przegląd publikowanych zmian w sekcji Publikowanie zaplanowane kliknij Włącz publikowanie zaplanowane.
  2. Pojawi się okno. Włącz publikowanie zaplanowane na ścieżce.
  3. Kliknij Zapisz.

Przesyłanie pliku WAB

Aby przesłać plik WAB, wykonaj te czynności:

  1. W menu po lewej stronie w Konsoli Play kliknij Testowanie i wdrażanie > Ustawienia zaawansowane (link bezpośredni).
  2. Na stronie Ustawienia zaawansowane kliknij kartę Formaty.
  3. Na karcie Formaty kliknij + Dodaj format i wybierz Gry Google Play na PC, aby dodać ten format.
  4. W sekcji Gry Google Play na PC kliknij Zarządzaj.
  5. Kliknij Użyj dedykowanej ścieżki dla gry z pakietu aplikacji dla systemu Windows.
  6. Kliknij Zapisz.
  7. W menu po lewej stronie w Konsoli Play kliknij Testowanie i wdrażanie > Produkcyjna (link bezpośredni).
  8. Na stronie Wersja produkcyjna w menu formatu wybierz Tylko Gry Google Play na PC (Windows).
  9. Na karcie Pakiet aplikacji na Windowsa kliknij Edytuj i prześlij plik WAB.

Konfigurowanie wymagań dotyczących komputera z systemem Windows

Aby skonfigurować wymagania dotyczące komputera z systemem Windows:

  1. W menu po lewej stronie w Konsoli Play wybierz Zwiększaj liczbę użytkowników > Obecność w sklepie > Ustawienia sklepu (link bezpośredni).
  2. W sekcji Wymagania dotyczące komputera kliknij przycisk Edytuj po prawej stronie.
  3. Zaktualizuj pola i kliknij Zapisz.

Konfigurowanie grafiki zakupu w aplikacji

Ten krok jest opcjonalny. Aby skonfigurować grafikę zakupu w aplikacji:

  1. W menu po lewej stronie w Konsoli Play wybierz Zwiększanie liczby użytkowników > Obecność w sklepie > Informacje o aplikacji(link bezpośredni).
  2. W sekcji Domyślne informacje o aplikacji na karcie Informacje kliknij przycisk -> (strzałka) po prawej stronie. Spowoduje to otwarcie strony Domyślne informacje o aplikacji.
  3. Przejdź do sekcji Gry Google Play na PC i prześlij obraz w sekcji Grafika zakupu w aplikacji w Grach Google Play na PC (Windows).
  4. Kliknij Zapisz.

Wyślij zmiany do sprawdzenia

  1. W menu po lewej stronie w Konsoli Play kliknij Przegląd publikowanych zmian.
  2. W sekcji Zmiany jeszcze niewysłane do sprawdzenia kliknij Wyślij zmiany do sprawdzenia.

Gdy zespół ds. weryfikacji zatwierdzi Twoje zmiany, gra będzie widoczna w Google Play.