Lista kontrolna uruchomienia

Skorzystaj z tej listy kontrolnej, aby przed przesłaniem gry do sprawdzenia w Grach Google Play na PC upewnić się, że spełnia ona wszystkie wymagania i najlepsze praktyki.

Konfigurowanie projektu

  • Pobierz i zaimportuj pakiet SDK: zintegruj najnowszy pakiet SDK do 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, który będzie mapować <PackageName> na zgłoszony pakiet w Konsoli Play. Więcej informacji znajdziesz w przewodniku po pliku manifestu.
  • Cyfrowo podpisz plik wykonywalny: podpisz grę za pomocą podpisu cyfrowego Authenticode i zabezpiecz certyfikat na potrzeby wszystkich przyszłych aktualizacji. Podczas tworzenia aplikacji lokalnie możesz pominąć ten krok, włączając tryb deweloperski. Jednak ostateczny plik binarny musisz podpisać za pomocą rzeczywistego certyfikatu produkcyjnego wydanego przez znanego dostawcę certyfikatów. Więcej informacji znajdziesz w artykule Cyfrowe podpisywanie gry.
  • Sformatuj i wyślij certyfikat: wyślij informacje o certyfikacie przedstawicielowi 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 zaczniesz korzystać z innych funkcji. Więcej informacji znajdziesz w przewodniku po inicjowaniu.
  • Wdróż łatwe logowanie: automatycznie uwierzytelniaj graczy za pomocą konta klienta Gier Play za pomocą interfejsu Recall API. Więcej informacji znajdziesz w przewodniku po bezproblemowym logowaniu.
  • Zintegruj Play Integrity: użyj IntegrityClient, aby poprosić o tokeny i zweryfikować legalność sesji gry na backendzie. Więcej informacji znajdziesz w przewodniku po Play Integrity.
  • Dodaj interfejs Play Install Referrer API: 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 instalatorze.
  • Obsługa błędów inicjowania: aby używać pakietu SDK, wywołaj funkcję GooglePlayInitialize (C++) lub GooglePlayInitialization.InitializeAsync (C#), aby zainicjować interfejs 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 wartość true, zanim będziesz mieć możliwość używania innych interfejsów API.
  • Obsługa obowiązkowego wyłączenia: obsługa kActionRequiredShutdownClientProcess przez jak najszybsze wyłączenie procesu klienta.
  • Obsługa wymagań dotyczących instalacji Gier Google Play: obsługa kSdkRuntimeUnavailable przez informowanie użytkowników, że aby kontynuować, muszą zainstalować Gry Google Play i środowisko wykonawcze pakietu SDK.
  • Obsługa aktualizacji Gier Google Play: obsługa kSdkRuntimeUpdateRequired przez powiadamianie użytkowników o konieczności zaktualizowania środowiska wykonawczego Gier Google Play.

Wdrażanie Płatności w Play

  • Sprawdź typy zakupów: upewnij się, że gra korzysta tylko z zakupów w aplikacji, ponieważ płatności cykliczne i subskrypcje nie są obsługiwane. Więcej informacji znajdziesz w odpowiedziach na najczęstsze pytania dotyczące rozliczeń.
  • 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 wysyłaniu zapytań o produkty.
  • Uruchom proces zakupu: użyj LaunchPurchaseFlow, aby natywnie przetwarzać transakcje. Jeśli zamkniesz przeglądarkę płatności bez dokonania płatności, wystąpi błąd przekroczenia limitu czasu (5 minut). Więcej informacji znajdziesz w przewodniku po procesie zakupu.
  • Przywracanie istniejących zakupów: wywołuj QueryPurchases podczas uruchamiania i przechodzenia na pierwszy plan, aby wykrywać niepotwierdzone zakupy na różnych urządzeniach. Więcej informacji znajdziesz w przewodniku po przywracaniu zakupów.
  • Bezpieczne przetwarzanie backendu: przed przyznaniem uprawnień i sfinalizowaniem transakcji za pomocą AcknowledgePurchase lub ConsumePurchase sprawdź na backendzie wartość purchaseToken. Więcej informacji znajdziesz w przewodniku po bezpiecznym przetwarzaniu.
  • Uwzględnij opóźnienie w rozpowszechnianiu klucza licencyjnego: podczas konfigurowania nowych kluczy rozliczeniowych lub licencyjnych w Konsoli Play odczekaj kilka godzin, aż pamięć podręczna backendu zsynchronizuje się w środowiskach obsługi handlu, zanim przeprowadzisz testy zakupu na żywo. Próby zakupu podjęte przed zakończeniem synchronizacji zwrócą kod błędu 6.

Testowanie w trybie programisty i przeprowadzanie testów jakości przed opublikowaniem

  • Testowanie w trybie programisty: dodaj <IsDeveloperMode>true</IsDeveloperMode> do manifestu i skonfiguruj identyfikator GUID partnera w ramach wcześniejszego dostępu do lokalnego zintegrowanego środowiska programistycznego (IDE). Jeśli nie masz identyfikatora GUID partnera z wczesnym dostępem, wypełnij formularz zgłoszenia zainteresowania.
  • Zarządzanie zakupami w trybie dewelopera: gdy testujesz zakupy w trybie dewelopera, wykorzystaj je w ciągu 3 minut, aby zapobiec automatycznym zwrotom środków. Więcej informacji znajdziesz w odpowiedziach na najczęstsze pytania dotyczące testowania.
  • Usuń tryb programisty: jak najszybciej usuń 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: przekazywanie wszystkich nieznanych argumentów wiersza poleceń otrzymanych przez program uruchamiający od klienta Gry Google Play bezpośrednio do uruchomionego procesu gry. Więcej informacji znajdziesz w przewodniku po wieloprocesowości.
  • Testowanie przy użyciu sieci VPN: jeśli testujesz z nieobsługiwanego regionu, użyj sieci VPN z włączonym trybem TUN, aby uzyskać obsługiwany adres IP. Więcej informacji znajdziesz w najczęstszych pytaniach dotyczących testowania sieci VPN.
  • Obsługa skrótów na komputerze: aby zapewnić bezproblemową obsługę skrótów, zapoznaj się z najczęstszymi pytaniami dotyczącymi skrótów. Bezpośrednie uruchamianie gry lub launchera innej firmy za pomocą skrótu może powodować błędy inicjowania.

Pakowanie, testowanie i publikowanie gry

  • Spakuj WAB: użyj narzędzia do publikowania w Google Play, aby spakować grę w pakiet aplikacji dla systemu Windows (WAB). Plik WAB musi mieć rozmiar mniejszy niż 10 GB w przypadku publikowania instalatora i 200 GB w przypadku publikowania zarządzanego w Google Play. Więcej informacji znajdziesz w przewodniku po pakowaniu.
  • Używaj najnowszych pakietów SDK i narzędzi: kompiluj i pakuj wersję za pomocą najnowszych wersji pakietu SDK do gier Play na PC, pakietu SDK do 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ą one działać z uprawnieniami administratora, co spowoduje błąd uruchomienia. Więcej informacji znajdziesz w artykule Format pliku konfiguracyjnego WAB.
  • Prześlij instalatory programów uruchamiających innych firm: jeśli używasz programu uruchamiającego innej firmy, prześlij jego instalator w ramach pakietu WAB. Więcej informacji znajdziesz w przewodniku po publikowaniu instalatorów.
  • Obsługa tokena sesji automatycznego odtwarzania: jeśli włączysz automatyczne odtwarzanie, 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 uruchomienia gry. Upewnij się, że instalator obsługuje przypadek, w którym token nie jest obecny. Więcej informacji znajdziesz w odpowiedziach na najczęstsze pytania dotyczące Launchera.
  • Zaktualizuj grę oraz program uruchamiający lub instalator: zawartość pakietu, w tym instalatory programów uruchamiających, musi mieć możliwość samodzielnej aktualizacji. zarządzać wszystkimi zasobami, których potrzebuje gra, w tym aktualizować sam program uruchamiający;
  • Udostępnij Google informacje o wprowadzeniu aplikacji na rynek: skontaktuj się z partnerem Google Play i podaj nazwę pakietu, kraje, w których aplikacja zostanie wprowadzona na rynek (używając 2-znakowych kodów ISO, np. US, CA, MX), oraz datę i godzinę wprowadzenia aplikacji na rynek w uniwersalnym czasie koordynowanym (UTC).
  • Skonfiguruj dostęp do testów: podaj zewnętrzną grupę Google, którą chcesz dodać do listy dozwolonych na potrzeby testowania, dokumentacji i dostępu do Dysku Google. Udostępnij partnerowi Google Play listę adresów e-mail kont testowych, ponieważ ścieżki testowe w Konsoli Play nie są obsługiwane na komputerach.
  • Dodaj format PC: wyraźnie dodaj format „Gry Google Play na PC” do aplikacji w Konsoli Google Play. Jeśli nie masz dostępu do tej karty, skontaktuj się z partnerem Google Play, aby dodać swoje konto do listy dozwolonych.
  • Skonfiguruj wymagania dotyczące komputerów: wpisz wymagania sprzętowe (pamięć RAM, GPU, pamięć masowa) dla komputerów z systemem Windows. Więcej informacji znajdziesz w przewodniku po wymaganiach dotyczących komputerów.
  • Prześlij komponenty sklepu: prześlij spakowany plik WAB na ścieżkę produkcyjną i skonfiguruj komponenty wizualne. Więcej informacji znajdziesz w przewodniku po przesyłaniu komponentów.
  • Opublikuj na potrzeby testowania w środowisku użytkownika: w Konsoli Google Play kliknij Opublikuj. W przeciwieństwie do wersji na Androida wybranie opcji Opublikuj w przypadku WAB nie powoduje publicznego udostępnienia aplikacji. Zamiast tego sprawia, że aplikacja jest wyszukiwalna na udostępnionych kontach testowych, aby można było przeprowadzać testy w środowisku użytkownika po zakończeniu procesu weryfikacji przez Google.
  • Oficjalne wprowadzenie: Google kontroluje wprowadzenie na podstawie oficjalnej daty wprowadzenia, którą podasz partnerowi Google Play.
  • Testowanie podczas wcześniejszej rejestracji: w fazie wcześniejszej rejestracji musisz przeprowadzić testy wewnętrzne w kraju, który nie jest uwzględniony w wybranych regionach objętych wcześniejszą rejestracją.
  • 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.

Przejście z interfejsu API na pakiet SDK

Migracja z interfejsu API do pakietu SDK jest opcjonalna. Jeśli zdecydujesz się na migrację, postępuj zgodnie z tymi zaleceniami:

  • Usuń starsze interfejsy API typu REST: zmapuj starsze wywołania interfejsu Play Developer API (np. purchases.products.get) na funkcje pakietu Native 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 obsługuje i przekazuje wszystkie argumenty prawidłowo. Więcej informacji znajdziesz w sekcji Weryfikacja.
  • Sprawdź ścieżkę rejestru: aby zapewnić płynną migrację do natywnego pakietu SDK, konfiguracja rejestru musi być zgodna z poprzednimi wersjami. Więcej informacji znajdziesz w przewodniku po plikach WAB.

Zobacz też