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 Usług 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.
  • Podpisz cyfrowo plik wykonywalny: podpisz grę za pomocą podpisu cyfrowego Authenticode i zabezpiecz certyfikat na potrzeby wszystkich przyszłych aktualizacji. Podczas lokalnego tworzenia aplikacji możesz pominąć ten krok, włączając tryb deweloperski, ale ostateczny plik binarny musisz podpisać rzeczywistym certyfikatem produkcyjnym wydanym przez znany urząd certyfikacji. 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óż bezproblemowe logowanie: automatycznie uwierzytelniaj graczy za pomocą konta klienta Usług Gier Play za pomocą interfejsu Recall API. Więcej informacji znajdziesz w przewodniku po bezproblemowym logowaniu.
  • Zintegruj Play Integrity: użyj IntegrityClient, aby wysyłać prośby o tokeny i weryfikować legalność sesji w grze na backendzie. Więcej informacji znajdziesz w przewodniku po integralności w Google Play.
  • 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 instalacjach z polecenia.
  • 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.
  • Spełnij wymagania dotyczące instalacji Gier Google Play: poinformuj użytkowników, że aby kontynuować, muszą zainstalować Gry Google Play i środowisko wykonawcze pakietu SDK.kSdkRuntimeUnavailable
  • Obsługa aktualizacji Gier Google Play: obsługa kSdkRuntimeUpdateRequired przez powiadamianie użytkowników, że wymagana jest aktualizacja środowiska wykonawczego Gier Google Play.

Wdrażanie Płatności w Google 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 przetwarzać transakcje natywnie. 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 na backendzie: 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.

Testowanie w trybie programisty i przeprowadzanie kontroli jakości przed publikacją

  • 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: musisz jak najszybciej usunąć tag <IsDeveloperMode> przed spakowaniem wersji. 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 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 odpowiedziach na najczęstsze pytania dotyczące 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 prowadzić do błędów inicjowania.

Pakowanie, testowanie i publikowanie gry

  • Spakuj plik WAB: użyj narzędzia do publikowania w Google Play, aby spakować grę w pakiet aplikacji dla systemu Windows (WAB). Rozmiar pliku WAB musi być mniejszy niż 10 GB. Więcej informacji znajdziesz w przewodniku po pakowaniu.
  • 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 sekcji Format pliku konfiguracyjnego WAB.
  • Przesyłanie instalatorów 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 publikowania instalatora.
  • 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 potrzebnymi do działania gry, 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ę dyskusyjną Google, którą chcesz dodać do listy dozwolonych na potrzeby testów, 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ęć) dla komputerów z systemem Windows. Więcej informacji znajdziesz w przewodniku po wymaganiach dotyczących komputerów.
  • Prześlij zasoby sklepu: prześlij spakowany plik WAB na ścieżkę produkcyjną i skonfiguruj zasoby wizualne. Więcej informacji znajdziesz w przewodniku przesyłania komponentów.
  • Opublikuj, aby przetestować środowisko 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 po procesie weryfikacji przez Google można było przeprowadzać testy w środowisku użytkownika.
  • 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ć test wewnętrzny w kraju, który nie jest uwzględniony w wybranych regionach objętych wcześniejszą rejestracją.
  • Sprawdź zakończenie procesu instalacji: upewnij się, że główny proces instalacji pozostaje aktywny, dopóki nie zostaną utworzone i zarejestrowane wszystkie wymagane klucze 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ż