Questa pagina è stata tradotta dall'API Cloud Translation.

Pubblica il tuo gioco

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 per 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.xml con 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</version-name>
  </application>
  <installer requiresElevation=REQUIRES_ELEVATION>
    <path>PATH</path>
    <installation-path-registry-location>
      <key-name>KEY1</key-name>
      <value-name>VALUE1</value-name>
    </installation-path-registry-location>
  </installer>
  <launcher requiresElevation=REQUIRES_ELEVATION>
    <launch-path-registry-location >
      <key-name>KEY2</key-name>
      <value-name>VALUE2</value-name>
    </launch-path-registry-location>
    <executable-invocation>
      <filename>FILENAME</filename>
      <arguments>ARGS</arguments>
    </executable-invocation>
  </launcher>
  <uninstaller requiresElevation=REQUIRES_ELEVATION>
    <uninstall-path-registry-location>
      <key-name>KEY3</key-name>
      <value-name>VALUE3</value-name>
    </uninstall-path-registry-location>
  </uninstaller>
</play-publishing-config>

Sostituisci quanto segue:

PACKAGE_NAME: Il nome del pacchetto del tuo gioco. Ad esempio, test.package.name.
VERSION: La versione del gioco. Ad esempio, 1.0.
REQUIRES_ELEVATION: indica se l'eseguibile deve essere eseguito con autorizzazioni elevate, ad esempio quelle di un amministratore.
- "true": esegui l'eseguibile con autorizzazioni elevate.
  
  Avviso: viene visualizzato un prompt UAC per il giocatore.
- "false": esegui l'eseguibile senza privilegi elevati.
PATH: il percorso del file EXE del programma di installazione del tuo gioco. Questo percorso può essere assoluto o relativo alla directory principale della configurazione di pubblicazione di Play. Ad esempio, path\to\test\installer. Utilizza authenticode e la firma del codice per firmare il file EXE del programma di installazione del gioco.
KEY1, VALUE1: specifica le coppie di valori della chiave di registro di Windows nell'elemento installer.
KEY2, VALUE2: specifica le coppie di valori della chiave di registro di Windows nell'elemento launcher.
KEY3, VALUE3: specifica le coppie di valori della chiave di registro di Windows nell'elemento uninstaller.

Nota :il tuo gioco richiede queste chiavi del Registro di sistema di Windows per l'installazione, l'avvio e la disinstallazione su Windows. Specifica le chiavi di registro relative all'hive radice. Ad esempio, se il nome completo della chiave del Registro di sistema è HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Uninstall specifica solo Software\Microsoft\Windows\CurrentVersion\Uninstall.
FILENAME: specifica il percorso dell'eseguibile del programma di avvio del gioco. Ad esempio, path\to\launcher.exe.
ARGS: Gli argomenti dell'eseguibile del launcher del gioco. Questi sono facoltativi.

Esempio di file di configurazione della pubblicazione su Google Play

Prendi in considerazione un gioco chiamato MyGame, con il programma di installazione del gioco game_installer.exe e l'avvio del gioco launcher.exe. L'esempio mostra anche come utilizzare CDATA. Di seguito è riportato l'aspetto di play_publishing_config.xml:

<?xml version="1.0" encoding="UTF-8"?>

<play-publishing-config version="1.0">
  <application>
    <package-name>test.package.name</package-name>
    <version-name>1.0</version-name>
  </application>
  <installer requiresElevation="true">
    <path>game_installer.exe</path>
    <installation-path-registry-location>
      <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MyGame</key-name>
      <value-name>InstallPath</value-name>
    </installation-path-registry-location>
  </installer>

  <launcher requiresElevation="true">
    <launch-path-registry-location >
      <key-name>SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\MyGame</key-name>
      <value-name>ExePath</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\\MyGame</key-name>
      <value-name>UninstallString</value-name>
    </uninstall-path-registry-location>
  </uninstaller>
</play-publishing-config>

Esegui lo strumento di pubblicazione 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.
Importante:il nome file WAB in --output deve avere un'estensione .wab.

Nota: i percorsi --input e --output possono essere assoluti o relativi rispetto alla directory di lavoro corrente.
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 Play play_publishing_config.xml e il programma di installazione del gioco game_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.wab nella stessa directory, il comando sarebbe:
```
playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab
```
Con l'argomento --force, il comando sarà simile a questo:
```
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 dal menu a discesa + Aggiungi fattore di forma.

Nota :se non riesci ad accedere a Google Play Giochi su PC nella scheda Fattori di forma, puoi contattare i nostri partner di Play per inserire il tuo account nella lista consentita.
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 pacchetto 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.

Una volta che il team di revisione avrà approvato le modifiche, il tuo gioco sarà rilevabile su Google Play.