PC Üzerinde Google Play Games Geliştirici Emülatörü ile geliştirme

PC Üzerinde Google Play Games Geliştirici Emülatörü, oyununuzun oyun PC Üzerinde Google Play Games Oynatıcı deneyiminden farklı olarak, kendi paketlerinizdeki hataları ayıklayın. Ayrıca çeşitli oynatıcı yapılandırmalarını simüle edebilirsiniz. ve grafik arka ucu gibi en boy oranı, fare emülasyonu ve grafik arka ucu gibi Oyununuzun çeşitli PC'lerde beklendiği gibi çalışmasını sağlayın yapılandırmanın üç yolu vardır.

Emülatörü Başlatma

Yükledikten sonra "Google Play Games Geliştirici Emülatörü"ne sahip olursunuz. başlangıç menü öğesi ve emülatörü başlatmak için bir masaüstü kısayolu. Emülatör pencereyi kapattığınızda sistem tepsinizde kalmaya devam eder.

Oturum açma

emülatörü kullanın. Geliştirme için kullanmayı planladığınız giriş kimlik bilgilerinin aynısını kullanın.

Sistem tepsisi simgesini sağ tıklayıp Geliştirici'yi seçerek oturumunuzu kapatabilirsiniz. Seçenekler'i ve ardından Oturumu kapatmaya zorla'yı tıklayın. Bu işlemi gerçekleştirdiğinizde emülatör hemen yeniden başlatılır ve tekrar oturum açmanızı ister.

Başlatıldıktan sonra tipik bir Android ana ekranı görürsünüz. Sol fare tıklamalar, fare emülasyon modunda olduğu gibi doğrudan parmak dokunuşlarına dönüştürülür. Geliştirme için başka cihazdan yüklenen oyunlar uygulama listesinde görünür. dokunarak yukarı doğru kaydırma hareketiyle (yukarı doğru kaydırma emülasyonu telefon veya tablet).

PC Üzerinde Google Play Games Geliştirici Emülatörü, fare çevirisinin yanı sıra gezinmeyi iyileştirmek için klavye kısayolları:

  • ctrl + h: ana sayfa düğmesine basın
  • ctrl + b: geri düğmesine basın
  • F11 veya alt + enter: Tam ekran ve pencereli mod
  • Üst Karakter + sekme: Aşağıdakiler dahil olmak üzere PC Üzerinde Google Play Games yer paylaşımını açın Giriş SDK'sı için geçerli tuş eşlemeleri
ziyaret edin.

Oyun yükleme

PC Üzerinde Google Play Games Geliştirici Emülatörü, şu işlemleri gerçekleştirmek için Android Debug Bridge (adb)'yi kullanır: yükleme paketidir.

adb uyumluluğu

adb uygulamasının mevcut sürümleri, PC Üzerinde Google Play Games Geliştirici Emülatörü ile uyumludur. Ayrıca, yüklediğinizde C:\Program Files\Google\Play Games Developer Emulator\current\emulator adresinde uyumlu bir sürüm yüklenir. emülatörde oluyor.

Bu talimatları uygulayabilmeniz için adb'nin $PATH içinde mevcut olması gerekir. Şunları yapabilirsiniz: adb devices komutuyla adb öğesinin doğru şekilde yapılandırıldığını doğrulayın

adb devices
List of devices attached
localhost:6520  device

Oyunu yükle

  • Google Play Games for PC Emulator uygulamasını başlat

  • Komut isteminize adb devices yazın. Aşağıdaki bilgileri görürsünüz:

    adb devices
List of devices attached
localhost:6520 device

  • Sorun Giderme:

    • Hata alırsanız Adb uyumluluk başlıklı makaleyi inceleyin.
    • Herhangi bir cihaz görmüyorsanız 6520 bağlantı noktası üzerinden yeniden bağlanmayı deneyin:
    adb connect localhost:6520

  • Oyununuzu yüklemek için adb install path\to\your\game.apk yazın. Şu anda bir Android App Bundle (aab) oluşturduysanız bundletool yerine bundletool install-apks kullanın.

  • Oyununuzu çalıştırmak için:

    • Oyununuzu çalıştırmak için adb shell monkey -p your.package.name 1 yazın. Oyununuzun paket adıyla your.package.name.
    • Oyununuzu çalıştırmak için PC Üzerinde Google Play Games Geliştirici Emülatörü'ndeki simgeyi tıklayın. Android telefonda olduğu gibi "yukarı kaydırma"nız gerekir evde ekranında yüklü oyunların listesini görebilir.

Oyunlarda hata ayıklama

Diğer oyunlarda yaptığınız gibi hata ayıklamak için Android Debug Bridge (adb) kullanın. Emülatör, localhost:6520 aracılığıyla bağlanan bir cihaz olarak görünür.

adb logcat ve düzeltme ya da filtrelemeye yardımcı olan araçlar beklendiği gibi çalışır logcat çıkışı (Android Studio dahil).

adb'a ek olarak, günlüklere şuradan da erişebilirsiniz: %LOCALAPPDATA%\Google\Play Games Developer Emulator\Logs dizini. En sık Buradaki AndroidSerial.log özelliği, adb logcat olan her şeyi temsil eder. olduğu andan itibaren yankı uyandırır.

Geliştirici ayarları

PC'de Google Play Games geliştirici emülatörü, gerçek hayattan ziyade geliştirici verimliliğine son kullanıcı deneyiminden daha yüksek olabilir. Bu, Google Analytics 4'e erişiminizi yerine standart Android başlatıcıyı kullanmayı da içeren Android sistemi PC Üzerinde Google Play Games deneyimi ve aksi takdirde, oyuncular için otomatik olarak etkinleştirilir ve devre dışı bırakılır.

Fare girişi test ediliyor

Geliştirme sırasında PC Üzerinde Google Play Games Geliştirici Emülatörü varsayılan olarak dokunmatiktir. emülasyonunu kullanabilirsiniz. Doğrudan fareyi etkinleştirebilirsiniz sistem tepsisi simgesini sağ tıklayıp Geliştirici Seçenekleri'ni seçerek ve ardından PC modu (KiwiMouse) özelliğini kullanın.

PC Üzerinde Google Play Games'de iki fare modu vardır: tek dokunuşla fare tıklaması ve "PC modu"nu geçirme bu ekranlar arası yerel olarak işlem yapabilir ve işaretçi yakalama işlemini gerçekleştirebilirsiniz. Fare girişiyle ilgili ayrıntılar için Fare girişini ayarlama konusuna bakın.

Oynatıcı istemcisinde emülasyon, manifest dosyanıza şunu ekleyerek devre dışı bırakılır:

<manifest ...>
  <uses-feature
      android:name="android.hardware.type.pc"
      android:required="false" />
  ...
</manifest>

Bu özellik işaretinin, geliştirme ortamı üzerinde bir etkisi yoktur.

En boy oranlarını test etme

Geliştirici emülatörü, oynatıcının aksine 16:9 en boy oranında başlatılır en boy oranını birincil görüntüden elde eden bir bülten. Sağ tarafta tıklayın, Geliştirici Seçenekleri'ni seçin ve ardından sırasıyla seçeneğini belirlerseniz oyunun nasıl göründüğünü test edebilirsiniz. karşılaştırabilirsiniz.

En boy oranınızı yapılandırmak için tercih edilen yöntem android:minAspectRatio ve android:maxAspectRatio kullanmaktır.

Örneğin, dikey oyunların en boy oranı 9/16 veya 0.5625 olduğundan Oyununuzun kareden daha geniş olmasını önlemek için maksimum 1 en boy oranını ayarlayın:

<activity android:maxAspectRatio="1">
 ...
</activity>

Benzer şekilde, yatay bir oyun 16/9 veya yaklaşık 1.778 olur. Bu nedenle kareden daha zayıf olmasını önlemek için 1 olacak minimum en boy oranını ayarlayın:

<activity android:minAspectRatio="1">
 ...
</activity>

Neleri test edebilirsiniz?

Oyununuz manifest dosyasında yalnızca dikey modları destekliyorsa 9:16'yı seçebilirsiniz. (Dikey) seçeneğini kullanabilirsiniz. PC'ler. Aksi halde Oyununuzun sunduğunuz en geniş ve en dar yatay yatay oranlarında çalıştığını doğrulayın özel destek için 16:9 (Varsayılan) (veya 9:16 (Dikey) oyununuz yalnızca dikeyse) tam sertifika.

Oluşturma arka uçlarını test etme

PC Üzerinde Google Play Games, şunları yapmak için uyumluluk katmanı olarak ANGLE'ı kullanır: OpenGL ES çağrılarının ana makine PC tarafından OpenGL veya Vulkan arka ucu. Emülatör ayrıca Vulkan'ı doğrudan destekliyor. OpenGL'de yoktur. Bu katman, yalnızca mobil cihazlardaki sıkıştırılmış doku biçimlerini de dönüştürür olarak ayarlayabilirsiniz. Sistem tepsisi simgesini sağ tıklayıp Grafik Yığını Geçersiz Kılma: Sisteminizin varsayılan değerine ayarlayabilir veya uyumluluk testi için vulkan'ı açık veya kapalı tutmaya zorlama.

Neleri test edebilirsiniz?

Desteklenen doku biçimlerinde küçük farklılıklar vardır ve Masaüstünde çeşitli mobil özellikleri emüle eder. Verilerinizin profilini çıkarırken her bir arka ucu kontrol etmeniz faydalı olabilir.

PC oyununuzun profilini oluşturma

Emülatör, tüketici istemcisiyle aynı teknolojiyi kullandığından uygun bir ortam sağlar.

Perfetto, Android'deki performansı analiz etmeye yönelik bir araçtır. Paydaşlarla toplantı yaparken aşağıdaki adımları uygulayarak Perfetto izlerini görüntüleyin:

  1. Bir Powershell isteminde adb kullanarak izleme başlatın

    adb shell perfetto --time 10s gfx wm sched --out /data/misc/perfetto-traces/example.trace
    1. --time işareti, toplanacak iz süresini belirtir.Burada iz 10 saniyedir.
    2. --time işaretinden sonraki bağımsız değişkenler, hangi etkinliklerin gerçekleştirileceğini gösterir. izler. Bu örnekte gfx grafikleri, wm pencere yönetimini ve sched işlem planlama bilgileri. Bunlar, profil çıkarmayla ilgili yaygın işaretlerdir oyunlar ve tam referans mevcuttur.
    3. --out işareti, sonraki adımda ana makineye ekleyebilirsiniz.

  2. İzi ana makinenizden alma

    adb pull /data/misc/perfetto-traces/example.trace $HOME/Downloads/example.trace

  3. Perfetto kullanıcı arayüzünde izlemeyi açın

    1. ui.perfetto.dev adresini açın.
    2. Gezinme'nin altında sol üst köşeden İzleme dosyasını aç'ı seçin.
    3. Önceki adımda indirdiğiniz example.trace dosyasını Downloads/ dizini.

  4. Perfetto kullanıcı arayüzünde izini inceleyin. Bazı ipuçları:

    1. Her işlemin kendi satırı vardır. Bu satır, tüm ileti dizilerini gösterecek şekilde genişletilebilir bahsedeceğiz. Bir oyunun profilini oluşturuyorsanız bu işlem büyük olasılıkla ilk satırı.
    2. Control tuşunu basılı tutup kaydırma çubuğunu kullanarak yakınlaştırabilir ve uzaklaştırabilirsiniz tekerlek.
    3. sched etkinliğini kullanırken, her ileti dizisi için çalışıyor, çalıştırılabilir, uyuyor veya engellenmiş durumda olur.
    4. gfx gibi bir etkinliği etkinleştirdiğinizde çeşitli çeşitli iş parçacıkları tarafından yapılan grafik çağrıları. Ayrı ayrı "dilimler" seçebilirsiniz - ne kadar sürdüğünü görebilirsiniz veya bir satır boyunca sürükleyerek "dilimlere" bölüm açıp kaplumbağadaki tüm dilimlerin ne kadar sürdüğünü gösterir. zaman aralığını seçin.

Grafik Profili Oluşturma

Bazı grafik profilleri oluşturmak için RenderDoc bilgilerini kullanarak bir dosya oluşturun.

  1. Ortam değişkenini ayarlama ANDROID_EMU_RENDERDOC değerini boş olmayan bir dizeye ("1" gibi) ekleyin.

  2. TMP ortam değişkenini şuna ayarlayın: %USERPROFILE%\AppData\LocalLow. Bu işlem, Renderdoc'a günlük dosyalarını yerleştirmesini söyler. içinde erişilebilir bir yere yerleştirilecek.

  3. Vulkan arka ucunu kullanıyorsanız. Seç Grafik Ayarları > Vulkan Örneği Örtülü Katmanlarını kullanın ve VKLAYER_RENDERDOC_Capture işaretli.

  4. PC Üzerinde Google Play Games Geliştirici Emülatörü'nü başlatın. Bir RenderDoc yer paylaşımı devam etmesi gerekir.

  5. RenderDoc'u, PC Üzerinde Google Play Games geliştirici emülatörü öncesinde veya sonrasında istediğiniz zaman başlatın lansman sonrasında gerçekleşebilir.

  6. Dosya > Çalışma Örneğine ekleyin ve crosvm'yi seçin.

Ortam Değişkenlerini Belirtin

Renderdoc'un çalışması için ortam değişkenleri eklemeniz veya değiştirmeniz gerekir seçeneğini tıklayın. Kullanıcı arayüzünü, Powerpoint'i veya cmd.exe.

Kullanıcı arayüzünü kullanma
  • Çalıştırma iletişim kutusunu açmak için Win+R tuşlarına basın.
  • Sistem Özellikleri penceresini açmak için sysdm.cpl yazın.
  • Zaten etkin değilse Gelişmiş sekmesini seçin.
  • Ortam Değişkenleri düğmesini tıklayın.

Buradan Yeni düğmesini tıklayarak yeni bir ortam oluşturabilirsiniz değişkenini seçin veya bir değişken seçip düzenlemek için Düzenle düğmesini tıklayın.

Powerpoint'i Kullanın

Bir TPU penceresine şunu yazın:

$Env:VARIABLE_NAME=VALUE

VARIABLE_NAME ve VALUE değerlerini ayarlamak istediğiniz değerlerle değiştirin. Örneğin, Örneğin, ANDROID_EMU_RENDERDOC değerini "1" türüne ayarlamak için:

$Env:ANDROID_EMU_RENDERDOC="1"
cmd.exe'yi kullanın

Bir cmd.exe penceresine şunu yazın:

set VARIABLE_NAME=VALUE

VARIABLE_NAME ve VALUE değerlerini ayarlamak istediğiniz değerlerle değiştirin. Örneğin, Örneğin, ANDROID_EMU_RENDERDOC değerini "1" türüne ayarlamak için:

set ANDROID_EMU_RENDERDOC="1"

Android 11 (API düzeyi 30) veya sonraki sürümler için ipuçları

PC Üzerinde Google Play Games en son Android sürümleriyle güncellendi. İşte Android'in son sürümüyle çalışmaya yönelik bazı ipuçları.

Araçları güncel tutun

Android Studio, adb'nin geliştiriciyle uyumlu bir sürümünü yüklüyor. emülatör; ancak bazı oyun motorları adb'nin eski bir sürümünü içerir. Bu geliştirici emülatörünü yükledikten sonra, geliştiricinizle uyumlu bir sürümü adb C:\Program Files\Google\Play Games Developer Emulator\current\emulator itibarıyla.

adb sürümlerinden birini başlatırsanız diğeri de sonlandırılır. Bunun anlamı, oyun motorunuz otomatik olarak kendi adb örneğini başlatırsa geliştiriciyle birlikte gelen adb sürümünü yeniden başlatıp yeniden bağlamak emülatörü kullanın.

Android App Bundle kullanıyorsanız uygulamanın en son sürümünü yüklemeniz gerekir GitHub deposundaki Bundletool.

Kapsamlı Depolama

Android 11 (API düzeyi 30) veya sonraki sürümler kapsamlı depolama alanı içerir. Harici depolama alanındaki uygulama ve kullanıcı verileri için daha iyi koruma. Paydaşlarla iletişime geçmenin kapsamlı depolama alanı gereksinimleriyle uyumlu oyunlar için: APK Genişletme Dosyaları (obb) veya öğe verilerini PC Üzerinde Google Play Games Geliştirici Emülatörü. Sorunla karşılaşırsanız aşağıdaki adımları uygulayın o dosyalara oyununuzdan erişerek:

  1. Uygulamanızın okuyabileceği bir dizin oluşturun.
  2. Genişletme dosyalarınızı emülatöre aktarın.
adb shell mkdir /sdcard/Android/obb/com.example.game
adb push main.com.example.game.obb /sdcard/Android/obb/com.example.game

Paket Görünürlüğü

Yeni paket görünürlüğü kuralları nedeniyle Android 11'i hedefleyen uygulamalar (API düzeyi 30) veya sonraki sürümlerin Cihazda yüklü diğer uygulamalar. Bu, oyununuzun engellendiği anlamına gelir yerine adb aracılığıyla başka cihazdan yüklendiğinde Play Hizmetleri'ne Google Play Store'dan yüklenir. IAP'nizi başka cihazdan yüklenmiş bir oyunla test etmek için "com.android.vending" paketine bir sorgu eklemeniz gerekiyor AndroidManifest.xml dosyası için aşağıdaki gibidir:

<manifest>
    <queries>
        <package android:name="com.android.vending" />
    </queries>
</manifest>

Oyununuzu tüketici istemcisine yükleme

Bir oyunu Play Oyun Hizmetleri kataloğu. Oyununuzun single sürümü yayınlandıktan sonra, gelecekteki güncellemeleri doğrulamak için dahili test kanalı oluşturabilir kontrol edin.

Oynatıcı istemcisi PC Üzerinde Google Play Games Geliştirici Emülatörü. Bu yöntem, oyunu yayınlamadan önce kalite kontrolü yapmak için en iyi seçenektir Bu testler, ilk sürümden sonra uçtan uca oyuncu deneyimini test etmek için tasarlanmıştır.