iOS için Game Loop testlerini kullanmaya başlayın

Oyun döngüsü testleriyle, oyun motorunuza özgü testler yazıp bunları Test Lab üzerinden seçtiğiniz cihazlarda çalıştırabilirsiniz. Bu sayede, farklı kullanıcı arayüzü veya test çerçeveleri için kod yazma konusunda endişelenmenize gerek kalmaz. Oyun döngüsü testi, gerçek bir oyuncunun işlemlerini simüle eder ve Test Lab üzerinde çalıştırdığınızda oyununuzun kullanıcılarınız için iyi performans gösterdiğini doğrulamanın hızlı ve ölçeklenebilir bir yolunu sunar.

Bu sayfada, Oyun Döngüsü testini nasıl çalıştıracağınız, ardından test sonuçlarınızı Firebase konsolunun Test Lab sayfasında nasıl görüntüleyip yöneteceğiniz açıklanmaktadır. Ayrıca özel test sonuçları yazma veya testinizi erken sonlandırma gibi isteğe bağlı özelliklerle testlerinizi daha da özelleştirebilirsiniz.

Not: Test Lab ürününü, sınırlı bir günlük kota içeren Spark fiyatlandırma planıyla ücretsiz olarak kullanabilirsiniz. Diğer fiyatlandırma planları ve kullanım sınırları hakkında daha fazla bilgi için Firebase Fiyatlandırma Planları'na bakın.

Oyun Döngüsü Testi nedir?

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

• Oyununuzu son kullanıcıların oynayacağı şekilde oynayın. Kullanıcının girişini komut dosyasıyla belirleyebilir, kullanıcının boşta kalmasına izin verebilir veya kullanıcıyı yapay zekayla 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ü koyabilirsiniz).

• Oyununuzu en yüksek kalite ayarında çalıştırarak hangi cihazların destekleyebileceğini öğrenin.

• Birden fazla gölgelendiriciyi derleme, çalıştırma ve çıkışın beklendiği gibi olduğunu kontrol etme gibi teknik bir test yapın.

1. adım: Test Lab uygulamasının özel URL şemasını kaydedin

Öncelikle uygulamanızda Firebase Test Lab özel URL şemasını 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 değerini girin. Özel URL şemasını, projenizin Info.plist yapılandırma dosyasına <dict> etiketinin içinde herhangi bir yere 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ıldı.

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

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

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

Swift

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
}

Objective-C

- (BOOL)application:(UIApplication *)app
            openURL:(NSURL *)url
            options:(NSDictionary <UIApplicationOpenURLOptionsKey, id> *)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 mevcut 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 mevcut döngü numarasını alabilirsiniz:

Swift

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).
}

Objective-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: Test oluşturma ve çalıştırma

Test Lab uygulamasının ö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 (daha sonra bu dosyayı bulmanız gerekecek).

İpucu: Test Lab aracını kullanmadan önce testinizi yerel olarak bir simülatörde çalıştırarak oyun döngülerinizin amaçlandığı gibi çalıştığından emin olabilirsiniz.

Uygulamanız için IPA oluşturma

1. Xcode'da hedef uygulama için bir temel hazırlık profili seçin.
   Not: Test Lab, uygulamanızı kendi temel hazırlık profili ve sertifikasıyla yeniden imzalar.
2. Açılan menüden Ürün > Arşivle'yi tıklayın. En son arşivi seçip Distribute App'i (Uygulamayı Dağıt) tıklayın.
3. Açılan pencerede Geliştirme > Sonraki'yi tıklayın.
4. İsteğe bağlı: Daha hızlı bir derleme elde etmek için Bit kodundan yeniden derle seçeneğinin işaretini kaldırın ve İleri'yi tıklayın. Test Lab test çalıştırmak için uygulamanızın inceltilmesini veya yeniden derlenmesini gerektirmez. Bu nedenle, bu seçeneği güvenle devre dışı bırakabilirsiniz.
5. Export'u (Dışa aktar) tıklayın, ardından uygulamanızın IPA dosyasını indirmek istediğiniz dizini girin.

Firebase konsolunda test çalıştırma

1. Firebase konsolunda DevOps & Engagement (DevOps ve Etkileşim) > Test Lab'e gidin.

2. Run Your First Test > Run an iOS Game Loop'u (İlk Testinizi Çalıştırın > iOS oyun döngüsü Çalıştırın) tıklayın.

3. Uygulama Yükle bölümünde Gözat'ı 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ü (senaryo) çalıştırmak veya çalıştırılacak belirli döngüleri seçmek istiyorsanız döngü numaralarını Scenarios (Senaryolar) alanına girin.

   Örneğin, 1-3, 5 değerini girdiğinizde Test Lab, 1, 2, 3 ve 5 döngülerini çalıştırır. Varsayılan olarak (Senaryolar alanına herhangi bir şey girmezseniz) Test Lab yalnızca 1 döngüsünü çalıştırır.

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

gcloud beta CLI ile test çalıştırma

Beta: iOS Oyun Döngüsü testleri için gcloud beta CLI komutu bir beta sürümüdür. Bu, işlevin geriye dönük uyumsuzluk oluşturacak şekilde değişebileceği anlamına gelir. Beta sürümü, herhangi bir HDS'ye (Hizmet Düzeyi Sözleşmesi) veya kullanımdan kaldırma politikasına tabi değildir ve sınırlı destek alabilir ya da hiç destek almayabilir.

1. Henüz yapmadıysanız yerel gcloud SDK ortamınızı yapılandırın, 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ırma işlemini yapılandırmak için aşağıdaki işaretleri kullanın:

Oyun Döngüsü testleri için işaretler
--type	Zorunlu: Çalıştırmak istediğiniz iOS testinin türünü belirtir. xctest (varsayılan) veya game-loop test türlerini girebilirsiniz.
--app	Zorunlu: Uygulamanızın IPA dosyasının mutlak yolu (Google Cloud Storage veya dosya sistemi). Bu işaret yalnızca Oyun Döngüsü testleri çalıştırılırken geçerlidir.
--scenario-numbers	Uygulamanızda çalıştırmak istediğiniz döngüler (senaryolar). Bir döngü, döngü listesi veya döngü aralığı girebilirsiniz. Varsayılan döngü sayısı 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 (kullanabileceğiniz cihazları öğrenin).
--timeout	Testinizin çalıştırılması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 sıralama girebilirsiniz. Örneğin: --timeout=200, testinizin 200 saniyeye kadar çalıştığında sonlandırılmasını zorunlu kılar. --timeout=1h, testinizin bir saat boyunca çalıştıktan sonra sonlandırılmasını zorunlu kılar.

Örneğin, aşağıdaki komut bir iPhone 8 Plus'ta 1, 4, 6, 7 ve 8 numaralı döngüleri çalıştıran bir Oyun Döngüsü testi yürütü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 belgelerine bakın.

Testi yerel olarak çalıştırma

Testinizi yerel olarak çalıştırmak için oyun uygulamanızı bir simülatöre yükleyin ve şu komutu ç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.

• Yalnızca bir simülatör çalışıyorsa SIMULATOR_UDID yerine özel dize "booted" değerini girin.

Testiniz birden fazla döngü içeriyorsa döngü numarasını scenario işaretine ileterek çalıştırmak istediğiniz döngüyü 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ırma

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

Swift

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

Objective-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ı yazma

Özel test sonuçlarını cihazınızın dosya sistemine yazmak için Oyun Döngüsü testinizi yapılandırabilirsiniz. Bu sayede test çalışmaya başladığında Test Lab, sonuç dosyalarını test cihazınızdaki bir GameLoopsResults dizininde (kendiniz oluşturmanız gerekir) depolar. Test sona erdiğinde Test Lab, GameLoopResults dizinindeki tüm dosyaları projenizin paketine taşır. Testinizi oluştururken aşağıdakileri göz önünde bulundurun:

• Dosya türü, boyutu veya miktarı ne olursa olsun tüm sonuç dosyaları yüklenir.

• Test Lab, testinizdeki tüm döngüler çalışmayı tamamlayana kadar test sonuçlarınızı işlemez. Bu nedenle, testiniz çıkış 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 sayede, önceki bir döngüden elde edilen sonuçların üzerine yazılmasını önleyebilirsiniz.

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

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

2. Uygulamanızın kodunda herhangi bir yere (ör. uygulama temsilciniz) aşağıdakileri ekleyin:

   Swift

   /// 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.
     }
   }
   

   Objective-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];
       }
   }