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

Oyun döngüsü testleriyle, oyun motorunuza özgü testler yazabilir ve bunları seçtiğiniz cihazlarda Test Lab'te çalıştırabilirsiniz. Bu sayede, farklı kullanıcı arayüzü veya test çerçeveleri için yazma konusunda endişelenmenize gerek kalmaz. Oyun Döngüsü testi gerçek bir oyuncunun eylemlerini simüle eder. Test Lab üzerinde ç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 sunar.

Bu sayfada, Game Loop testini nasıl çalıştıracağınız ve ardından test sonuçlarınızı Firebase konsolunun Test Lab sayfasında nasıl görüntüleyip yöneteceğiniz gösterilmektedir. 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'i, sınırlı günlük kotaya sahip 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ı bölümüne göz atın.

Oyun döngüsü testi nedir?

Döngü, oyun uygulamanızda testinizin tam veya kısmi bir şekilde çalıştırılmasıdır. Oyun döngüsü testini yerel olarak bir simülatörde veya Test Lab'te bir grup cihazda çalıştırabilirsiniz. Oyun döngüsü testleri aşağıdaki amaçlarla kullanılabilir:

• Oyununuzu son kullanıcı gibi oynayın. Kullanıcının girişini komut dosyası olarak yazabilir, kullanıcının boşta kalmasına izin verebilir veya kullanıcıyı yapay zeka ile değiştirebilirsiniz (örneğin, bir araba yarışı oyununa yapay zeka uyguladıysanız kullanıcının girişinden sorumlu bir yapay zeka sürücü kullanabilirsiniz).

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

• Birden fazla gölgelendiriciyi derleme, yürütme ve sonucun beklendiği gibi olup olmadığını kontrol etme gibi teknik bir test çalıştırın.

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

Öncelikle Firebase Test Lab'nin ö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ı, <dict> etiketi içindeki herhangi bir yerden projenizin Info.plist yapılandırma dosyasına 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ırın

Uygulamanızda kayıtlı birden fazla özel URL şeması varsa ve testinizde birden fazla döngü (diğer adıyla senaryo) çalıştırmayı planlıyorsanız uygulamanızda başlatma sırasında hangi döngüleri çalıştırmak istediğinizi 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 geçerli döngü, uygulamayı başlatmak için kullanılan URL'ye parametre olarak iletilir. Özel URL şemasını almak için kullanılan URLComponents nesnesini ayrıştırarak da geçerli döngü numarasını elde edebilirsiniz:

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: Bir test oluşturun ve çalıştırın

Test Lab öğesinin ö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 gerekir).

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

Uygulamanız için bir IPA oluşturun

1. Xcode'da hedef uygulama için bir temel hazırlama profili seçin.
   Not: Test Lab, uygulamanızı kendi temel hazırlama profili ve sertifikasıyla yeniden imzalar.
2. Açılan açılır menüden Ürün > Arşivle'yi tıklayın. En son arşivi seçip Uygulamayı Dağıt'ı tıklayın.
3. Görüntülenen pencerede Geliştirme > Sonraki'yi tıklayın.
4. İsteğe bağlı: Daha hızlı bir derleme almak için Bit kodundan yeniden derle seçeneğini devre dışı bırakın ve Sonraki'yi tıklayın. Test Lab Bu seçenek, 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. Dışa Aktar'ı tıklayın ve ardından uygulamanızın IPA dosyasını indirmek istediğiniz dizini girin.

Firebase konsolunda test çalıştırma

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

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

3. Uygulamayı Yükle bölümünde Göz at'ı ve 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ı: Tek seferde birden fazla döngü (diğer adıyla senaryo) ç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. döngüleri çalıştırır. Varsayılan olarak (Senaryolar alanına hiçbir şey girmezseniz) Test Lab yalnızca 1. döngüyü ç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'ı tıklayın.

gcloud beta İTŞ ile test çalıştırma

Not: iOS Oyun Döngüsü testleri için gcloud beta CLI komutu, beta sürümdür. Bu da, işlevselliğin geriye dönük olarak uyumsuz olacak şekilde değişebileceği anlamına gelir. Beta sürümleri herhangi bir HDS veya kullanımdan kaldırma politikasına tabi değildir ve sınırlı destek alabilir veya hiç destek alamayabilir.

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şaretçileri kullanın:

Oyun Döngüsü testleri için işaretler
--type	Zorunlu: Çalıştırmak istediğiniz iOS testi 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 (diğer adıyla senaryolar). Bir döngü, döngü listesi veya döngü aralığı girebilirsiniz. Varsayılan döngü 1'dir. Örneğin, --scenario-numbers=1-3,5 1, 2, 3 ve 5. döngüleri çalıştırır.
--device-model	Testinizi çalıştırmak istediğiniz fiziksel cihaz (hangi kullanılabilir cihazları kullanabileceğinizi öğ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 bir liste girebilirsiniz. Örneğin: --timeout=200, 200 saniyeye kadar çalıştırıldığında testinizin sonlandırılmasını zorunlu kılar. --timeout=1h, bir saat çalıştıktan sonra testinizin sonlandırılmasını zorunlu kılar.

Örneğin, aşağıdaki komut iPhone 8 Plus'ta 1, 4, 6, 7 ve 8 döngülerini 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 dokümanlarını inceleyin.

Yerel olarak test çalıştırma

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

xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://

• instruments -s devices komutunu çalıştırarak simülasyon cihazınızın UDID'sini bulabilirsiniz.

• Yalnızca bir simülasyon aracı çalışıyorsa SIMULATOR_UDID yerine "booted" özel dizesini girin.

Testiniz birden fazla döngü içeriyorsa döngü numarasını scenario işaretine 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. 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, bir 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 tüm döngüler iptal edilir. Uygulamanızın AppDelegate'inde Test Lab tarafından kullanılan özel URL şemasını firebase-game-loop-complete ç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 başka döngü kalmadığında test sona erer.

Özel test sonuçlarını yazma

Oyun Döngüsü testinizi, cihazınızın dosya sistemine özel test sonuçları yazacak şekilde yapılandırabilirsiniz. Bu sayede, test çalışmaya başladığında Test Lab, sonuç dosyalarını test cihazınızdaki bir GameLoopsResults dizininde depolar (bu dizini kendiniz oluşturmanız gerekir). 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:

• Tüm sonuç dosyaları, dosya türü, boyutu veya miktarından bağımsız olarak yüklenir.

• Test Lab, testinizdeki tüm döngüler çalıştırılana kadar test sonuçlarınızı işlemez. Bu nedenle, testinizde çıkış yazan birden fazla döngü varsa 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üdeki 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 kodundaki 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];
       }
   }