Lista kontrolna uruchomienia

Zanim prześlesz grę do sprawdzenia w Grach Google Play na PC, skorzystaj z tej listy kontrolnej, aby upewnić się, że spełnia ona wszystkie wymagania i jest zgodna ze sprawdzonymi metodami.

Konfigurowanie projektu

  • Pobierz i zaimportuj pakiet SDK: zintegruj najnowszy pakiet SDK Gier Play na PC ze swoim środowiskiem. Więcej informacji znajdziesz w przewodniku po Unity lub przewodniku po C++.
  • Utwórz plik manifestu aplikacji: utwórz plik manifest.xml mapujący <PackageName> na pakiet w Konsoli Play, do którego masz prawa. Więcej informacji znajdziesz w przewodniku po pliku manifestu.
  • Podpisz cyfrowo plik wykonywalny: podpisz grę za pomocą podpisu cyfrowego Authenticode i zabezpiecz certyfikat na potrzeby wszystkich przyszłych aktualizacji. Chociaż możesz pominąć ten krok podczas lokalnego programowania, włączając tryb programisty, musisz podpisać ostateczny plik binarny rzeczywistym certyfikatem produkcyjnym od znanego urzędu certyfikacji. Więcej informacji znajdziesz w artykule Podpisywanie cyfrowe gry.
  • Sformatuj i wyślij certyfikat: wyślij informacje o certyfikacie do przedstawiciela Google. Plik certyfikatu powinien zawierać tylko informacje związane z certyfikatem. Sprawdź, czy wszystkie bloki niezwiązane z certyfikatem zostały usunięte. Możesz użyć OpenSSL, aby przekonwertować pliki DER/CER na wymagany format PEM.

Integracja interfejsów API i funkcji

  • Zainicjuj pakiet SDK: zaimplementuj logikę inicjowania pakietu SDK, np. InitializeAsync, podczas uruchamiania, zanim użyjesz innych funkcji. Więcej informacji znajdziesz w przewodniku po inicjowaniu.
  • Wdrażanie łatwego logowania: automatycznie uwierzytelniaj graczy za pomocą konta klienta Gier Play przy użyciu interfejsu Recall API. Więcej informacji znajdziesz w przewodniku po płynnym logowaniu.
  • Zintegruj Play Integrity: użyj IntegrityClient, aby prosić o tokeny i weryfikować autentyczność sesji gry w backendzie. Więcej informacji znajdziesz w przewodniku po Play Integrity.
  • Dodaj Play Install Referrer: zintegruj interfejs Install Referrer API, jeśli chcesz śledzić źródła pozyskiwania użytkowników na PC. Więcej informacji znajdziesz w przewodniku po Install Referrer.
  • Obsługa błędów inicjowania: aby użyć pakietu SDK, wywołaj GooglePlayInitialize (C++) lub GooglePlayInitialization.InitializeAsync (C#) w celu zainicjowania interfejsu API. Zanim będzie można użyć innego interfejsu API, musisz wywołać tę funkcję i sprawdzić, czy wywołanie zwrotne kontynuacji kończy się wartością InitializeResult::ok() (C++) lub Result.IsOk (C#) zwraca true.
  • Obsługa obowiązkowego wyłączenia: obsłuż kActionRequiredShutdownClientProcess, wyłączając proces klienta tak szybko, jak to możliwe.
  • Obsługa wymagań dotyczących instalacji Gier Google Play: obsłuż błąd kSdkRuntimeUnavailable, informując użytkowników, że aby kontynuować, muszą zainstalować Gry Google Play i środowisko wykonawcze SDK.
  • Obsługa aktualizacji Gier Google Play: obsłuż kSdkRuntimeUpdateRequired, powiadamiając użytkowników, że wymagana jest aktualizacja środowiska wykonawczego Gier Google Play.

Wdrażanie Płatności w Play

  • Sprawdź typy zakupów: upewnij się, że Twoja gra korzysta tylko z zakupów w aplikacji, ponieważ płatności cykliczne i subskrypcje nie są obsługiwane. Więcej informacji znajdziesz w najczęstszych pytaniach dotyczących płatności.
  • Zapytanie o szczegóły produktu: użyj QueryProductDetails, aby pobrać zlokalizowane dane sklepu. Jeśli masz więcej niż 50 produktów, podziel żądanie na kilka wywołań. Więcej informacji znajdziesz w przewodniku po zapytaniach o produkty.
  • Uruchom proces zakupu: użyj LaunchPurchaseFlow, aby przetwarzać transakcje natywnie. Jeśli zamkniesz przeglądarkę płatności bez dokonania płatności, po 5 minutach wystąpi błąd przekroczenia limitu czasu. Więcej informacji znajdziesz w przewodniku po procesie zakupu.
  • Przywracanie dotychczasowych zakupów: wywołaj QueryPurchases podczas uruchamiania i przenoszenia na pierwszy plan, aby wykryć niepotwierdzone zakupy na różnych urządzeniach. Więcej informacji znajdziesz w przewodniku po przywracaniu zakupów.
  • Bezpieczne przetwarzanie w backendzie: przed przyznaniem uprawnień i sfinalizowaniem transakcji za pomocą metody AcknowledgePurchase lub ConsumePurchase sprawdź purchaseToken w backendzie. Więcej informacji znajdziesz w przewodniku po bezpiecznym przetwarzaniu.
  • Uwzględnij opóźnienie propagacji klucza licencyjnego: podczas konfigurowania nowych kluczy rozliczeniowych lub licencyjnych w Konsoli Play poczekaj kilka godzin, aż pamięć podręczna backendu zsynchronizuje się w środowiskach obsługi transakcji, zanim przeprowadzisz testy zakupów na żywo. Próby dokonania zakupów przed zakończeniem synchronizacji spowodują zwrócenie kodu błędu 6.

Testowanie w trybie programisty i kontrola jakości przed premierą

  • Testowanie w trybie programisty: dodaj <IsDeveloperMode>true</IsDeveloperMode> do pliku manifestu i skonfiguruj identyfikator GUID partnera w ramach wcześniejszego dostępu na potrzeby testowania w lokalnym zintegrowanym środowisku programistycznym (IDE). Jeśli nie masz identyfikatora GUID partnera z wcześniejszym dostępem, wypełnij formularz zgłoszenia zainteresowania.
  • Zarządzanie zakupami w trybie dewelopera: gdy testujesz zakupy w trybie dewelopera, wykorzystaj zakup w ciągu 3 minut, aby zapobiec automatycznym zwrotom środków. Więcej informacji znajdziesz w najczęstszych pytaniach na temat testowania.
  • Usuń tryb programisty: musisz jak najszybciej usunąć tag <IsDeveloperMode> przed spakowaniem kompilacji do publikacji. Więcej informacji znajdziesz w przewodniku po trybie programisty.
  • Przekazywanie argumentów za pomocą programów uruchamiających innych firm: przekazuj wszystkie nieznane argumenty wiersza poleceń otrzymane przez program uruchamiający z klienta Gier Google Play bezpośrednio do utworzonego procesu gry. Więcej informacji znajdziesz w przewodniku po wielu procesach.
  • Testowanie przy użyciu usługi VPN: jeśli testujesz z nieobsługiwanego regionu, użyj usługi VPN z włączonym trybem TUN, aby uzyskać obsługiwany adres IP. Więcej informacji znajdziesz w najczęstszych pytaniach na temat testowania VPN.
  • Obsługa skrótów na pulpicie: aby uzyskać bezproblemową obsługę skrótów, zapoznaj się z najczęstszymi pytaniami dotyczącymi skrótów. Uruchomienie gry bezpośrednio lub za pomocą programu uruchamiającego innej firmy przy użyciu skrótu może spowodować błędy inicjowania.

Pakowanie, testowanie i publikowanie gry

  • Spakuj WAB: użyj narzędzia Play Publishing Tool, aby spakować grę do pakietu aplikacji dla systemu Windows (WAB). Plik WAB nie może przekraczać limitu rozmiaru 10 GB w przypadku publikowania przez instalator i 200 GB w przypadku publikowania zaplanowanego w Google Play. Więcej informacji znajdziesz w przewodniku po pakowaniu.
  • Używaj najnowszych pakietów SDK i narzędzi: skompiluj i spakuj wersję za pomocą najnowszych wersji pakietu SDK Gier Play na PC, pakietu SDK Gier Play na PC w Unity, narzędzia dla deweloperów Gier Play na PC i narzędzia do publikowania w Google Play.
  • Sprawdź, czy wymagane jest podniesienie uprawnień: jeśli instalator, program uruchamiający lub deinstalator musi być uruchamiany jako administrator za każdym razem, gdy jest uruchamiany, sprawdź, czy ustawiono INSTALLER_REQUIRES_ELEVATION, LAUNCHER_REQUIRES_ELEVATION lub UNINSTALLER_REQUIRES_ELEVATION na true. W przeciwnym razie nie będą działać z uprawnieniami administratora, co spowoduje błąd uruchamiania. Więcej informacji znajdziesz w artykule Format pliku konfiguracji WAB.
  • Prześlij instalatory programów uruchamiających innych firm: jeśli używasz programu uruchamiającego innej firmy, prześlij jego instalator w pakiecie WAB. Więcej informacji znajdziesz w przewodniku dla instalatorów.
  • Obsługa tokena sesji autoodtwarzania: jeśli włączysz autoodtwarzanie, ustawiając acceptsCommandLineArguments="true" w play_publishing_config.xml, sprawdź, czy instalator wyodrębnia argument wiersza poleceń --g_session_token=<token> i używa go do uruchamiania gry. Upewnij się, że instalator obsługuje przypadek zastępczy, gdy token nie jest obecny. Więcej informacji znajdziesz w Najczęstszych pytaniach dotyczących programu uruchamiającego.
  • Aktualizowanie gry i programu uruchamiającego lub instalatora: zawartość pakietu, w tym instalatory programów uruchamiających, musi być aktualizowana automatycznie. Zarządzaj wszystkimi zasobami, których potrzebuje gra, w tym aktualizacjami programu uruchamiającego.
  • Udostępnij Google informacje o premierze: skontaktuj się z partnerem Play i podaj mu nazwę pakietu, kraje, w których odbędzie się premiera (użyj 2-literowych kodów ISO, np. PL, US, CA), oraz datę i godzinę premiery według uniwersalnego czasu koordynowanego (UTC).
  • Skonfiguruj dostęp do testowania: podaj zewnętrzną Grupę dyskusyjną Google, którą chcesz dodać do listy dozwolonych, aby umożliwić jej testowanie, dostęp do dokumentacji i Dysku Google. Udostępnij partnerowi Google Play listę adresów e-mail kont testowych, ponieważ ścieżki testów w Konsoli Play nie są obsługiwane na PC.
  • Dodaj format PC: w Konsoli Google Play wyraźnie dodaj do aplikacji format „Gry Google Play na PC”. Jeśli nie masz dostępu do tej karty, skontaktuj się z partnerem Google Play, aby dodał Twoje konto do listy dozwolonych.
  • Skonfiguruj wymagania dotyczące komputera: wpisz wymagania sprzętowe (RAM, GPU, miejsce na dane) dotyczące komputerów z systemem Windows. Więcej informacji znajdziesz w przewodniku po wymaganiach dotyczących komputera.
  • Prześlij zasoby sklepu: prześlij spakowany plik WAB na ścieżkę produkcyjną i skonfiguruj zasoby wizualne. Więcej informacji znajdziesz w przewodniku po przesyłaniu zasobów.
  • Opublikuj na potrzeby testowania środowiska użytkownika: w Konsoli Google Play kliknij Opublikuj. W przeciwieństwie do wersji na Androida wybranie opcji Opublikuj w WAB nie powoduje publicznego udostępnienia. Zamiast tego umożliwia wyszukiwanie aplikacji na udostępnionych kontach testowych, aby przeprowadzać testy w środowisku użytkownika po zakończeniu procesu sprawdzania przez Google.
  • Oficjalna premiera: Google kontroluje premierę na podstawie oficjalnej daty premiery udostępnionej partnerowi Play.
  • Testowanie przed premierą: Podczas fazy rejestracji przed premierą musisz przeprowadzić testy wewnętrzne w kraju, który nie jest uwzględniony w wybranych regionach rejestracji przed premierą.
  • Sprawdź zakończenie procesu instalatora: upewnij się, że główny proces instalatora pozostaje aktywny do momentu utworzenia i zarejestrowania wszystkich wymaganych kluczy rejestru. Jeśli proces zakończy się przedwcześnie, weryfikacja instalacji się nie powiedzie. Więcej informacji znajdziesz w artykule Publikowanie instalatora.
  • Zachowaj spójne gałęzie rejestru i wyczyść je po odinstalowaniu: Gry Google Play na PC sprawdzają HKEY_LOCAL_MACHINE przed HKEY_CURRENT_USER i używają pierwszej pasującej wartości. Utrzymuj spójność gałęzi rejestru między aktualizacjami i tytułami udostępnianymi przez program uruchamiający oraz usuwaj klucze rejestru podczas odinstalowywania, aby nieaktualne wpisy HKEY_LOCAL_MACHINE nie przesłaniały prawidłowych ścieżek HKEY_CURRENT_USER. Więcej informacji znajdziesz w artykule Publikowanie instalatora.

Migracja z interfejsu API na pakiet SDK

Migracja z interfejsu API na pakiet SDK jest krokiem opcjonalnym. Jeśli zdecydujesz się na migrację, postępuj zgodnie z tymi zaleceniami:

  • Usuń starsze interfejsy API typu REST: zmapuj wywołania starszego interfejsu Play Developer API (np. purchases.products.get) na funkcje natywnego pakietu SDK po stronie klienta. Więcej informacji znajdziesz w przewodniku po migracji.
  • Sprawdź argumenty wiersza poleceń: argumenty wiersza poleceń w środowisku pakietu SDK mogą się różnić od argumentów w środowisku interfejsu API. Sprawdź, czy pakiet prawidłowo obsługuje i przekazuje wszystkie argumenty. Więcej informacji znajdziesz w artykule Weryfikacja.
  • Sprawdź ścieżkę rejestru: aby migracja do pakietu Native SDK przebiegła bezproblemowo, konfiguracja rejestru musi być zgodna z poprzednimi wersjami. Więcej informacji znajdziesz w przewodniku po plikach WAB.

Zobacz też