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ışında, oyunun yükleme, güncelleme ve kaldırma işlemlerini sağladığınız oyun yükleyici yönetmelidir.

Başlamadan önce

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

Oyununuzu WAB dosyası olarak paketleme

PC Üzerinde Google Play Games, oyununuzun yükleyicisinin Google Play Console'a Windows uygulama paketi grubu (WAB) dosyası olarak yüklenmesini gerektirir. 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 acceptsCommandLineArguments=ACCEPTS_COMMAND_LINE_ARGUMENTS>
        <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ğıdakini 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 uygun olmalı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'ler arasında benzersiz olmalıdır. Örneğin: 1.0, 1.0.1-beta, 2025.11.24, v1.rc1.

      • INSTALLER_REQUIRES_ELEVATION: Yükleme işlemini tamamlamak 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ır.
      • ACCEPTS_COMMAND_LINE_ARGUMENTS: Yükleyicinin, otomatik oynatma özelliğini etkinleştirmek için komut satırı bağımsız değişkenlerini kabul edip edemeyeceğini belirten bir Boole değeri. Bu isteğe bağlıdır ve varsayılan değer false'tur. Daha fazla bilgi için Otomatik Oynatmayı Etkinleştirme başlıklı makaleyi inceleyin.

      • INSTALLER_PATH: WAB'deki yükleyici dosyanızın yolu. Bu yol, Play yayınlama yapılandırmasının ana 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.

      • <installation-path-registry-location>: Google Play Games'in, oyunun yüklü olup olmadığını tespit etmek için kullandığı kayıt defteri yolu. Oyununuz özel bir başlatıcı kullansa bile bu yol, başlatıcının kayıt defteri anahtarını değil, oyunun benzersiz kayıt defteri anahtarını göstermelidir.

      • UNIQUE_REGISTRY_PATH: Windows kayıt defteri anahtar yolu. Bu yol, HKEY_LOCAL_MACHINE veya HKEY_CURRENT_USER gibi bir kayıt defteri kovanına göre sağlanmalıdır. Yol dizesine kovan adını eklemeyin. Örneğin, yükleyiciniz HKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName dizinine yazıyorsa yalnızca Software\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName değerini belirtin. PC Üzerinde Google Play Games, bu yolu önce HKEY_LOCAL_MACHINE, ardından HKEY_CURRENT_USER içinde arar ve bulduğu ilk eşleşen değeri kullanır.

        INSTALLER_PATH içinde belirtilen yürütülebilir dosya bu kayıt defteri anahtarlarını oluşturmalıdır. Yükleme tamamlanmadan önce installation-path-registry-location, launch-path-registry-location ve uninstall-path-registry-location altında belirtilen bu kayıt defteri anahtarı ve değer adı çiftlerinin oluşturulması gerekir. Örnekte InstallLocation ve UninstallString kullanılmış olsa da yükleyiciniz üçü için de karşılık gelen kayıt defteri girişleri oluşturduğu sürece bu <value-name> etiketlerinde herhangi bir ad belirtebilirsiniz. PC Üzerinde Google Play Games, oyunu başlatmak ve kaldırmak için bu değerleri kullanır. Oyununuzda başlatıcı kullanılıyorsa launch-path-registry-location tarafından belirtilen kayıt defteri girişindeki değer, başlatıcının dizinine işaret etmelidir (installation-path-registry-location ise başlatıcının kayıt defteri anahtarına değil, oyunun benzersiz kayıt defteri anahtarına işaret etmelidir).

        Bu yol, kullanıcının makinesinde benzersiz olmalıdır. Örneğin: SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName.

        Oyun yükleyiciniz 64 bit Windows'ta çalışan 32 bit bir uygulamaysa Windows, kayıt defteri girişlerini HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node altına yazmak için kayıt defteri yönlendirmesini kullanır. Örneğin, HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName dizinine yazma işlemi HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueName dizinine yönlendirilir.

      • 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ır.
      • 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ı veya oyunun yürütülebilir dosya adını içermelidir. Örneğin, başlatıcınızın veya oyun dosyanızın adı mygame.exe ise ve {INSTALL_DIR}\Resources\mygame.exe konumunda bulunuyorsa Resources\mygame.exe yazmanız gerekir.

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

        • Yürütülebilir bir dosyayla ilişkili birden fazla bağımsız değişken varsa bunların boşlukla ayrılması gerekir.
        • Yürütülebilir dosya için gerekliyse bağımsız değişkenlerin önüne "--" veya "-" eklenmelidir.
      • UNINSTALLER_REQUIRES_ELEVATION: Kaldırma işlemini tamamlamak için kaldırma 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ır.

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

    Oyun yükleyicisi game_installer.exe ve oyun başlatıcısı launcher.exe olan MyGame adlı bir oyunu ele alalım. Örnekte CDATA'nın nasıl kullanılacağı da gösterilmektedir. play_publishing_config.xml şu şekilde görünecek:

    <?xml version="1.0" encoding="UTF-8"?>
    
    <play-publishing-config version="1.0">
      <application>
        <!-- The package name for your game. -->
        <package-name>com.mycompany.mygame</package-name>
        <!-- The game's version string. -->
        <version-name>1.0.0</version-name>
      </application>
      <!-- If requiresElevation is "true", installer runs as Administrator
           and a UAC prompt is displayed. This is required for system-wide
           installs (e.g., to Program Files) or writing to HKLM. -->
      <!-- If acceptsCommandLineArguments is "true", the installer must
           be able to accept command-line arguments to enable the auto-play
           feature. -->
      <installer requiresElevation="true" acceptsCommandLineArguments="true">
        <!-- Path to your installer executable. -->
        <path>game_installer.exe</path>
        <!-- The registry location where the installer writes the installation path. -->
        <installation-path-registry-location>
          <!-- Registry key path (typically under HKLM or HKCU).
               game_installer.exe MUST create this key. -->
          <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey</key-name>
          <!-- game_installer.exe, specified in <path>, creates the registry
               value called 'InstallLocation' within
               SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey
               by the time it exits. -->
          <value-name>InstallLocation</value-name>
        </installation-path-registry-location>
      </installer>
    
      <!-- If requiresElevation is "true", launcher runs as Administrator
           and a UAC prompt is displayed on every game launch. -->
      <launcher requiresElevation="true">
        <!-- Specifies the registry location where Google Play Games reads the installation path
             in order to launch the game. -->
        <launch-path-registry-location >
          <!-- Registry key path (typically under HKLM or HKCU) where
               the launch path can be found. -->
          <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey</key-name>
          <!-- Google Play Games reads the installation directory from this
               registry value, for example InstallLocation, to launch the game. -->
          <value-name>InstallLocation</value-name>
        </launch-path-registry-location>
        <executable-invocation>
          <!-- Game executable or launcher filename, relative to the
               directory path specified in the InstallLocation registry value. -->
          <filename>launcher.exe</filename>
          <!-- Optional arguments to pass to the executable.
               CDATA is used here to avoid issues with special characters
               like & or >. -->
          <arguments><![CDATA[arg1&arg2>arg3]]></arguments>
        </executable-invocation>
      </launcher>
    
      <!-- If requiresElevation is "true", uninstaller runs as
           Administrator and a UAC prompt is displayed for uninstall. -->
      <uninstaller requiresElevation="true">
        <!-- Registry key where Google Play Games finds the
             uninstallation command. -->
        <uninstall-path-registry-location>
          <!-- Registry key path (typically under HKLM or HKCU) where
               uninstall command can be found. -->
          <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey</key-name>
          <!-- game_installer.exe also creates the registry value, for example, 'UninstallString'
               within SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\MySystemWideUniqueKey,
               containing the command Google Play Games executes to uninstall
               the game. -->
          <value-name>UninstallString</value-name>
        </uninstall-path-registry-location>
      </uninstaller>
    </play-publishing-config>
    
  3. Windows komut satırında veya PowerShell'de Play yayınlama aracını ç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ğıdakini 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.

    Google Play yayınlama aracını kullanma

    Mevcut çalışma dizininde Google Play yayınlama aracı ikili programı playpublishingtool.exe, Google Play yayınlama yapılandırması play_publishing_config.xml ve oyun yükleyiciniz game_installer.exe olduğ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 olur:

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

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

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

    İşlem başarılı olursa aşağıdakine benzer bir çıkış görürsünüz:

    Successfully built the installer bundle at installer_bundle.wab
    

    Klasörde WAB dosyasını bulun:

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

    PC'de yerel olarak çalışan oyunlarınız yüklendiğinde otomatik oynatmayı etkinleştirme (isteğe bağlı)

    PC Üzerinde Google Play Games'de "otomatik oynatma" özelliğini etkinleştirebilirsiniz. Bu özellik, yükleme işlemi tamamlandıktan hemen sonra oyununuzu otomatik olarak başlatır. Bu özellik, oyuncuyu doğrudan oyuna geçirerek sorunsuz bir kullanıcı deneyimi sağlar ve PC Üzerinde Google Play Games ekosisteminde tam kimlik doğrulaması sunar.

    İşleyiş şekli

    Bu özelliği etkinleştirdiğinizde PC Üzerinde Google Play Games, komut satırı bağımsız değişkenlerini kullanarak üçüncü taraf (3P) yükleyici işleminize bir oturum jetonu iletir. Ardından yükleyiciniz, bu jetonu ayıklayıp kimlik doğrulama bağlamında oyunun yürütülebilir dosyasını başlatmak için kullanır.

    Ön koşullar

    Bu özelliği kullanmak için 3. taraf yükleyicinizin komut satırı bağımsız değişkenlerini işleyebilmesi gerekir.

    Uygulama Adımları

    1. Play Yayınlama Yapılandırması'nda Otomatik Oynatmayı Etkinleştirme

      Bu özelliği etkinleştirmek için play_publishing_config.xml dosyanızdaki <installer> öğesine acceptsCommandLineArguments özelliğini ekleyin.

      play_publishing_config.xml içeriğinden alıntı örneği:

           <installer requiresElevation="true" acceptsCommandLineArguments="true">
              <path>path/to/installer.exe</path>
              <installation-path-registry-location>
                <key-name>SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\key</key-name>
                <value-name>InstallPath</value-name>
              </installation-path-registry-location>
           </installer>
      • Özellik: acceptsCommandLineArguments
      • Tür: Boolean
      • Varsayılan: false
      • Davranış: Bu değeri "true" olarak ayarladığınızda GPG, yükleyicinizi çalıştırırken oturum jetonunu komut satırı bağımsız değişkenlerine ekler.
    2. Yükleyicinizde oturum jetonunu işleme

      Yükleyiciniz GPG istemcisi tarafından başlatıldığında oturum jetonunu komut satırı bağımsız değişkeni olarak alır.

      • Bağımsız değişken biçimi: --g_session_token=<TOKEN>

      Yapmanız gerekenler:

      • Ayıklama: Jeton dizesini almak için yükleyicinizin komut satırı bağımsız değişkenlerini ayrıştırması gerekir.
      • Yayılma: Yükleme akışınızda ikincil bir başlatıcı veya oyun işlemi başlatılıyorsa yükleyiciniz, oturum jetonunu SDK'yı kullanan son oyun işlemine güvenli bir şekilde iletmekten sorumludur.
      • Başlatma: Oyunun yürütülebilir dosyasını başlatmak için sağlanan oturum jetonunu kullanın. Bu sayede oyun, kimliği doğrulanmış bir GPG bağlamında çalışır. Aksi takdirde InitializeSDK başarısız olur ve oyuncunuzun oyununuzu yeniden başlatması gerekir.
    3. Hata İşleme ve Yedekler

      • Jeton alma: GPG herhangi bir nedenle oturum jetonu oluşturamaz veya iletemezse (ör. jeton oluşturma hatası) yükleme işlemi devam eder. Ancak yükleyiciniz --g_session_token bağımsız değişkeni olmadan başlatılır.
      • Sağlamlık: Yükleyiciniz, oturum jetonunun bulunmadığı senaryoları işleyecek şekilde tasarlanmalıdır. Bu gibi durumlarda yükleyici standart bir yükleme işlemi gerçekleştirmelidir. InitializeSDK başarısız olacağı için otomatik oyun başlatma işlemini tetiklememelisiniz.
      • Yükleyici Hataları: Yükleyicinizin ve başlattığı oyun başlatma sırasının sağlamlığından ve hata yönetiminden siz sorumlusunuz. GPG, başlatıldıktan sonra yükleyicide gerçekleşen işlemler üzerinde kontrol sahibi değildir.

Google Play Console'u kullanarak oyunu 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 + Yeni form faktörü ekle açılır menüsünden Google Play Games on PC ekleyin.

  3. Sağ taraftaki 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 tıklayın ve ardından onay iletişim kutusunda tekrar Kaydet'i tıklayın.

Yönetilen yayınlamayı etkinleştirme

Yönetilen yayınlamayı 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 görüntülenir. Kanal için Yönetilen yayınlama açık'a geçin.
  3. Kaydet'i tıklayın.

WAB dosyasını yükleme

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. Google Play Console'un sol menüsünde Yayınlama özeti'ni 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 hale gelir.