Pubblicazione del programma di installazione

Questo documento mostra come pubblicare il gioco su Google Play Giochi su PC utilizzando il programma di installazione del gioco.

Con il flusso di installazione da parte dello sviluppatore, il programma di installazione del gioco che fornisci deve gestire l'installazione, l'aggiornamento e la disinstallazione del gioco.

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:

  1. Scarica lo strumento di pubblicazione di Google Play. Puoi eseguire questo strumento sulla riga di comando di Windows o in PowerShell.

  2. 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_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. Si tratta dell'identificatore univoco che verrà associato al tuo gioco su Google Play. Ad esempio, com.yourcompany.yourgame. Il nome del pacchetto deve rispettare le seguenti regole:
      • Deve avere almeno due segmenti (uno o più punti).
      • Ogni segmento deve iniziare con una lettera.
      • Tutti i caratteri devono essere alfanumerici o un trattino basso ([a-zA-Z0-9_]).

    • VERSION_NAME: La stringa della versione del gioco. Può essere una stringa arbitraria, ma deve essere univoca in tutti i WAB caricati per il tuo gioco. Ad esempio: 1.0, 1.0.1-beta, 2025.11.24, v1.rc1.

      • 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 su 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 in HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName su un computer Windows 11 a 64 bit.

      • LAUNCHER_REQUIRES_ELEVATION: indica se l'eseguibile del launcher o 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 dell'eseguibile del launcher o 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.exe

      • LAUNCHER_ARGS_IF_ANY: Qualsiasi argomento della riga di comando che deve essere passato al launcher o al gioco. Questa voce è facoltativa.

        • In caso di più argomenti associati a un eseguibile, questi devono essere separati da uno spazio.
        • Gli argomenti devono essere preceduti da "--" o "-", se richiesto dall'eseguibile.

      • 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 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>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>

  3. 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.

    Come utilizzare lo strumento di pubblicazione di Play

    Considera di avere il 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 nella directory di lavoro corrente.

    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 simile al seguente:

    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 di Google Play Giochi su PC

Questo passaggio è obbligatorio solo la prima volta che pubblichi un gioco.

  1. In Play Console, nel menu a sinistra, seleziona Test e rilascio > Configurazione > Impostazioni avanzate (link diretto).

  2. Vai alla scheda Fattori di forma e aggiungi Google Play Games on PC dal menu a discesa + Aggiungi fattore di forma.

  3. Fai clic sul pulsante Gestisci corrispondente al fattore di forma Google Play Giochi su PC sul lato destro.

  4. Seleziona l'opzione Utilizza un canale dedicato per il tuo gioco in app bundle per Windows.

  5. Fai clic su Salva, quindi di nuovo su Salva nella finestra di dialogo di conferma.

Attiva la pubblicazione gestita

Per attivare la pubblicazione gestita, segui questi passaggi.

  1. Nella pagina Panoramica della pubblicazione, nella sezione Pubblicazione gestita, fai clic su Attiva pubblicazione gestita.
  2. Viene visualizzata una finestra di dialogo. Passa a Pubblicazione gestita attiva per il canale.
  3. Fai clic su Salva.

Carica il file WAB

Per caricare il file WAB:

  1. In Play Console, nel menu a sinistra, seleziona Test e release > Impostazioni avanzate (link diretto).
  2. Nella pagina Impostazioni avanzate, fai clic sulla scheda Fattori di forma.
  3. Nella scheda Fattori di forma, fai clic su + Aggiungi fattore di forma e seleziona Google Play Giochi su PC da aggiungere.
  4. Nella sezione Google Play Giochi su PC, fai clic su Gestisci.
  5. Seleziona Utilizza un canale dedicato per il tuo gioco in app bundle per Windows.
  6. Fai clic su Salva.
  7. Nel menu a sinistra di Play Console, seleziona Test e release > Produzione (link diretto).
  8. Nella pagina Produzione, seleziona Solo Google Play Giochi su PC (Windows) dal menu a discesa del fattore di forma.
  9. Nella scheda Pacchetto app Windows, fai clic su Modifica e carica il file WAB.

Configurare i requisiti del PC Windows

Per configurare i requisiti del PC Windows:

  1. In Play Console, nel menu a sinistra, seleziona Aumenta il numero di utenti > Presenza nello Store > Impostazioni dello Store (link diretto).
  2. Nella sezione Requisiti del PC, fai clic sul pulsante Modifica sul lato destro.
  3. Aggiorna i campi e fai clic su Salva.

Configurare l'immagine dell'acquisto in-app

Questo passaggio è facoltativo. Per configurare l'immagine in primo piano per l'acquisto in-app:

  1. Nel menu a sinistra di Play Console, seleziona Aumenta gli utenti > Presenza nello Store > Schede dello Store(link diretto).
  2. Nella sezione Scheda dello Store predefinita della scheda Schede, fai clic sul pulsante -> (freccia) a destra. Verrà visualizzata la pagina Scheda dello Store predefinita.
  3. 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).
  4. Fai clic su Salva.

Invia le modifiche per la revisione

  1. In Play Console, nel menu a sinistra, seleziona Panoramica della pubblicazione.
  2. 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.