Elenco di controllo per il lancio

Utilizza questo elenco di controllo per assicurarti che il tuo gioco soddisfi tutti i requisiti e le best practice prima di inviarlo per la revisione su Google Play Giochi su PC.

Configurare il progetto

  • Scarica e importa l'SDK: integra l'ultima versione dell'SDK Play Games per PC per il tuo ambiente. Per saperne di più, consulta la guida per Unity o la guida per C++.
  • Crea il manifest dell'applicazione: crea un file manifest.xml che mappa il <PackageName> al pacchetto Play Console che hai rivendicato. Per saperne di più, consulta la guida al manifest.
  • Firma digitalmente l'eseguibile: firma il gioco utilizzando una firma digitale Authenticode e proteggi il certificato per tutti gli aggiornamenti futuri. Anche se puoi saltare questo passaggio durante lo sviluppo locale attivando la modalità sviluppatore, devi firmare il file binario finale con un certificato di produzione effettivo di un'autorità di certificazione nota. Per saperne di più, consulta la sezione Firmare digitalmente il gioco.
  • Formatta e invia il certificato: Invia le informazioni del certificato al tuo rappresentante Google. Il file del certificato deve contenere solo informazioni relative al certificato; verifica che tutti i blocchi non relativi al certificato siano stati rimossi. Puoi utilizzare OpenSSL per convertire i file DER/CER nel formato PEM richiesto.

Integrare API e funzionalità

  • Inizializza l'SDK: implementa la logica di inizializzazione dell'SDK, ad esempio InitializeAsync, durante l'avvio prima di utilizzare altre funzionalità. Per saperne di più, consulta la guida all'inizializzazione.
  • Implementa l'accesso senza interruzioni: autentica automaticamente i giocatori utilizzando l'account client Play Games tramite l'API Recall. Per saperne di più, consulta la guida all'accesso senza interruzioni.
  • Integra Play Integrity: utilizza IntegrityClient per richiedere token e verificare la legittimità delle sessioni di gioco sul backend. Per saperne di più, consulta la guida a Play Integrity.
  • Aggiungi Play Install Referrer: integra l'API Install Referrer se devi monitorare le origini di acquisizione degli utenti per PC. Per saperne di più, consulta la guida a Install Referrer.
  • Gestisci gli errori di inizializzazione: per utilizzare l'SDK, chiama GooglePlayInitialize (C++) o GooglePlayInitialization.InitializeAsync (C#) per inizializzare l'API. Prima di poter utilizzare qualsiasi altra API, devi chiamare questa API e verificare che il callback di continuazione venga completato con InitializeResult::ok() (C++) o che Result.IsOk (C#) restituisca true.
  • Gestisci l'arresto obbligatorio: gestisci kActionRequiredShutdownClientProcess arrestando il processo client il prima possibile.
  • Gestisci i requisiti di installazione di Google Play Giochi: gestisci kSdkRuntimeUnavailable informando gli utenti che per procedere è necessario installare Google Play Giochi e il runtime dell'SDK.
  • Gestisci gli aggiornamenti di Google Play Games: gestisci kSdkRuntimeUpdateRequired notificando agli utenti che è necessario un aggiornamento del runtime di Google Play Games.

Implementare Fatturazione Play

  • Controlla i tipi di acquisto: verifica che il gioco si basi solo sugli acquisti in-app, perché i pagamenti ricorrenti e gli abbonamenti non sono supportati. Per saperne di più, consulta le domande frequenti sulla fatturazione.
  • Esegui query sui dettagli del prodotto: utilizza QueryProductDetails per recuperare i dati del negozio localizzati. Se hai più di 50 prodotti, suddividi la richiesta in più chiamate. Per saperne di più, consulta la guida Eseguire query sui prodotti.
  • Avvia il flusso di acquisto: utilizza LaunchPurchaseFlow per elaborare le transazioni in modo nativo. Se chiudi il browser di pagamento senza pagare, si verifica un errore di timeout di cinque minuti. Per saperne di più, consulta la guida al flusso di acquisto.
  • Ripristina gli acquisti esistenti: chiama QueryPurchases all'avvio e in primo piano per intercettare gli acquisti cross-device non riconosciuti. Per saperne di più, consulta la guida Ripristinare gli acquisti.
  • Proteggi l'elaborazione del backend: convalida il purchaseToken sul backend prima di concedere i diritti e finalizzare con AcknowledgePurchase o ConsumePurchase. Per saperne di più, consulta la guida all'elaborazione sicura.
  • Tieni conto del ritardo di propagazione della chiave di licenza: quando configuri nuove chiavi di fatturazione o di licenza in Play Console, attendi diverse ore prima che la cache del backend si sincronizzi tra gli ambienti di pubblicazione commerciale prima di eseguire test di acquisto live. Gli acquisti tentati prima del completamento della sincronizzazione restituiranno il codice di errore 6.

Eseguire test in modalità sviluppatore ed eseguire QA pre-lancio

  • Esegui test in modalità sviluppatore: aggiungi <IsDeveloperMode>true</IsDeveloperMode> a l manifest e configura il GUID del partner di accesso anticipato per i test dell'ambiente di sviluppo integrato (IDE) locale. Se non hai un GUID del partner di accesso anticipato, compila il modulo di interesse rapido.
  • Gestisci gli acquisti in modalità sviluppatore: quando testi gli acquisti in modalità sviluppatore, consuma l'acquisto entro tre minuti per evitare rimborsi automatici. Per saperne di più, consulta le domande frequenti sui test.
  • Rimuovi la modalità sviluppatore: devi rimuovere il tag <IsDeveloperMode> prima di creare il pacchetto della build di release il prima possibile. Per saperne di più, consulta la guida alla modalità sviluppatore.
  • Inoltra gli argomenti utilizzando launcher di terze parti: passa tutti gli argomenti della riga di comando sconosciuti ricevuti dal launcher dal client Google Play Giochi direttamente al processo di gioco generato. Per saperne di più, consulta la guida al processo multiplo.
  • Esegui test con una VPN: se esegui test da una regione non supportata, utilizza una VPN con la modalità TUN attivata per acquisire un indirizzo IP supportato. Per saperne di più, consulta le domande frequenti sui test VPN.
  • Supporta le scorciatoie del desktop: per un supporto senza interruzioni delle scorciatoie, consulta le domande frequenti sulle scorciatoie per l'esecuzione delle scorciatoie. L'avvio diretto del gioco o di un launcher di terze parti utilizzando una scorciatoia potrebbe causare errori di inizializzazione.

Creare il pacchetto, testare e pubblicare il gioco

  • Crea il pacchetto WAB: utilizza lo strumento di pubblicazione di Play per creare il pacchetto del gioco in un Windows App Bundle (WAB). Le dimensioni del file WAB devono essere inferiori al limite di 10 GB. Per saperne di più, consulta la guida alla creazione di pacchetti Packaging guide.
  • Verifica se è necessario l'innalzamento dei privilegi: se il programma di installazione, il launcher o il programma di disinstallazione devono essere eseguiti come amministratore ogni volta che vengono avviati, ricorda di verificare se hai impostato INSTALLER_REQUIRES_ELEVATION, LAUNCHER_REQUIRES_ELEVATION o UNINSTALLER_REQUIRES_ELEVATION su true. In caso contrario, non verranno eseguiti con privilegi amministrativi, il che comporterà un errore di avvio. Per maggiori dettagli, consulta Formato del file di configurazione WAB.
  • Invia i programmi di installazione del launcher di terze parti: se utilizzi un launcher di terze parti, invia il relativo programma di installazione all'interno del WAB. Per saperne di più, consulta la guida alla pubblicazione del programma di installazione.
  • Gestisci il token di sessione di riproduzione automatica: se attivi la riproduzione automatica impostando acceptsCommandLineArguments="true" in play_publishing_config.xml, verifica che il programma di installazione estragga l'argomento della riga di comando --g_session_token=<token> e lo utilizzi per avviare il gioco. Assicurati che il programma di installazione gestisca il caso di fallback in cui il token non è presente. Per saperne di più, consulta le domande frequenti sul launcher.
  • Aggiorna il gioco e il launcher o il programma di installazione: i contenuti del pacchetto, inclusi i programmi di installazione del launcher, devono essere autoaggiornabili. Gestisci tutte le risorse di cui il gioco ha bisogno, incluso l'aggiornamento del launcher stesso.
  • Condividi le informazioni di lancio con Google: contatta il tuo partner Play e condividi il nome del pacchetto, i paesi di lancio (utilizzando i codici ISO a 2 caratteri, ad esempio US, CA, MX) e la data e l'ora di lancio in UTC (Coordinated Universal Time).
  • Configura l'accesso ai test: fornisci un gruppo Google esterno da aggiungere a una lista consentita per i test, la documentazione e l'accesso a Google Drive. Condividi un elenco di indirizzi email degli account di test con il tuo partner Play, perché i canali di test di Play Console non sono supportati per PC.
  • Aggiungi il fattore di forma PC: aggiungi esplicitamente il fattore di forma "Google Play Giochi su PC" alla tua app in Google Play Console. Se non riesci ad accedere a questa scheda, contatta il tuo partner Play per aggiungere il tuo account a una lista consentita.
  • Configura i requisiti del PC: inserisci i requisiti hardware (RAM, GPU, spazio di archiviazione) per i PC Windows. Per saperne di più, consulta la guida ai requisiti del PC.
  • Carica gli asset dello Store: carica il file WAB con pacchetto nel canale di produzione e configura gli asset visivi. Per saperne di più, consulta la guida al caricamento degli asset.
  • Pubblica per i test dell'ambiente utente: seleziona Pubblica in Google Play Console. A differenza della versione Android, la selezione di Pubblica sul WAB non attiva una release pubblica. Al contrario, rende l'app ricercabile per gli account di test condivisi per eseguire test in un ambiente utente dopo la procedura di revisione di Google.
  • Lancia ufficialmente: Google controlla il lancio in base alla data di lancio ufficiale che hai condiviso con il tuo partner Play.
  • Esegui test durante la preregistrazione: durante la fase di preregistrazione, devi eseguire test interni in un paese non incluso nelle regioni di preregistrazione selezionate.
  • Verifica la terminazione del processo di installazione: verifica che il processo di installazione principale rimanga attivo finché non vengono create e registrate tutte le chiavi di registro richieste. Se il processo termina prematuramente, la verifica dell'installazione non va a buon fine. Per saperne di più, consulta la sezione Pubblicazione del programma di installazione.

Eseguire la migrazione dall'API all'SDK

La migrazione dall'API all'SDK è un passaggio facoltativo. Se scegli di eseguire la migrazione, segui queste raccomandazioni:

  • Rimuovi le API REST legacy: mappa le chiamate API Play Developer legacy (ad esempio, purchases.products.get) alle funzioni dell'SDK nativo lato client. Per saperne di più, consulta la guida alla migrazione.
  • Verifica gli argomenti della riga di comando: gli argomenti della riga di comando nell'ambiente SDK potrebbero essere diversi da quelli nell'ambiente API. Verifica che il pacchetto gestisca e passi correttamente tutti gli argomenti. Per saperne di più, consulta la sezione Verifica.
  • Verifica il percorso del registro: per una migrazione senza interruzioni all'SDK nativo, la configurazione del registro deve rimanere coerente con le versioni precedenti. Per saperne di più, consulta la guida al file WAB.

Vedi anche