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:
Pobierz narzędzie do publikowania w Google Play. Możesz uruchomić to narzędzie w wierszu poleceń systemu Windows lub w PowerShell.
Utwórz plik konfiguracji publikowania w Google Play o dowolnej nazwie. Na przykład
play_publishing_config.xmlw 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 jakHKEY_LOCAL_MACHINElubHKEY_CURRENT_USER. Nie uwzględniaj nazwy gałęzi w ciągu ścieżki. Jeśli na przykład instalator zapisuje dane wHKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName, podaj tylkoSoftware\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName. Gry Google Play na PC wyszukują tę ścieżkę najpierw wHKEY_LOCAL_MACHINE, a potem wHKEY_CURRENT_USER, używając pierwszej znalezionej pasującej wartości.Plik wykonywalny określony w
Ta ścieżka musi być unikalna na komputerze użytkownika. Na przykład:INSTALLER_PATHmusi utworzyć te klucze rejestru. Przed zakończeniem instalacji należy utworzyć te pary kluczy rejestru i nazw wartości określone winstallation-path-registry-location,launch-path-registry-locationiuninstall-path-registry-location. Chociaż w przykładzie użyto wartościInstallLocationiUninstallString, 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 przezlaunch-path-registry-locationmusi wskazywać katalog programu uruchamiającego (natomiastinstallation-path-registry-locationmusi wskazywać unikalny klucz rejestru gry, a nie klucz rejestru programu uruchamiającego).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 doHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueNamejest przekierowywany doHKEY_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ę
MyGamez instalatoremgame_installer.exei programem uruchamiającymlauncher.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>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 Playplay_publishing_config.xmli instalator grygame_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.wabw 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
--forcepolecenie 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
Włącz autoodtwarzanie w konfiguracji publikowania w Google Play
Aby włączyć tę funkcję, dodaj atrybut
acceptsCommandLineArgumentsdo elementu<installer>w plikuplay_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.
- Atrybut:
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ę.
- Format argumentu:
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.
- 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
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.
- W menu po lewej stronie w Konsoli Play kliknij Testowanie i publikowanie > Konfiguracja > Ustawienia zaawansowane (link bezpośredni).
Otwórz kartę Formaty i dodaj
Google Play Games on PCz menu + Dodaj format.Po prawej stronie kliknij przycisk Zarządzaj odpowiadający formatowi Gry Google Play na PC.
Wybierz opcję Użyj dedykowanej ścieżki dla gry z pakietu aplikacji dla systemu Windows.
Kliknij Zapisz, a następnie ponownie kliknij Zapisz w oknie potwierdzenia.
Włączanie publikowania zaplanowanego
Aby włączyć publikowanie zaplanowane, wykonaj te czynności.
- Na stronie Przegląd publikowanych zmian w sekcji Publikowanie zaplanowane kliknij Włącz publikowanie zaplanowane.
- Pojawi się okno dialogowe. Włącz publikowanie zaplanowane na ścieżce.
- Kliknij Zapisz.
Przesyłanie pliku WAB
Aby przesłać plik WAB, wykonaj te czynności:
- W menu po lewej stronie w Konsoli Play wybierz Testuj i publikuj > Ustawienia zaawansowane (link bezpośredni).
- Na stronie Ustawienia zaawansowane kliknij kartę Formaty.
- Na karcie Formaty kliknij + Dodaj format i wybierz Gry Google Play na PC.
- W sekcji Gry Google Play na PC kliknij Zarządzaj.
- Wybierz Użyj dedykowanej ścieżki dla gry z pakietu aplikacji dla systemu Windows.
- Kliknij Zapisz.
- W Konsoli Play w menu po lewej stronie wybierz Testuj i publikuj > Produkcyjna (link bezpośredni).
- Na stronie Produkcyjna w menu formatów wybierz Tylko Gry Google Play na PC (Windows).
- 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:
- W Konsoli Play w menu po lewej stronie wybierz Zwiększaj liczbę użytkowników > Obecność w sklepie > Ustawienia sklepu (link bezpośredni).
- W sekcji Wymagania dotyczące komputera kliknij przycisk Edytuj po prawej stronie.
- Zaktualizuj pola i kliknij Zapisz.
Konfigurowanie grafiki zakupu w aplikacji
Ten krok jest opcjonalny. Aby skonfigurować grafikę zakupu w aplikacji:
- W Konsoli Play w menu po lewej stronie wybierz Zwiększaj liczbę użytkowników > Obecność w sklepie > Informacje o aplikacji (link bezpośredni).
- 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.
- 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).
- Kliknij Zapisz.
Wyślij zmiany do sprawdzenia
- W Konsoli Play w menu po lewej stronie kliknij Przegląd publikowanych zmian.
- 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.