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 z grą pakiet SDK Gier Google Play.

Pakowanie gry jako pliku WAB

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

  1. Pobierz narzędzie do publikowania w Google Play. Możesz uruchomić to narzędzie w wierszu poleceń systemu Windows lub w PowerShell.

  2. Utwórz plik konfiguracji publikowania w Google Play o dowolnej nazwie. Na przykład play_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 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>

    Zastąp następujące 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 być 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 we wszystkich przesłanych plikach WAB w grze. Na przykład: 1.0, 1.0.1-beta, 2025.11.24, v1.rc1.

      • INSTALLER_REQUIRES_ELEVATION: wskazuje, czy plik wykonywalny instalatora musi zostać uruchomiony jako administrator, aby można było ukończyć proces instalacji.

        • "true": uruchom plik wykonywalny jako administrator.
        • "false": uruchom plik wykonywalny jako bieżący użytkownik.
      • ACCEPTS_COMMAND_LINE_ARGUMENTS: wartość logiczna wskazująca, czy instalator może akceptować argumenty wiersza poleceń, aby włączyć funkcję autoodtwarzania. Jest to opcjonalne, a wartość domyślna to false. Więcej informacji znajdziesz w artykule o włączaniu autoodtwarzania.

      • INSTALLER_PATH: ścieżka do pliku instalatora w pakiecie WAB. Ta ś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.

      • <installation-path-registry-location>: ścieżka rejestru, której Gry Google Play używają do wykrywania, czy gra jest zainstalowana. Nawet jeśli gra korzysta z niestandardowego programu uruchamiającego, ta ścieżka musi wskazywać unikalny klucz rejestru gry, a nie klucz rejestru programu uruchamiającego.

      • UNIQUE_REGISTRY_PATH: ścieżka klucza rejestru systemu Windows. Ta ścieżka musi być podana względem gałęzi rejestru, takiej jak HKEY_LOCAL_MACHINE lub HKEY_CURRENT_USER. Nie uwzględniaj nazwy gałęzi w ciągu ścieżki. Jeśli na przykład instalator zapisuje dane w HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName, podaj tylko Software\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName. Gry Google Play na PC wyszukują tę ścieżkę najpierw w HKEY_LOCAL_MACHINE, a potem w HKEY_CURRENT_USER, używając pierwszej znalezionej pasującej wartości.

        Plik wykonywalny określony w INSTALLER_PATH musi utworzyć te klucze rejestru. Przed zakończeniem instalacji należy utworzyć te pary kluczy rejestru i nazw wartości określone w installation-path-registry-location, launch-path-registry-location i uninstall-path-registry-location. Chociaż w przykładzie użyto wartości InstallLocation i UninstallString, w tagach <value-name> możesz podać dowolną nazwę, o ile instalator utworzy odpowiednie wpisy rejestru dla wszystkich 3 tagów. Gry Google Play na PC używają tych wartości do uruchamiania i odinstalowywania gry. Jeśli gra używa programu uruchamiającego, wartość we wpisie rejestru określonym przez launch-path-registry-location musi wskazywać katalog programu uruchamiającego (natomiast installation-path-registry-location musi wskazywać unikalny klucz rejestru gry, a nie klucz rejestru programu uruchamiającego).

        Ta ścieżka musi być unikalna na komputerze użytkownika. Na przykład: SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName.

        Jeśli instalator gry jest 32-bitową aplikacją działającą w 64-bitowym systemie Windows, system Windows używa przekierowania rejestru do zapisywania wpisów rejestru w HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node. Na przykład zapis do HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName jest przekierowywany do HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName.

      • 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 programu uruchamiającego lub pliku wykonywalnego gry w katalogu instalacyjnym. Musi on zawierać nazwę pliku wykonywalnego programu uruchamiającego lub gry. Jeśli na przykład plik programu uruchamiającego lub gry nazywa się mojagra.exe i znajduje się w folderze {INSTALL_DIR}\Resources\mojagra.exe, musisz wpisać Resources\mojagra.exe.

      • LAUNCHER_ARGS_IF_ANY: argumenty wiersza poleceń, które muszą zostać przekazane do programu uruchamiającego lub gry. Ten wpis jest opcjonalny.

        • Jeśli z plikiem wykonywalnym jest powiązanych kilka argumentów, należy je rozdzielić spacją.
        • Argumenty muszą być poprzedzone znakami „--” lub „-”, jeśli jest to wymagane przez plik wykonywalny.
      • UNINSTALLER_REQUIRES_ELEVATION: wskazuje, czy plik wykonywalny deinstalatora musi zostać uruchomiony jako administrator, aby można było ukończyć proces odinstalowywania.

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

    Przykładowy plik konfiguracji publikowania w Google Play

    Weźmy na przykład grę MyGame z instalatorem game_installer.exe i programem uruchamiającym launcher.exe. Przykład pokazuje też, jak używać CDATA. Tak będzie wyglądać 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. Uruchom narzędzie do publikowania w Google Play w wierszu poleceń systemu Windows lub w 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 następujące 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 Play playpublishingtool.exe, plik konfiguracji publikowania w Google Play play_publishing_config.xml i instalator gry game_installer.exe.

    Bieżący katalog roboczy powinien wyglądać tak:

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

    Aby utworzyć pakiet WAB o nazwie, powiedzmy, installer_bundle.wab w tym samym katalogu, polecenie będzie wyglądać tak:

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

    Z argumentem --force polecenie wyglądałoby tak:

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

    Jeśli wszystko przebiegnie pomyślnie, powinny pojawić się 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
    

    Włączanie autoodtwarzania po zainstalowaniu gier na PC (opcjonalnie)

    Gry Google Play na PC umożliwiają włączenie funkcji „autoodtwarzania”, która automatycznie uruchamia grę natychmiast po zakończeniu procesu instalacji. Ta funkcja zapewnia płynne działanie, ponieważ gracz przechodzi bezpośrednio do gry i jest w pełni uwierzytelniony w ekosystemie Gier Google Play na PC.

    Jak to działa

    Gdy włączysz tę funkcję, Gry Google Play na PC będą przekazywać token sesji do procesu instalatora innej firmy za pomocą argumentów wiersza poleceń. Instalator jest odpowiedzialny za wyodrębnienie tego tokena i użycie go do uruchomienia pliku wykonywalnego gry w kontekście uwierzytelniania.

    Wymagania wstępne

    Aby korzystać z tej funkcji, instalator innej firmy musi obsługiwać argumenty wiersza poleceń.

    Etapy wdrażania

    1. Włącz autoodtwarzanie w konfiguracji publikowania w Google Play

      Aby włączyć tę funkcję, dodaj atrybut acceptsCommandLineArguments do elementu <installer> w pliku play_publishing_config.xml.

      Przykład fragmentu treści 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>
      • Atrybut: acceptsCommandLineArguments
      • Typ: Boolean
      • Domyślny: false
      • Zachowanie: jeśli ustawisz wartość „true”, GPG dołączy token sesji do argumentów wiersza poleceń podczas uruchamiania instalatora.
    2. Obsługa tokena sesji w instalatorze

      Gdy instalator zostanie uruchomiony przez klienta Gier Google Play, otrzyma token sesji jako argument wiersza poleceń.

      • Format argumentu: --g_session_token=<TOKEN>

      Co musisz zrobić:

      • Wyodrębnianie: instalator musi przeanalizować argumenty wiersza poleceń, aby pobrać ciąg tokena.
      • Przekazywanie: jeśli proces instalacji obejmuje uruchomienie dodatkowego programu uruchamiającego lub procesu gry, instalator jest odpowiedzialny za bezpieczne przekazanie tokena sesji do ostatecznego procesu gry, który korzysta z pakietu SDK.
      • Uruchomienie: użyj podanego tokena sesji, aby uruchomić plik wykonywalny gry. Dzięki temu gra będzie działać w uwierzytelnionym kontekście Gier Play. W przeciwnej sytuacji metoda InitializeSDK zakończy się niepowodzeniem, a gracz będzie musiał ponownie uruchomić grę.
    3. Obsługa błędów i kreacje zastępcze

      • Pobieranie tokena: jeśli z jakiegoś powodu GPG nie może wygenerować ani przekazać tokena sesji (np. z powodu błędu generowania tokena), proces instalacji będzie kontynuowany. Instalator zostanie jednak uruchomiony bez argumentu --g_session_token.
      • Niezawodność: instalator powinien być zaprojektowany tak, aby obsługiwać scenariusze, w których token sesji jest nieobecny. W takich przypadkach instalator powinien kontynuować standardową instalację. Nie należy uruchamiać gry automatycznie, ponieważ funkcja InitializeSDK i tak nie zadziała.
      • Błędy instalatora: ponosisz odpowiedzialność za stabilność i obsługę błędów instalatora oraz uruchamianą przez niego sekwencję uruchamiania gry. GPG nie ma kontroli nad procesami, które zachodzą w instalatorze po jego uruchomieniu.

Opublikuj grę za pomocą Konsoli Play

Po utworzeniu pakietu 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 pierwszym publikowaniu 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 odpowiadający formatowi 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 ponownie kliknij Zapisz w oknie potwierdzenia.

Włączanie publikowania zaplanowanego

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

  1. Na stronie Przegląd publikowanych zmian w sekcji Publikowanie zaplanowane kliknij Włącz publikowanie zaplanowane.
  2. Pojawi się okno dialogowe. 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 wybierz Testuj i publikuj > 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.
  4. W sekcji Gry Google Play na PC kliknij Zarządzaj.
  5. Wybierz Użyj dedykowanej ścieżki dla gry z pakietu aplikacji dla systemu Windows.
  6. Kliknij Zapisz.
  7. W Konsoli Play w menu po lewej stronie wybierz Testuj i publikuj > Produkcyjna (link bezpośredni).
  8. Na stronie Produkcyjna w menu formatów wybierz Tylko Gry Google Play na PC (Windows).
  9. Na karcie Pakiet aplikacji dla systemu Windows 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 Konsoli Play w menu po lewej stronie 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 Konsoli Play w menu po lewej stronie wybierz Zwiększaj liczbę użytkowników > Obecność w sklepie > Informacje o aplikacji (link bezpośredni).
  2. W sekcji Domyślne informacje o aplikacji na karcie Informacje o aplikacji kliknij przycisk -> (strzałka) po prawej stronie. Otworzy się strona 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 Konsoli Play w menu po lewej stronie kliknij Przegląd publikowanych zmian.
  2. W sekcji Zmiany jeszcze niewysłane do sprawdzenia kliknij Wyślij zmiany do sprawdzenia.

Gdy zespół sprawdzający zatwierdzi zmiany, Twoja gra będzie widoczna w Google Play.