Yükleyici Yayınlama

Bu belgede, oyun yükleyicinizi kullanarak oyununuzu PC Üzerinde Google Play Games'de nasıl yayınlayacağınız açıklanmaktadır.

Geliştirici tarafından yüklenen akışta, sağladığınız oyun yükleyicisi oyunun yüklenmesini, güncellenmesini ve kaldırılmasını yönetmelidir.

Başlamadan önce

Google Play Games SDK'sını oyununuza entegre edin.

Oyununuzu WAB dosyası olarak paketleme

PC Üzerinde Google Play Games'de oyununuzun yükleyicisinin, Google Play Console'a Windows uygulama paketi (WAB) dosyası olarak yüklenmesi gerekir. WAB dosyası oluşturmak için aşağıdaki adımları uygulayın:

  1. Play yayınlama aracını indirin. Bu aracı Windows komut satırında veya PowerShell'de çalıştırabilirsiniz.

  2. Herhangi bir adla Play yayınlama yapılandırma dosyasını oluşturun. Örneğin, aşağıdaki biçimde play_publishing_config.xml:

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

    Aşağıdakileri değiştirin:

    • PACKAGE_NAME: Oyununuzun paket adı. Bu, Google Play'de oyununuzla ilişkilendirilecek benzersiz tanımlayıcıdır. Örneğin, com.yourcompany.yourgame. Paket adı aşağıdaki kurallara uymalıdır:
      • En az iki segment (bir veya daha fazla nokta) içermelidir.
      • Her segment bir harfle başlamalıdır.
      • Tüm karakterler alfanümerik veya alt çizgi ([a-zA-Z0-9_]) olmalıdır.

    • VERSION_NAME: Oyunun sürüm dizesi. Bu, rastgele bir dize olabilir ancak oyununuz için yüklenen tüm WAB'lerde benzersiz olmalıdır. Örneğin: 1.0, 1.0.1-beta, 2025.11.24, v1.rc1.

      • INSTALLER_REQUIRES_ELEVATION: Yükleme işleminin tamamlanması için yükleyici yürütülebilir dosyasının yönetici olarak çalıştırılması gerekip gerekmediğini gösterir.

        • "true": Yürütülebilir dosyayı yönetici olarak çalıştırın.
        • "false": Yürütülebilir dosyayı mevcut kullanıcı olarak çalıştırın.

      • INSTALLER_PATH: WAB'deki yükleyici dosyanızın yolu. Bu yol, Play yayınlama yapılandırmasının üst dizinine göre mutlak veya göreli olabilir. Örneğin, path\to\test\installer. Oyununuzun yükleyici yürütülebilir dosyasını imzalamak için authenticode ve kod imzalama özelliğini kullanmayı unutmayın.

      • UNIQUE_REGISTRY_PATH: Tüm kayıt defteri bilgilerinizi içeren kök anahtar. Kullanıcının makinesinde benzersiz olmalıdır. Bu, HKLM'nin üzerindeki göreli yol olur. Örneğin, SOFTWARE\\Microsoft\\Windows\\CurrentVersion\\Uninstall\\YourUniqueName. Bu giriş, 64 bit Windows 11 makinesinde HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName altında bir kök anahtar oluşturur.

      • LAUNCHER_REQUIRES_ELEVATION: Başlatıcı veya oyun yürütülebilir dosyasının her başlatıldığında yönetici olarak çalıştırılması gerekip gerekmediğini gösterir.

        • "true": Yürütülebilir dosyayı yönetici olarak çalıştırın.
        • "false": Yürütülebilir dosyayı mevcut kullanıcı olarak çalıştırın.

      • RELATIVE_PATH_TO_LAUNCHER_EXE: Yükleme dizinindeki başlatıcı veya oyun yürütülebilir dosyanızın yolu. Bu, başlatıcınızın veya oyununuzun yürütülebilir dosya adını içermelidir. Örneğin, başlatıcı veya oyun dosyanızın adı mygame.exe ise ve {INSTALL_DIR}\Resources\mygame.exe altında bulunuyorsa Resources\mygame.exe yazmanız gerekir.

      • LAUNCHER_ARGS_IF_ANY: Başlatıcınıza veya oyununuza iletilmesi gereken tüm komut satırı bağımsız değişkenleri. Bu giriş isteğe bağlıdır.

        • Bir yürütülebilir dosyayla ilişkili birden fazla bağımsız değişken varsa bunlar boşlukla ayrılmalıdır.
        • Yürütülebilir dosya gerektiriyorsa bağımsız değişkenlerin başına "--" veya "-" eklenmelidir.

      • UNINSTALLER_REQUIRES_ELEVATION: Kaldırma işleminin tamamlanması için kaldırma programı yürütülebilir dosyasının yönetici olarak çalıştırılması gerekip gerekmediğini gösterir.

        • "true": Yürütülebilir dosyayı yönetici olarak çalıştırın.
        • "false": Yürütülebilir dosyayı mevcut kullanıcı olarak çalıştırın.

    Örnek Play yayınlama yapılandırma dosyası

    MyGame adlı bir oyunu ele alalım. Oyun yükleyicisi game_installer.exe, oyunun başlatıcısı launcher.exe. Örnekte CDATA'nın nasıl kullanılacağı da gösterilmektedir. play_publishing_config.xml simgesi aşağıdaki gibi görünür:

    <?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. Play yayınlama aracını Windows komut satırında veya PowerShell'de çalıştırın.

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

    Aynı ada sahip mevcut bir WAB dosyasının üzerine yazmak için --force bağımsız değişkenini kullanın.

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

    Aşağıdakileri değiştirin:

    • PLAY_PUBLISHING_CONFIG_PATH: Play yayınlama yapılandırmasının yolu. Örneğin, path\to\play_publishing_config.xml.
    • WAB_OUTPUT_PATH: WAB dosyasının yolu. Örneğin, path\to\output_bundle.wab.

    Play yayınlama aracını kullanma

    Mevcut çalışma dizininde Play yayınlama aracı ikilisi playpublishingtool.exe, Play yayınlama yapılandırması play_publishing_config.xml ve oyun yükleyicinizin game_installer.exe bulunduğunu varsayalım.

    Mevcut çalışma dizininiz aşağıdaki gibi görünmelidir:

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

    Aynı dizinde installer_bundle.wab adlı bir WAB oluşturmak için komut şu şekilde görünür:

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

    --force bağımsız değişkeniyle komut şöyle görünür:

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

    İşlem başarılı olduğunda şuna benzer bir çıkış alırsınız:

    Successfully built the installer bundle at installer_bundle.wab

    WAB dosyasını şu klasörde bulabilirsiniz:

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

Oyunu Play Console'u kullanarak yayınlama

Oyununuz için WAB'yi başarıyla oluşturduktan sonra Play Console'a yükleyin, ayarlarını ve şartlarını yönetin. Oyununuzu yayınlamak için aşağıdaki adımları uygulayın:

PC Üzerinde Google Play Games form faktörünü ekleme

Bu adım yalnızca bir oyunu ilk kez yayınladığınızda gereklidir.

  1. Play Console'da soldaki menüden Test etme ve yayınlama > Kurulum > Gelişmiş ayarlar'ı (doğrudan bağlantı) seçin.

  2. Form faktörleri sekmesine gidin ve + Form faktörü ekle açılır listesinden Google Play Games on PC simgesini ekleyin.

  3. Sağ tarafta PC Üzerinde Google Play Games form faktörüne karşılık gelen Yönet düğmesini tıklayın.

  4. Windows uygulama paketi oyunum için özel kanal kullan seçeneğini belirleyin.

  5. Kaydet'i ve ardından onay iletişim kutusunda tekrar Kaydet'i tıklayın.

Yönetilen yayınlamayı etkinleştirme

Yönetilen yayınlama özelliğini etkinleştirmek için aşağıdaki adımları uygulayın.

  1. Yayınlama Özeti sayfasındaki Yönetilen Yayınlama bölümünde Yönetilen Yayınlamayı Etkinleştir'i tıklayın.
  2. Bir iletişim kutusu açılır. Kanal için Yönetilen yayınlama etkin'e geçin.
  3. Kaydet'i tıklayın.

WAB dosyasını yükleyin.

WAB dosyasını yüklemek için aşağıdaki adımları uygulayın:

  1. Play Console'da soldaki menüden Test etme ve yayınlama > Gelişmiş ayarlar'ı (doğrudan bağlantı) seçin.
  2. Gelişmiş ayarlar sayfasında Form faktörleri sekmesini tıklayın.
  3. Form faktörleri sekmesinde + Form faktörü ekle'yi tıklayın ve eklemek için PC Üzerinde Google Play Games'i seçin.
  4. PC Üzerinde Google Play Games bölümünde Yönet'i tıklayın.
  5. Windows uygulama paketi oyunum için özel kanal kullan'ı seçin.
  6. Kaydet'i tıklayın.
  7. Play Console'da soldaki menüden Test etme ve yayınlama > Üretim'i (doğrudan bağlantı) seçin.
  8. Üretim sayfasında, form faktörü açılır listesinden Yalnızca PC Üzerinde Google Play Games (Windows)'u seçin.
  9. Windows uygulama paketi sekmesinde Düzenle'yi tıklayın ve WAB dosyasını yükleyin.

Windows PC gereksinimlerini yapılandırma

Windows PC gereksinimlerini yapılandırmak için:

  1. Play Console'da soldaki menüden Kullanıcı sayısını artırma > Play Store'daki varlığı > Mağaza ayarları'nı (doğrudan bağlantı) seçin.
  2. PC gereksinimleri bölümünde, sağ taraftaki Düzenle düğmesini tıklayın.
  3. Alanları güncelleyin ve Kaydet'i tıklayın.

Uygulama içi satın alma grafiğini yapılandırma

Bu adım isteğe bağlıdır. Uygulama içi satın alma grafiğini yapılandırmak için:

  1. Play Console'da soldaki menüden Kullanıcı sayısını artırma > Play Store'daki varlığı > Mağaza girişleri'ni(doğrudan bağlantı) seçin.
  2. Girişler sekmesindeki Varsayılan mağaza girişi bölümünde sağ taraftaki -> (ok) düğmesini tıklayın. Bu işlem sizi varsayılan mağaza girişi sayfasına yönlendirir.
  3. PC Üzerinde Google Play Games bölümüne gidin ve resmi PC Üzerinde Google Play Games (Windows) uygulama içi satın alma grafiği bölümüne yükleyin.
  4. Kaydet'i tıklayın.

Değişikliği incelemeye gönderme

  1. Play Console'da soldaki menüden Yayınlamaya genel bakış'ı seçin.
  2. Henüz incelemeye gönderilmeyen değişiklikler bölümünde Değişiklikleri incelemeye gönder'i tıklayın.

İnceleme ekibi değişikliklerinizi onayladığında oyununuz Google Play'de keşfedilebilir.