iOS için Game Loop testlerine başlayın

Game Loop testleriyle, oyun motorunuza özgü testler yazabilir ve ardından bunları seçtiğiniz cihazlarda Test Lab'da çalıştırabilirsiniz. Bu şekilde, farklı kullanıcı arayüzü için yazma veya çerçeveleri test etme konusunda endişelenmenize gerek kalmaz. Game Loop testi, gerçek bir oyuncunun eylemlerini simüle eder ve Test Laboratuvarı'nda çalıştırdığınızda, oyununuzun kullanıcılarınız için iyi performans gösterdiğini doğrulamak için hızlı ve ölçeklenebilir bir yol sağlar.

Bu sayfa, Game Loop testini nasıl çalıştıracağınızı ve ardından Firebase konsolunun Test Laboratuvarı sayfasında test sonuçlarınızı nasıl görüntüleyeceğinizi ve yöneteceğinizi gösterir. Ayrıca özel test sonuçları yazma veya testinizi erken bitirme gibi isteğe bağlı özelliklerle testlerinizi daha da özelleştirebilirsiniz.

Oyun Döngüsü Testi nedir?

Döngü, testinizin oyun uygulamanızda tam veya kısmi olarak tekrarlanmasıdır. Game Loop testini yerel olarak bir simülatörde veya Test Laboratuvarı'ndaki bir dizi cihazda çalıştırabilirsiniz. Oyun Döngüsü testleri şu amaçlarla kullanılabilir:

  • Oyununuzu son kullanıcının oynayacağı şekilde çalıştırın. Kullanıcı girişinin komut dosyasını yazabilir, kullanıcının boşta kalmasına izin verebilir veya kullanıcıyı bir yapay zeka ile değiştirebilirsiniz (örneğin, bir araba yarışı oyununda yapay zeka uyguladıysanız, kullanıcının girişinden sorumlu bir yapay zeka sürücüsünü atayabilirsiniz) .

  • Hangi cihazların destekleyebileceğini öğrenmek için oyununuzu en yüksek kalite ayarında çalıştırın.

  • Birden çok gölgelendiriciyi derlemek, bunları yürütmek ve çıktının beklendiği gibi olup olmadığını kontrol etmek gibi teknik bir test çalıştırın.

1. Adım: Test Lab'in özel URL şemasını kaydedin

Öncelikle Firebase Test Lab'ın özel URL şemasını uygulamanıza kaydetmeniz gerekir:

  1. Xcode'da bir proje hedefi seçin.

  2. Bilgi sekmesini tıklayın, ardından yeni bir URL türü ekleyin.

  3. URL Şemaları alanına firebase-game-loop girin. Özel URL şemasını projenizin Info.plist yapılandırma dosyasında <dict> etiketinin herhangi bir yerine ekleyerek de kaydedebilirsiniz:

    <key>CFBundleURLTypes</key>
     <array>
         <dict>
             <key>CFBundleURLName</key>
             <string></string>
             <key>CFBundleTypeRole</key>
             <string>Editor</string>
             <key>CFBundleURLSchemes</key>
             <array>
                 <string>firebase-game-loop</string>
             </array>
         </dict>
     </array>
    

Uygulamanız artık Test Lab'ı kullanarak test çalıştıracak şekilde yapılandırılmıştır.

2. Adım (isteğe bağlı): Uygulamanızı birden fazla döngü çalıştıracak şekilde yapılandırın

Uygulamanızda kayıtlı birden fazla özel URL şeması varsa ve testinizde birden fazla döngü (başka bir deyişle senaryo) çalıştırmayı planlıyorsanız, başlatma sırasında uygulamanızda hangi döngüleri çalıştırmak istediğinizi belirtmeniz gerekir.

Uygulama temsilcinizde application(_:open:options:) yöntemini geçersiz kılın:

Süratli

func application(_app: UIApplication,
                 open url: URL
                 options: [UIApplication.OpenURLOptionsKey : Any] = [:]) -> Bool {
    let components = URLComponents(url: url, resolvingAgainstBaseURL: true)!
    if components.scheme == "firebase-game-loop" {
        // ...Enter Game Loop Test logic to override application(_:open:options:).
    }
    return true
}

Amaç-C

- (BOOL)application:(UIApplication *)app
            openURL:(NSURL *)url
            options:(NSDictionary &lt;UIApplicationOpenURLOptionsKey, id&gt; *)options {
  if ([url.scheme isEqualToString:(@"firebase-game-loop")]) {
      // ...Enter Game Loop Test logic to override application(_:open:options:).
  }
}

Testinizde birden fazla döngü çalıştırdığınızda geçerli döngü, uygulamayı başlatmak için kullanılan URL'ye parametre olarak iletilir. Özel URL şemasını getirmek için kullanılan URLComponents nesnesini ayrıştırarak da geçerli döngü numarasını elde edebilirsiniz:

Süratli

if components.scheme == "firebase-game-loop" {
    // Iterate over all parameters and find the one with the key "scenario".
    let scenarioNum = Int(components.queryItems!.first(where: { $0.name == "scenario" })!.value!)!
    // ...Write logic specific to the current loop (scenarioNum).
}

Amaç-C

if ([url.scheme isEqualToString:(@"firebase-game-loop")]) {
    // Launch the app as part of a game loop.
    NSURLComponents *components = [NSURLComponents componentsWithURL:url
                                             resolvingAgainstBaseURL:YES];
    for (NSURLQueryItem *item in [components queryItems]) {
        if ([item.name isEqualToString:@"scenario"]) {
            NSInteger scenarioNum = [item.value integerValue];
            // ...Write logic specific to the current loop (scenarioNum).
        }
    }
}

3. Adım: Bir test oluşturun ve çalıştırın

Test Lab'in özel URL şemasını kaydettikten sonra testinizi Firebase konsolunda veya gcloud beta CLI ile çalıştırabilirsiniz. Henüz yapmadıysanız uygulamanız için bir IPA dosyası oluşturun (bu dosyayı daha sonra bulmanız gerekecektir).

Firebase konsolunda bir test çalıştırın

  1. Henüz yapmadıysanız Firebase konsolunu açın ve bir proje oluşturun.

  2. Firebase konsolunun Test Laboratuvarı sayfasında İlk Testinizi Çalıştırın > iOS Oyun Döngüsü Çalıştır'ı tıklayın.

  3. Uygulamayı Yükle bölümünde Gözat'a tıklayın, ardından uygulamanızın IPA dosyasını seçin (henüz yapmadıysanız uygulamanız için bir IPA dosyası oluşturun ).

  4. İsteğe bağlı : Aynı anda birden fazla döngüyü (senaryo olarak da bilinir) çalıştırmak veya çalıştırılacak belirli döngüleri seçmek istiyorsanız Senaryolar alanına döngü numaralarını girin.

    Örneğin, "1-3, 5" girdiğinizde Test Lab, 1, 2, 3 ve 5 numaralı döngüleri çalıştırır. Varsayılan olarak ( Senaryolar alanına hiçbir şey girmezseniz), Test Lab yalnızca döngü 1'i çalıştırır.

  5. Cihazlar bölümünde, uygulamanızı test etmek istediğiniz bir veya daha fazla fiziksel cihazı seçin ve ardından Testleri Başlat'a tıklayın.

gcloud beta CLI ile bir test çalıştırın

  1. Henüz yapmadıysanız yerel gcloud SDK ortamınızı yapılandırın ve ardından gcloud beta bileşenini yüklediğinizden emin olun.

  2. gcloud beta firebase test ios run komutunu çalıştırın ve çalıştırmayı yapılandırmak için aşağıdaki işaretleri kullanın:

Oyun Döngüsü testleri için işaretler
--type

Gerekli : Çalıştırmak istediğiniz iOS testinin türünü belirtir. Test türlerini xctest (varsayılan) veya game-loop girebilirsiniz.

--app

Gerekli : Uygulamanızın IPA dosyasının mutlak yolu (Google Cloud Storage veya dosya sistemi). Bu işaret yalnızca Game Loop testleri çalıştırılırken geçerlidir.

--scenario-numbers

Uygulamanızda çalıştırmak istediğiniz döngüler (diğer adıyla senaryolar). Bir döngü, bir liste veya döngüler ya da bir döngü aralığı girebilirsiniz. Varsayılan döngü 1'dir.

Örneğin --scenario-numbers=1-3,5 1, 2, 3 ve 5 numaralı döngüleri çalıştırır.

--device-model

Testinizi çalıştırmak istediğiniz fiziksel cihaz (hangi mevcut cihazları kullanabileceğinizi öğrenin).

--timeout

Testinizin çalışmasını istediğiniz maksimum süre. Süreyi saniye cinsinden temsil etmek için bir tam sayı veya süreyi daha uzun bir zaman birimi olarak temsil etmek için bir tam sayı ve numaralandırma girebilirsiniz.

Örneğin:

  • --timeout=200 testinizi 200 saniyeye kadar çalıştığında sonlandırılmaya zorlar.
  • --timeout=1h testinizi bir saate kadar çalıştığında sonlandırılmaya zorlar.

Örneğin, aşağıdaki komut iPhone 8 Plus'ta 1, 4, 6, 7 ve 8. döngüleri yürüten bir Oyun Döngüsü testi çalıştırır:

gcloud beta firebase test ios run
 --type game-loop --app path/to/my/App.ipa --scenario-numbers 1,4,6-8
 --device-model=iphone8plus

gcloud CLI hakkında daha fazla bilgi için referans belgelere bakın.

Yerel olarak bir test çalıştırın

Testinizi yerel olarak çalıştırmak için oyun uygulamanızı bir simülatöre yükleyin ve çalıştırın:

xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://
  • Simülatörünüzün UDID'sini instruments -s devices komutunu çalıştırarak bulabilirsiniz.

  • Çalışan tek bir simülatör varsa, SIMULATOR_UDID yerine "booted" özel dizesini girin.

Testiniz birden fazla döngü içeriyorsa döngü numarasını scenario bayrağına ileterek hangi döngüyü çalıştırmak istediğinizi belirtebilirsiniz. Testinizi yerel olarak çalıştırırken aynı anda yalnızca bir döngü çalıştırabileceğinizi unutmayın. Örneğin 1, 2 ve 5 numaralı döngüleri çalıştırmak istiyorsanız her döngü için ayrı bir komut çalıştırmanız gerekir:

xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://?scenario=1
xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://?scenario=2
xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://?scenario=5

Testi erken sonlandırın

Varsayılan olarak Oyun Döngüsü testi, tüm döngüler yürütülmüş olsa bile beş dakikalık zaman aşımına ulaşana kadar çalışmaya devam eder. Zaman aşımına ulaşıldığında test sona erer ve bekleyen döngüler iptal edilir. Uygulamanızın AppDelegate'inde Test Lab'in özel URL şeması firebase-game-loop-complete çağırarak testinizi hızlandırabilir veya erken bitirebilirsiniz. Örneğin:

Süratli

/// End the loop by calling our custom url scheme.
func finishLoop() {
    let url = URL(string: "firebase-game-loop-complete://")!
    UIApplication.shared.open(url)
}

Amaç-C

- (void)finishLoop {
  UIApplication *app = [UIApplication sharedApplication];
  [app openURL:[NSURL URLWithString:@"firebase-game-loop-complete://"]
      options:@{}
completionHandler:^(BOOL success) {}];
}

Oyun Döngüsü testiniz mevcut döngüyü sonlandırır ve sonraki döngüyü yürütür. Çalıştırılacak döngü kalmadığında test sona erer.

Özel test sonuçlarını yazın

Game Loop testinizi, özel test sonuçlarını cihazınızın dosya sistemine yazacak şekilde yapılandırabilirsiniz. Bu şekilde, test çalışmaya başladığında Test Lab, sonuç dosyalarını test cihazınızdaki (kendiniz oluşturmanız gereken) bir GameLoopsResults dizininde saklar. Test sona erdiğinde, Test Lab tüm dosyaları GameLoopResults dizininden projenizin klasörüne taşır. Testinizi ayarlarken aşağıdakileri aklınızda bulundurun:

  • Tüm sonuç dosyaları, dosya türüne, boyutuna veya miktarına bakılmaksızın yüklenir.

  • Test Lab, testinizdeki tüm döngülerin çalışması bitene kadar test sonuçlarınızı işlemez; bu nedenle, testiniz çıktı yazan birden fazla döngü içeriyorsa, bunları benzersiz bir sonuç dosyasına eklediğinizden veya her döngü için bir sonuç dosyası oluşturduğunuzdan emin olun. Bu şekilde önceki döngüden elde edilen sonuçların üzerine yazılmasını önleyebilirsiniz.

Testinizi özel test sonuçlarını yazacak şekilde ayarlamak için:

  1. Uygulamanızın Documents dizininde GameLoopResults adında bir dizin oluşturun.

  2. Uygulamanızın kodunun herhangi bir yerinden (örneğin, uygulama temsilciniz) aşağıdakileri ekleyin:

    Süratli

    /// Write to a results file.
    func writeResults() {
      let text = "Greetings from game loops!"
      let fileName = "results.txt"
      let fileManager = FileManager.default
      do {
    
      let docs = try fileManager.url(for: .documentDirectory,
                                     in: .userDomainMask,
                                     appropriateFor: nil,
                                     create: true)
      let resultsDir = docs.appendingPathComponent("GameLoopResults")
      try fileManager.createDirectory(
          at: resultsDir,
          withIntermediateDirectories: true,
          attributes: nil)
      let fileURL = resultsDir.appendingPathComponent(fileName)
      try text.write(to: fileURL, atomically: false, encoding: .utf8)
      } catch {
        // ...Handle error writing to file.
      }
    }
    

    Amaç-C

    /// Write to a results file.
    - (void)writeResults:(NSString *)message {
        // Locate and create the results directory (if it doesn't exist already).
        NSFileManager *manager = [NSFileManager defaultManager];
        NSURL* url = [[manager URLsForDirectory:NSDocumentDirectory
                                      inDomains:NSUserDomainMask] lastObject];
        NSURL* resultsDir = [url URLByAppendingPathComponent:@"GameLoopResults"
                                                 isDirectory:YES];
        [manager createDirectoryAtURL:resultsDir
          withIntermediateDirectories:NO
                           attributes:nil
                                error:nil];
    
        // Write the result message to a text file.
        NSURL* resultFile = [resultsDir URLByAppendingPathComponent:@"result.txt"];
        if ([manager fileExistsAtPath:[resultFile path]]) {
            // Append to the existing file
            NSFileHandle *handle = [NSFileHandle fileHandleForWritingToURL:resultFile
                                                                     error:nil];
            [handle seekToEndOfFile];
            [handle writeData:[message dataUsingEncoding:NSUTF8StringEncoding]];
            [handle closeFile];
        } else {
            // Create and write to the file.
            [message writeToURL:resultFile
                     atomically:NO
                       encoding:NSUTF8StringEncoding error:nil];
        }
    }