Questo documento mostra come pubblicare il tuo gioco su Google Play Giochi su PC.
Prima di iniziare
Integra l'SDK Google Play Giochi nel tuo gioco.
Pacchettizzare il gioco come file WAB
Google Play Giochi su PC richiede che il programma di installazione del gioco venga caricato su Google Play Console come file app bundle Windows (WAB). Per creare un file WAB, segui questi passaggi:
Scarica lo strumento di pubblicazione di Google Play. Puoi eseguire questo strumento sulla riga di comando di Windows o su PowerShell.
Crea il file di configurazione di pubblicazione di Google Play con un nome qualsiasi. Ad esempio,
play_publishing_config.xmlcon il seguente formato:<?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> <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>
Sostituisci quanto segue:
PACKAGE_NAME: Il nome del pacchetto del tuo gioco. Ad esempio,com.yourcompany.yourgame.VERSION_NAME: La stringa di versione del gioco. Ad esempio,1.0.0.INSTALLER_REQUIRES_ELEVATION: indica se l'eseguibile del programma di installazione deve essere eseguito come amministratore per completare il processo di installazione."true": esegui l'eseguibile come amministratore.
"false": esegui l'eseguibile come utente corrente.
INSTALLER_PATH: il percorso del file di installazione all'interno del WAB. Questo percorso può essere assoluto o relativo alla directory principale della configurazione di pubblicazione di Play. Ad esempio,path\to\test\installer. Ricordati di utilizzare authenticode e la firma del codice per firmare l'eseguibile del programma di installazione del tuo gioco.UNIQUE_REGISTRY_PATH: La chiave principale che conterrà tutte le informazioni del registro. Deve essere univoco in tutta la macchina dell'utente. Questo sarà il percorso relativo in cima a HKLM. Ad esempio,SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\YourUniqueName. Questa voce creerà una chiave principale inHKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueNamesu un computer Windows 11 a 64 bit.LAUNCHER_REQUIRES_ESCALATION: indica se il launcher o l'eseguibile del gioco deve essere eseguito come amministratore ogni volta che viene avviato."true": esegui l'eseguibile come amministratore.
"false": esegui l'eseguibile come utente corrente.
RELATIVE_PATH_TO_LAUNCHER_EXE: il percorso del launcher o dell'eseguibile del gioco all'interno della directory di installazione. Deve includere il nome file eseguibile del launcher o del gioco. Ad esempio, se il file di avvio o di gioco si chiama mygame.exe e si trova in {INSTALL_DIR}\Resources\mygame.exe, devi inserire Resources\mygame.exeLAUNCHER_ARGS_IF_ANY: eventuali argomenti della riga di comando che devono essere passati al launcher o al gioco. Questa voce è facoltativa.UNINSTALLER_REQUIRES_ELEVATION: indica se l'eseguibile del programma di disinstallazione deve essere eseguito come amministratore per completare il processo di disinstallazione."true": esegui l'eseguibile come amministratore.
"false": esegui l'eseguibile come utente corrente.
Esempio di file di configurazione della pubblicazione su Google Play
Prendi in considerazione un gioco chiamato
MyGame, con il programma di installazione del giocogame_installer.exee l'avvio app del giocolauncher.exe. L'esempio mostra anche come utilizzare CDATA. Di seguito è riportato l'aspetto diplay_publishing_config.xml:<?xml version="1.0" encoding="UTF-8"?> <play-publishing-config version="1.0"> <application> <package-name>com.mycompany.mygame</package-name> <version-name>1.0.0</version-name> </application> <installer requiresElevation="true"> <path>game_installer.exe</path> <installation-path-registry-location> <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MySystemWideUniqueKey</key-name> <value-name>InstallLocation</value-name> </installation-path-registry-location> </installer> <launcher requiresElevation="true"> <launch-path-registry-location > <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MySystemWideUniqueKey</key-name> <value-name>InstallLocation</value-name> </launch-path-registry-location> <executable-invocation> <filename>launcher.exe</filename> <arguments><![CDATA[arg1&arg2>arg3]]></arguments> </executable-invocation> </launcher> <uninstaller requiresElevation="true"> <uninstall-path-registry-location> <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MySystemWideUniqueKey</key-name> <value-name>UninstallString</value-name> </uninstall-path-registry-location> </uninstaller> </play-publishing-config>Esegui lo strumento di pubblicazione di Play sulla riga di comando di Windows o su PowerShell.
playpublishingtool.exe build-installer-bundle --input=PLAY_PUBLISHING_CONFIG_PATH --output=WAB_OUTPUT_PATH
Per sovrascrivere un file WAB esistente con lo stesso nome, utilizza l'argomento
--force.playpublishingtool.exe build-installer-bundle --input=PLAY_PUBLISHING_CONFIG_PATH --output=WAB_OUTPUT_PATH --force
Sostituisci quanto segue:
PLAY_PUBLISHING_CONFIG_PATH: il percorso della configurazione di pubblicazione di Play. Ad esempio,path\to\play_publishing_config.xml.WAB_OUTPUT_PATH: il percorso del file WAB. Ad esempio,path\to\output_bundle.wab.
Come utilizzare lo strumento di pubblicazione di Play
Considera che nella directory di lavoro corrente sono presenti il file binario dello strumento di pubblicazione Play
playpublishingtool.exe, la configurazione di pubblicazione Playplay_publishing_config.xmle il programma di installazione del giocogame_installer.exe.La directory di lavoro corrente dovrebbe avere il seguente aspetto:
.\ ├── game_installer.exe ├── play_publishing_config.xml ├── playpublishingtool.exe
Per creare un WAB con il nome, ad esempio,
installer_bundle.wabnella stessa directory, il comando sarebbe simile a questo:playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab
Con l'argomento
--force, il comando sarà:playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab --force
In caso di esito positivo, dovresti vedere un output simile al seguente:
Successfully built the installer bundle at installer_bundle.wab
Trova il file WAB nella cartella:
.\ ├── game_installer.exe ├── installer_bundle.wab ├── play_publishing_config.xml ├── playpublishingtool.exe
Pubblicare il gioco utilizzando Play Console
Dopo aver creato correttamente il WAB per il tuo gioco, caricalo su Play Console e gestisci le relative impostazioni e i requisiti. Segui i passaggi per pubblicare il gioco:
Aggiungere il fattore di forma Google Play Giochi su PC
La pubblicazione di un gioco richiede questo passaggio solo la prima volta.
- In Play Console, nel menu a sinistra, seleziona Test e rilascio > Configurazione > Impostazioni avanzate (link diretto).
Vai alla scheda Fattori di forma e aggiungi
Google Play Games on PC(Windows)dal menu a discesa + Aggiungi fattore di forma.Fai clic sul pulsante Gestisci corrispondente al fattore di forma Google Play Giochi su PC sul lato destro.
Seleziona l'opzione Utilizza un canale dedicato per il tuo gioco in app bundle per Windows.
Fai clic su Salva, quindi di nuovo su Salva nella finestra di dialogo di conferma.
Carica il file WAB
Per caricare il file WAB:
- Nel menu a sinistra di Play Console, seleziona Test e release > Produzione (link diretto).
- Nella pagina Produzione, seleziona Solo Google Play Giochi su PC (Windows) dal menu a discesa del fattore di forma sul lato destro.
- Nella scheda App bundle per Windows, fai clic sul pulsante Carica un app bundle per Windows e carica il file WAB. In alternativa, puoi anche fare clic sul pulsante Carica un bundle di app Windows sul lato destro del menu a discesa del fattore di forma.
- Fai clic su Salva.
Configurare i requisiti del PC Windows
Per configurare i requisiti del PC Windows:
- In Play Console, nel menu a sinistra, seleziona Aumenta il numero di utenti > Presenza nello Store > Impostazioni dello Store (link diretto).
- Nella sezione Requisiti del PC, fai clic sul pulsante Modifica sul lato destro.
- Aggiorna i campi e fai clic su Salva.
Configurare l'immagine in primo piano per l'acquisto in-app
Questo passaggio è facoltativo. Per configurare l'immagine in primo piano per l'acquisto in-app:
- Nel menu a sinistra di Play Console, seleziona Aumenta il numero di utenti > Presenza nello Store > Schede dello Store(link diretto).
- Nella sezione Scheda dello Store predefinita della scheda Schede, fai clic sul pulsante -> (freccia) a destra. Verrà visualizzata la pagina Scheda dello Store predefinita.
- Vai alla sezione Google Play Giochi su PC e carica l'immagine in Immagine in primo piano per l'acquisto in-app di Google Play Giochi su PC (Windows).
- Fai clic su Salva.
Invia le modifiche per la revisione
- In Play Console, nel menu a sinistra, seleziona Panoramica della pubblicazione.
- Nella sezione Modifiche non ancora inviate per la revisione, fai clic su Invia modifiche per la revisione.
Quando il team di revisione avrà approvato le modifiche, il gioco sarà rilevabile su Google Play.