Publikasi Penginstal

Dokumen ini menunjukkan cara memublikasikan game Anda di Google Play Game di PC menggunakan penginstal game Anda.

Dengan alur Diinstal Developer, penginstal game yang Anda berikan harus mengelola penginstalan, update, dan peng-uninstalan game.

Sebelum memulai

Integrasikan Google Play Game SDK ke dalam game Anda.

Mengemas game Anda sebagai file WAB

Google Play Game di PC mengharuskan penginstal game Anda diupload ke Konsol Google Play sebagai file app bundle Windows (WAB). Untuk membuat file WAB, ​ikuti langkah-langkah berikut:

  1. Download alat publikasi Play. Anda dapat menjalankan alat ini di command line Windows atau PowerShell.

  2. Buat file konfigurasi penerbitan Play, dengan nama apa pun. Misalnya, play_publishing_config.xml dengan format berikut:

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

    Ganti kode berikut:

    • PACKAGE_NAME: Nama paket untuk game Anda. Ini adalah ID unik yang akan dikaitkan dengan game Anda di Google Play. Misalnya, com.yourcompany.yourgame. Nama paket harus mematuhi aturan berikut:
      • Nama harus memiliki setidaknya dua bagian (satu atau beberapa titik).
      • Setiap bagian harus diawali dengan huruf.
      • Semua karakter harus berupa alfanumerik atau garis bawah ([a-zA-Z0-9_]).

    • VERSION_NAME: String versi game. Ini dapat berupa string arbitrer, tetapi harus unik di semua WAB yang diupload untuk game Anda. Misalnya: 1.0, 1.0.1-beta, 2025.11.24, v1.rc1.

      • INSTALLER_REQUIRES_ELEVATION: Menunjukkan apakah file yang dapat dieksekusi penginstal perlu dijalankan sebagai Administrator untuk menyelesaikan proses penginstalan.

        • "true": Jalankan file yang dapat dieksekusi sebagai Administrator.
        • "false": Jalankan file yang dapat dieksekusi sebagai pengguna saat ini.

      • INSTALLER_PATH: Jalur ke file penginstal Anda dalam WAB. Jalur ini dapat berupa absolut atau relatif ke direktori induk konfigurasi publikasi Play. Contoh, path\to\test\installer. Jangan lupa untuk menggunakan authenticode dan penandatanganan kode untuk menandatangani file yang dapat dieksekusi penginstal game Anda.

      • UNIQUE_REGISTRY_PATH: Kunci root yang akan berisi semua informasi registri Anda. Nama ini harus unik di seluruh komputer pengguna. Ini akan menjadi jalur relatif di atas HKLM. Misalnya, SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\YourUniqueName. Entri ini akan membuat kunci root di HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName pada komputer Windows 11 64-bit.

      • LAUNCHER_REQUIRES_ELEVATION: Menunjukkan apakah peluncur atau file game yang dapat dieksekusi perlu dijalankan sebagai Administrator setiap kali diluncurkan.

        • "true": Jalankan file yang dapat dieksekusi sebagai Administrator.
        • "false": Jalankan file yang dapat dieksekusi sebagai pengguna saat ini.

      • RELATIVE_PATH_TO_LAUNCHER_EXE: Jalur ke peluncur atau file game yang dapat dieksekusi dalam direktori penginstalan. Ini harus menyertakan nama file yang dapat dieksekusi game atau peluncur Anda. Misalnya, jika file game atau peluncur Anda bernama mygame.exe dan terletak di {INSTALL_DIR}\Resources\mygame.exe, Anda harus memasukkan Resources\mygame.exe

      • LAUNCHER_ARGS_IF_ANY: Argumen command line apa pun yang perlu diteruskan ke peluncur atau game Anda. Entri ini bersifat opsional.

        • Jika ada beberapa argumen yang terkait dengan file yang dapat dieksekusi, argumen tersebut harus dipisahkan dengan spasi.
        • Argumen harus diawali dengan '--' atau '-', jika diperlukan oleh file yang dapat dieksekusi.

      • UNINSTALLER_REQUIRES_ELEVATION: Menunjukkan apakah file yang dapat dieksekusi program uninstaller perlu dijalankan sebagai Administrator untuk menyelesaikan proses uninstal.

        • "true": Jalankan file yang dapat dieksekusi sebagai Administrator.
        • "false": Jalankan file yang dapat dieksekusi sebagai pengguna saat ini.

    Contoh file konfigurasi publikasi Play

    Pertimbangkan game bernama MyGame, dengan penginstal game game_installer.exe, peluncur game launcher.exe. Contoh ini juga menunjukkan cara menggunakan CDATA. Berikut adalah tampilan 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. Jalankan alat publikasi Play di command line Windows atau Powershell.

    playpublishingtool.exe build-installer-bundle --input=PLAY_PUBLISHING_CONFIG_PATH --output=WAB_OUTPUT_PATH

    Untuk menimpa file WAB yang ada dengan nama yang sama, gunakan argumen --force.

    playpublishingtool.exe build-installer-bundle --input=PLAY_PUBLISHING_CONFIG_PATH --output=WAB_OUTPUT_PATH --force

    Ganti kode berikut:

    • PLAY_PUBLISHING_CONFIG_PATH: Jalur ke konfigurasi publikasi Play. Misalnya, path\to\play_publishing_config.xml.
    • WAB_OUTPUT_PATH: Jalur ke file WAB. Misalnya, path\to\output_bundle.wab.

    Cara menggunakan alat publikasi Play

    Anggap saja Anda memiliki biner alat publikasi Play playpublishingtool.exe, konfigurasi publikasi Play play_publishing_config.xml, dan penginstal game game_installer.exe di direktori kerja saat ini.

    Direktori kerja Anda saat ini akan terlihat seperti ini:

    .\
├── game_installer.exe
├── play_publishing_config.xml
├── playpublishingtool.exe

    Untuk membuat WAB dengan nama, misalnya, installer_bundle.wab di direktori yang sama, perintahnya akan terlihat seperti:

    playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab

    Dengan argumen --force, perintahnya akan terlihat seperti:

    playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab --force

    Jika berhasil, Anda akan melihat output yang mirip dengan berikut ini:

    Successfully built the installer bundle at installer_bundle.wab

    Temukan file WAB di folder:

      .\
  ├── game_installer.exe
  ├── installer_bundle.wab
  ├── play_publishing_config.xml
  ├── playpublishingtool.exe

Memublikasikan game menggunakan Konsol Play

Setelah berhasil membuat WAB untuk game, upload ke Konsol Play dan kelola setelan serta persyaratannya. Ikuti langkah-langkah untuk memublikasikan game Anda:

Menambahkan faktor bentuk Google Play Game di PC

Langkah ini hanya diperlukan saat Anda memublikasikan game untuk pertama kalinya.

  1. Di Konsol Play pada menu kiri, pilih Pengujian dan rilis > Penyiapan > Setelan lanjutan (link langsung).

  2. Buka tab Faktor bentuk, lalu tambahkan Google Play Games on PC dari menu drop-down + Tambahkan faktor bentuk.

  3. Klik tombol Kelola yang sesuai dengan faktor bentuk Google Play Game di PC di sisi kanan.

  4. Pilih opsi Gunakan jalur khusus untuk game app bundle Windows Anda.

  5. Klik Simpan, lalu Simpan lagi pada dialog konfirmasi.

Mengaktifkan Publikasi Terkelola

Untuk mengaktifkan Penerbitan terkelola, ikuti langkah-langkah berikut.

  1. Di halaman Ringkasan Publikasi, di bagian Publikasi Terkelola, klik Aktifkan Publikasi Terkelola.
  2. Dialog akan muncul. Beralih ke Publikasi terkelola aktif untuk jalur.
  3. Klik Simpan.

Upload file WAB

Untuk mengupload file WAB, ikuti langkah-langkah berikut:

  1. Di Konsol Play pada menu kiri, pilih Pengujian dan rilis > Setelan lanjutan (link langsung).
  2. Di halaman Setelan lanjutan, klik tab Faktor bentuk.
  3. Di tab Faktor bentuk, klik + Tambahkan faktor bentuk, lalu pilih Google Play Game di PC untuk ditambahkan.
  4. Di bagian Google Play Game di PC, klik Kelola.
  5. Pilih Gunakan jalur khusus untuk game app bundle Windows Anda.
  6. Klik Simpan.
  7. Di Konsol Play pada menu kiri, pilih Uji dan rilis > Produksi (link langsung).
  8. Di halaman Produksi, pilih Khusus Google Play Game di PC (Windows) dari drop-down faktor bentuk.
  9. Di tab Windows app bundle, klik Edit lalu upload file WAB.

Mengonfigurasi persyaratan PC Windows

Untuk mengonfigurasi persyaratan PC Windows:

  1. Di Konsol Play pada menu kiri, pilih Mendorong pertumbuhan pengguna > Keberadaan di Store > Setelan Store (link langsung).
  2. Di bagian Persyaratan PC, klik tombol Edit di sisi kanan.
  3. Perbarui kolom, lalu klik Simpan.

Mengonfigurasi grafis pembelian dalam aplikasi

Ini adalah langkah opsional. Untuk mengonfigurasi grafis pembelian dalam aplikasi:

  1. Di Konsol Play pada menu kiri, pilih Kembangkan pengguna > Keberadaan di Store > Listingan Play Store(link langsung).
  2. Di bagian Listingan Play Store default di tab Listingan, klik tombol -> (panah) di sisi kanan. Tindakan ini akan mengarahkan Anda ke halaman Listingan Play Store default.
  3. Buka bagian Google Play Game di PC dan upload gambar di Gambar pembelian dalam aplikasi Google Play Game di PC (Windows).
  4. Klik Simpan.

Kirim perubahan untuk ditinjau

  1. Di Konsol Play pada menu kiri, pilih Ringkasan publikasi.
  2. Di bagian Perubahan belum dikirim untuk ditinjau, klik Kirim perubahan untuk ditinjau.

Setelah tim Peninjauan menyetujui perubahan Anda, game Anda akan dapat ditemukan di Google Play.