Oyun Döngüsü testlerini kullanmaya başlayın

Oyun uygulamaları farklı bir platform üzerinde oluşturulduğunda oyun testlerini otomatikleştirmek zor olabilir. Kullanıcı arayüzü çerçeveleri. Game Loop testleri, yerel testlerinizi Test Lab ile entegre etmenize ve seçtiğiniz cihazlarda kolayca çalıştırmanıza olanak tanır. Oyun Döngüsü testi oyun uygulamanızda test ederken gerçek bir oyuncunun eylemlerini simüle edin. Bu rehberinde, Oyun Döngüsü testinin nasıl çalıştırılacağı, ardından testinizi nasıl görüntüleyip yöneteceğiniz gösterilir. Firebase konsolunda gösterilir.

Oyun motorunuza bağlı olarak testleri bir veya daha fazla test motoruyla uygulayabilirsiniz tekrar etkinleştirebilirsiniz. Döngü, oyun uygulamanızda testinizin tam veya kısmi bir şekilde çalıştırılmasıdır. Oyun döngüleri aşağıdakiler için kullanılabilir:

  • Oyununuzda bir seviyeyi, son kullanıcının oynadığı gibi yönetin. Kullanıcının girişini komut dosyası olarak yazabilir, kullanıcının boşta kalmasına izin verebilir veya oyununuzda uygunsa kullanıcıyı yapay zeka ile değiştirebilirsiniz (ör. yarış arabası oyun uygulamanız varsa ve uygulamanızda zaten yapay zeka uygulanmışsa). Kullanıcının girişinden sorumlu bir yapay zeka sürücüsü kolayca ekleyebilirsiniz).
  • Cihazların destekleyip desteklemediğini görmek için oyununuzu en yüksek kalite ayarıyla çalıştırın.
  • Teknik test çalıştırın (birden fazla gölgelendiriciyi derleyin, yürütün, çıktının beklendiği gibi olup olmadığını kontrol edin vb.).

Oyun döngüsü testini tek bir test cihazında, bir grup test cihazında veya Test Lab'te çalıştırabilirsiniz. Ancak, sanal makinelerde Oyun Döngüsü testlerini çalıştırmanızı çünkü fiziksel cihazlara kıyasla daha düşük grafik kare hızına sahipler.

Başlamadan önce

Test uygulamak için öncelikle uygulamanızı Oyun Döngüsü testleri için yapılandırmanız gerekir.

  1. Uygulama manifestinizde etkinliğinize yeni bir intent filtresi ekleyin:

    <activity android:name=".MyActivity">
   <intent-filter>
       <action android:name="com.google.intent.action.TEST_LOOP"/>
       <category android:name="android.intent.category.DEFAULT"/>
       <data android:mimeType="application/javascript"/>
   </intent-filter>
   <intent-filter>
      ... (other intent filters here)
   </intent-filter>
</activity>

    Bu sayede Test Lab, oyununuzu belirli bir intent ile tetikleyerek başlatabilir.

  2. Kodunuza (onCreate yöntemi beyanının içine eklemenizi öneririz) aşağıdakileri ekleyin:

    Kotlin+KTX 

    val launchIntent = intent
if (launchIntent.action == "com.google.intent.action.TEST_LOOP") {
    val scenario = launchIntent.getIntExtra("scenario", 0)
    // Code to handle your game loop here
}
    MainActivity.kt

    Java 

    Intent launchIntent = getIntent();
if(launchIntent.getAction().equals("com.google.intent.action.TEST_LOOP")) {
    int scenario = launchIntent.getIntExtra("scenario", 0);
    // Code to handle your game loop here
}
    MainActivity.java

    Bu sayede etkinliğiniz, başlatan niyeti kontrol edebilir. İsterseniz bu kodu daha sonra da ekleyebilirsiniz (ör. oyun motorunuzu ilk kez yükledikten sonra).

  3. Önerilir: Testin sonunda şunları ekleyin:

    Kotlin+KTX 

    yourActivity.finish()
    MainActivity.kt

    Java 

    yourActivity.finish();
    MainActivity.java

    Bu işlem, Oyun Döngüsü testi tamamlandığında uygulamanızı kapatır. Test yöntemi, uygulamanızın kullanıcı arayüzü çerçevesine sahip olduğunuzdan, uygulamanızı kapattığınızda emin olmanız gerekir.

Oyun Döngüsü testi oluştur ve çalıştır

Uygulamanızı Game Loop testleri için yapılandırdıktan sonra hemen bir test oluşturabilir ve oyun uygulamanızda çalıştırabilirsiniz. Firebase Konsolu veya gcloud komut satırı arayüzünü (CLI) kullanarak Test Lab'te veya Test Döngüsü Yöneticisi'ni kullanarak yerel bir cihazda test çalıştırmayı seçebilirsiniz.

Yerel cihazda çalıştırma

Test Lab'ın Test Döngüsü Yöneticisi, Game Loop testlerini entegre etmenize ve yerel cihazlarınızda çalıştırmanıza yardımcı olan açık kaynak bir uygulamadır. Ayrıca kalite güvencesi ekibinizin kendi cihazlarında aynı oyun döngülerini çalıştırmasına olanak tanır.

Test Döngüsü Yöneticisi'ni kullanarak yerel bir cihazda test çalıştırmak için:

  1. Test Döngüsü Yöneticisi'ni indirin uygulamayı yüklemek için aşağıdaki adımları uygulayın: 
    adb install testloopmanager.apk
  2. Cihazınızda, telefonunuzda Test Loop Apps uygulamasını açın veya tablete yerleştiriyoruz. Uygulama, cihazınızda şu özelliklere sahip uygulamaların bir listesini görüntüler: kullanılarak çalıştırılabilir. Oyun uygulamanızı burada göremiyorsanız Amaç filtreniz, anahtarın ilk adımında belirtilenle Başlamadan önce bölümü.
  3. Oyun uygulamanızı, ardından çalıştırmak istediğiniz döngü sayısını seçin. Not: Bu adımda, yalnızca bir döngü yerine bir döngü alt kümesini çalıştırmayı seçebilirsiniz. Daha fazla bilgi için aynı anda birden fazla döngü çalıştırmakla ilgili daha fazla bilgi için İsteğe bağlı özellikler bölümüne bakın.
  4. Testi çalıştır'ı tıklayın. Testiniz hemen çalışmaya başlar.

Test Lab'te çalıştırma

Firebase konsolunu veya gcloud CLI'yi kullanarak Test Lab'te bir Game Loop testi çalıştırabilirsiniz. Başlamadan önce, henüz yapmadıysanız Firebase konsolunu açıp bir proje oluşturun.

Firebase konsolunu kullanma

  1. Firebase konsolunda, sol panelden Test Lab simgesini tıklayın.
  2. İlk Testinizi Çalıştırın (veya projenizde Test Çalıştır bir test yaptık.
  3. Test türü olarak Oyun Döngüsü'nü seçip Devam'ı tıklayın.
  4. Göz at'ı tıklayın, ardından uygulamanızın .apk dosyasına göz atın. Not: Bu adımda, yalnızca rastgele bir döngü oluşturmak yerine döngülerin bir alt kümesini çalıştırmayı bir döngü oluşturabilirsiniz. Daha fazla bilgi için aynı anda birden fazla döngü çalıştırmayı İsteğe bağlı özellikler.
  5. Devam'ı tıklayın.
  6. Uygulamanızı test etmek için kullanılacak fiziksel cihazları seçin.
  7. Testleri Başlat'ı tıklayın.

Firebase konsolunu kullanmaya başlama hakkında daha fazla bilgi için Firebase konsolunu kullanarak test etmeye başlama başlıklı makaleyi inceleyin.

gcloud komut satırını (KSA) kullanma

  1. Henüz yapmadıysanız Google Cloud SDK'yı indirip yükleyin.

  2. Google Hesabınızı kullanarak gcloud CLI'de oturum açın:

    gcloud auth login

  3. Firebase projenizi, PROJECT_ID öğesinin bulunduğu gcloud'da ayarlayın Firebase projenizin kimliği:

    gcloud config set project PROJECT_ID

  4. İlk testinizi çalıştırın:

    gcloud firebase test android run \
 --type=game-loop --app=<var>path-to-apk</var> \
 --device model=herolte,version=23

gcloud CLI'yi kullanmaya başlama hakkında daha fazla bilgi için gcloud komut satırından test etmeye başlama başlıklı makaleyi inceleyin.

İsteğe bağlı özellikler

Test Lab, verilerinizi daha da özelleştirmenize olanak tanıyan isteğe bağlı bazı özellikler sunar. çıkış verilerini yazma yeteneği, birden fazla oyun için destek dahil testler döngüler ve ilgili döngüler için etiketler.

Çıkış verilerini yazma

Oyun Döngüsü testiniz launchIntent.getData() yöntemini çağırın. Bir test çalıştırdıktan sonra Firebase konsolunun Test Lab bölümündeki çıkış verilerini (bkz. Oyun Döngüsü testi çıkış dosyası örneği).

Test Lab, uygulamalar arasında dosya paylaşımıyla ilgili şu en iyi uygulamaları takip ediyor: Dosya Paylaşma. Etkinliğinizin onCreate() yönteminde (amacınızın bulunduğu yer) aşağıdaki kodu çalıştırarak veri çıkış dosyanızı kontrol edebilirsiniz:

Kotlin+KTX 

val launchIntent = intent
val logFile = launchIntent.data
logFile?.let {
    Log.i(TAG, "Log file ${it.encodedPath}")
    // ...
}
MainActivity.kt

Java 

Intent launchIntent = getIntent();
Uri logFile = launchIntent.getData();
if (logFile != null) {
    Log.i(TAG, "Log file " + logFile.getEncodedPath());
    // ...
}
MainActivity.java

Dosyaya oyun uygulamanızın C++ tarafından yazmak istiyorsanız dosya yolu yerine dosya açıklayıcısını iletin:

Kotlin+KTX 

val launchIntent = intent
val logFile = launchIntent.data
var fd = -1
logFile?.let {
    Log.i(TAG, "Log file ${it.encodedPath}")
    fd = try {
        contentResolver
            .openAssetFileDescriptor(logFile, "w")!!
            .parcelFileDescriptor
            .fd
    } catch (e: FileNotFoundException) {
        e.printStackTrace()
        -1
    } catch (e: NullPointerException) {
        e.printStackTrace()
        -1
    }
}

// C++ code invoked here.
// native_function(fd);
MainActivity.kt

Java 

Intent launchIntent = getIntent();
Uri logFile = launchIntent.getData();
int fd = -1;
if (logFile != null) {
    Log.i(TAG, "Log file " + logFile.getEncodedPath());
    try {
        fd = getContentResolver()
                .openAssetFileDescriptor(logFile, "w")
                .getParcelFileDescriptor()
                .getFd();
    } catch (FileNotFoundException e) {
        e.printStackTrace();
        fd = -1;
    } catch (NullPointerException e) {
        e.printStackTrace();
        fd = -1;
    }
}

// C++ code invoked here.
// native_function(fd);
MainActivity.java

C++

#include <unistd.h>
JNIEXPORT void JNICALL
Java_my_package_name_MyActivity_native_function(JNIEnv *env, jclass type, jint log_file_descriptor) {
// The file descriptor needs to be duplicated.
int my_file_descriptor = dup(log_file_descriptor);
}

Çıkış dosyası örneği

Oyunu görüntülemek için çıkış veri dosyalarını (aşağıdaki örnek gibi biçimlendirilmiştir) kullanabilirsiniz. döngü test sonuçlarını Firebase konsolunun Test Lab bölümünde görebilirsiniz. /.../ olarak gösterilen alanlar, yalnızca bu dosyada kullanılan diğer alanların adlarıyla çakışmazlar:

{
  "name": "test name",
  "start_timestamp": 0, // Timestamp of the test start (in us).
                           Can be absolute or relative
  "driver_info": "...",
  "frame_stats": [
    {
      "timestamp": 1200000, // Timestamp at which this section was written
                               It contains value regarding the period
                               start_timestamp(0) -> this timestamp (1200000 us)
      "avg_frame_time": 15320, // Average time to render a frame in ns
      "nb_swap": 52, // Number of frame rendered
      "threads": [
        {
          "name": "physics",
          "Avg_time": 8030 // Average time spent in this thread per frame in us
        },
        {
          "name": "AI",
          "Avg_time": 2030 // Average time spent in this thread per frame in us
        }
      ],
      /.../ // Any custom field you want (vertices display on the screen, nb units …)
    },
    {
      // Next frame data here, same format as above
    }
  ],
  "loading_stats": [
    {
      "name": "assets_level_1",
      "total_time": 7850, // in us
      /.../
    },
    {
      "name": "victory_screen",
      "total_time": 554, // in us
      /.../
    }

  ],
  /.../, // You can add custom fields here
}

Birden fazla oyun döngüsü

Uygulamanızda birden fazla oyun döngüsü çalıştırmak faydalı olabilir. Döngü, başından sonuna kadar tam oynanmasını sağlayabilirsiniz. Örneğin, oyununuzda birden fazla seviye varsa hepsini iteratif olarak çalıştıran bir döngü yerine her seviyeyi başlatmak için bir oyun döngüsü kullanmak isteyebilirsiniz. Böylece, uygulamanız 32. seviyede kilitlenirse doğrudan oyunu başlatabilirsiniz döngüsünü uygulayın.

Uygulamanızın aynı anda birden fazla döngü çalıştırmasını sağlamak için:

  • Test Döngüsü Yöneticisi ile bir test çalıştırıyorsanız:

    1. Aşağıdaki satırı uygulamanızın manifest dosyasına, <application> öğe: 

      <meta-data
  android:name="com.google.test.loops"
  android:value="5" />

      Bu başlatma amacı, hedef döngüyü tam sayı parametresi olarak içerir. İçinde android:value alanında, 1 - 1024 arasında bir tam sayı ( bir test için izin verilen maksimum döngü sayısı) ekleyebilirsiniz. Döngülerin 0 yerine 1'den başlayarak dizine eklendiğini unutmayın.

    2. Test Döngüsü Yöneticisi uygulamasında, çalıştırmak istediğiniz döngüleri seçmenize olanak tanıyan bir seçim ekranı gösterilir. Birden fazla döngü seçerseniz her döngü, önceki döngü tamamlandıktan sonra sırayla başlatılır.

  • Firebase konsoluyla bir test çalıştırıyorsanız bir liste ya da Senaryolar alanındaki döngü sayı aralığını seçin.

  • gcloud CLI ile bir test çalıştırıyorsanız --scenario-numbers işaretçisini kullanarak bir döngü numarası listesi belirtin. Örneğin, --scenario-numbers=1,3,5 1, 3 ve 5. döngüleri çalıştırır.

  • C++ yazıyor ve döngünüzün davranışını değiştirmek istiyorsanız yerel C++ kodunuza ekleme işlemini tamamlayın:

    Kotlin+KTX 

    val launchIntent = intent
val scenario = launchIntent.getIntExtra("scenario", 0)
    MainActivity.kt

    Java 

    Intent launchIntent = getIntent();
int scenario = launchIntent.getIntExtra("scenario", 0);
    MainActivity.java

    Artık döngünüzün davranışını, elde edilen int değerine göre değiştirebilirsiniz. değer.

Etiket oyunu döngüleri

Oyun döngülerinizi bir veya daha fazla senaryo etiketiyle etiketlediğinizde, siz ve kalite kontrol ekibiniz ilgili bir dizi oyun döngüsünü (ör. "tüm uyumluluk oyun döngüleri") ve bunları tek bir matriste test edin. Kendi etiketlerinizi oluşturabilir veya Test Lab tarafından sunulan önceden tanımlanmış etiketleri kullanabilirsiniz:

  • com.google.test.loops.player_experience: Şu işlem için kullanılan döngüler: Gerçek bir kullanıcının oyun sırasındaki deneyimini yeniden üretmek. Amacı bu döngülerle test, gerçek bir kullanıcının çalışırken karşılaşacağı pek de iyi olmadığını unutmayın.
  • com.google.test.loops.gpu_compatibility: GPU ile ilgili sorunları test etmek için kullanılan For döngüleri. Bu döngülerle testin amacı, ve üretimde düzgün çalışmayabilecek yeni kodların çalıştırılması, donanım ve sürücüler.
  • com.google.test.loops.compatibility: Test etmek amacıyla kullanılan döngüler G/Ç sorunları ve OpenSSL dahil olmak üzere geniş bir uyumluluk sorunu yelpazesi sorunları.
  • com.google.test.loops.performance: Cihazın performansını test etmek için kullanılan For döngüleri. Örneğin, yeni bir cihazın nasıl davrandığını görmek için bir oyun en karmaşık grafik ayarlarında çalıştırılabilir.

Uygulamanızın aynı etikete sahip döngüler çalıştırmasını sağlamak için:

  • Test Döngüsü Yöneticisi ile test çalıştırıyorsanız:

    1. Uygulamanızın manifest dosyasına aşağıdaki meta veri satırını ekleyin ve İstediğiniz etiketle LABEL_NAME:

      <meta-data
 android:name="com.google.test.loops.LABEL_NAME"
 android:value="1,3-5" />

      android:value alanında, etiketlemek istediğiniz döngüleri temsil eden 1 ile 1024 arasında (tek bir test için izin verilen maksimum döngü sayısı) bir aralık veya bir tam sayı kümesi belirtebilirsiniz. Döngülerin dizine 1'den başlar, 0'a değil. Örneğin, android:value="1,3-5" geçerlidir LABEL_NAME 1, 3, 4 ve 5'i döngüye alır.

    2. Test Döngüsü Yöneticisi uygulamasındaki Etiketler bölümüne bir veya daha fazla etiket girin. girin.

  • Firebase konsoluyla test çalıştırıyorsanız Etiketler alanına bir veya daha fazla etiket girin.

  • gcloud KSA ile test çalıştırıyorsanız bir tane belirtin veya daha fazla senaryo etiketi oluşturmak için --scenario-labels işareti (ör. --scenario-labels=performance,gpu) bilgileri gösterilir.

Uygulama lisanslama desteği

Test Lab, Google Play tarafından sunulan uygulama lisanslama hizmetini kullanan uygulamaları destekler. Uygulamanızı Test Lab ile test ederken lisanslamayı başarılı bir şekilde kontrol etmek için uygulamanızı Play Store'daki üretim kanalında yayınlamanız gerekir. Uygulamanızı Test Lab'ü kullanarak alfa veya beta kanalında test etmek için uygulamanızı Test Lab'e yüklemeden önce lisans denetimini kaldırın.

Bilinen sorunlar

Test Lab'teki Oyun Döngüsü testlerinde aşağıdaki bilinen sorunlar vardır:

  • Bazı kilitlenmeler, geri izlemeleri desteklemez. Örneğin, bazı sürüm derlemeleri debuggerd işleminin çıkışını aşağıdakileri kullanarak bastır: prctl(PR_SET_DUMPABLE, 0). Daha fazla bilgi için debuggerd konusuna bakın.
  • API 19 düzeyi, dosya izni hataları nedeniyle şu anda desteklenmemektedir.