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:
Play yayınlama aracını indirin. Bu aracı Windows komut satırında veya PowerShell'de çalıştırabilirsiniz.
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_MACHINEveyaHKEY_CURRENT_USERgibi bir kayıt defteri kovanına göre sağlanmalıdır. Yol dizesine kovan adını eklemeyin. Örneğin, yükleyicinizHKEY_LOCAL_MACHINE\Software\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueNamedizinine yazıyorsa yalnızcaSoftware\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueNamedeğerini belirtin. PC Üzerinde Google Play Games, bu yolu önceHKEY_LOCAL_MACHINE, ardındanHKEY_CURRENT_USERiçinde arar ve bulduğu ilk eşleşen değeri kullanır.
Bu yol, kullanıcının makinesinde benzersiz olmalıdır. Örneğin:INSTALLER_PATHiçinde belirtilen yürütülebilir dosya bu kayıt defteri anahtarlarını oluşturmalıdır. Yükleme tamamlanmadan önceinstallation-path-registry-location,launch-path-registry-locationveuninstall-path-registry-locationaltında belirtilen bu kayıt defteri anahtarı ve değer adı çiftlerinin oluşturulması gerekir. ÖrnekteInstallLocationveUninstallStringkullanı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ıyorsalaunch-path-registry-locationtarafından belirtilen kayıt defteri girişindeki değer, başlatıcının dizinine işaret etmelidir (installation-path-registry-locationise başlatıcının kayıt defteri anahtarına değil, oyunun benzersiz kayıt defteri anahtarına işaret etmelidir).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\WOW6432Nodealtına yazmak için kayıt defteri yönlendirmesini kullanır. Örneğin,HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueNamedizinine yazma işlemiHKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\YourUniqueNamedizinine 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.exeve oyun başlatıcısılauncher.exeolanMyGameadlı 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>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
--forcebağı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.xmlve oyun yükleyicinizgame_installer.exeolduğ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.wabadlı bir WAB oluşturmak için komut şu şekilde olur:playpublishingtool.exe build-installer-bundle --input=play_publishing_config.xml --output=installer_bundle.wab
--forcebağı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ı
Play Yayınlama Yapılandırması'nda Otomatik Oynatmayı Etkinleştirme
Bu özelliği etkinleştirmek için
play_publishing_config.xmldosyanızdaki<installer>öğesineacceptsCommandLineArgumentsözelliğini ekleyin.play_publishing_config.xmliç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.
- Özellik:
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.
- Bağımsız değişken biçimi:
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_tokenbağı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.
- 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
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.
- Play Console'da soldaki menüden Test etme ve yayınlama > Kurulum > Gelişmiş ayarlar'ı (doğrudan bağlantı) seçin.
Form faktörleri sekmesine gidin ve + Yeni form faktörü ekle açılır menüsünden
Google Play Games on PCekleyin.Sağ taraftaki PC Üzerinde Google Play Games form faktörüne karşılık gelen Yönet düğmesini tıklayın.
Windows uygulama paketi oyunum için özel kanal kullan seçeneğini belirleyin.
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.
- Yayınlama Özeti sayfasındaki Yönetilen Yayınlama bölümünde Yönetilen Yayınlamayı Etkinleştir'i tıklayın.
- Bir iletişim kutusu görüntülenir. Kanal için Yönetilen yayınlama açık'a geçin.
- Kaydet'i tıklayın.
WAB dosyasını yükleme
WAB dosyasını yüklemek için aşağıdaki adımları uygulayın:
- Play Console'da soldaki menüden Test etme ve yayınlama > Gelişmiş ayarlar'ı (doğrudan bağlantı) seçin.
- Gelişmiş ayarlar sayfasında Form faktörleri sekmesini tıklayın.
- Form faktörleri sekmesinde + Form faktörü ekle'yi tıklayın ve eklemek için PC Üzerinde Google Play Games'i seçin.
- PC Üzerinde Google Play Games bölümünde Yönet'i tıklayın.
- Windows uygulama paketi oyunum için özel kanal kullan'ı seçin.
- Kaydet'i tıklayın.
- Play Console'da soldaki menüden Test etme ve yayınlama > Üretim'i (doğrudan bağlantı) seçin.
- Üretim sayfasında, form faktörü açılır listesinden Yalnızca PC Üzerinde Google Play Games (Windows)'u seçin.
- 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:
- 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.
- PC gereksinimleri bölümünde, sağ taraftaki Düzenle düğmesini tıklayın.
- 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:
- 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.
- 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.
- 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.
- Kaydet'i tıklayın.
Değişikliği incelemeye gönderme
- Google Play Console'un sol menüsünde Yayınlama özeti'ni seçin.
- 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.