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

Oyun uygulamaları farklı kullanıcı arayüzü çerçevelerinde oluşturulduğunda oyun testini otomatikleştirmek zor olabilir. Game Loop testleri, yerel testlerinizi Test Lab ile entegre etmenize ve bunları seçtiğiniz cihazlarda kolayca çalıştırmanıza olanak tanır. Bu kılavuzda, Firebase Test Lab kullanılarak çalıştırılacak bir Game Loop testinin nasıl hazırlanacağı açıklanmaktadır.

Oyun Döngüsü testleri hakkında

Game Loop testi, oyununuzun kullanıcılarınız için hızlı ve ölçeklenebilir bir şekilde iyi performans gösterdiğini doğrulamak amacıyla gerçek bir oyuncunun işlemlerini simüle eder. Döngü, oyun uygulamanızdaki testinizin tam veya kısmi bir çalıştırılmasıdır. Oyun döngüsü testini yerel olarak bir simülatörde ya da Test Lab içindeki bir cihaz grubunda çalıştırabilirsiniz. Oyun Döngüsü testleri şu amaçlarla kullanılabilir:

  • Oyununuzu son kullanıcı gibi oynayarak test edin. Kullanıcının girişini komut dosyasıyla yazabilir, kullanıcının boşta kalmasına izin verebilir veya kullanıcıyı yapay zekayla değiştirebilirsiniz (örneğin, araba yarışı oyununda yapay zeka uyguladıysanız kullanıcının girişinden sorumlu bir yapay zeka sürücüsü atayabilirsiniz).
  • Hangi cihazların oyununuzu destekleyebileceğini öğrenmek için oyununuzu en yüksek kalite ayarında çalıştırın.
  • Birden fazla gölgelendiriciyi derleme, bunları yürütme ve çıktının beklendiği gibi olup olmadığını kontrol etme gibi teknik bir test yapın.

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

  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ına <dict> etiketi 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: İsteğe bağlı olarak uygulamanızı yapılandırın

Birden fazla döngü çalıştırma

Testinizde birden fazla döngü (diğer adıyla senaryo) çalıştırmayı planlıyorsanız uygulamanız başlatıldığında hangi döngüleri çalıştırmak istediğinizi belirtmeniz gerekir.

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

SwiftObjective-C 
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
}

- (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 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ı elde edebilirsiniz:

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

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

Bir 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 bir 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'nin özel URL şemasını firebase-game-loop-complete çağırarak testinizi hızlandırabilir veya erken sonlandırabilirsiniz. Örneğin:

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

- (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 bir 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ı yazma

Oyun döngüsü testinizi, özel test sonuçlarını cihazınızın dosya sistemine yazacak şekilde yapılandırabilirsiniz. Bu sayede test çalışmaya başladığında Test Lab, sonuç dosyalarını test cihazınızda GameLoopsResults dizinine (kendiniz oluşturmanız gerekir) kaydeder. Test sona erdiğinde Test Lab, GameLoopResults dizinindeki tüm dosyaları projenizin paketi içine taşır. Testinizi ayarlarken aşağıdaki noktaları 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ı bitirene kadar test sonuçlarınızı işlemez. Bu nedenle, testinizde çıktı 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 döngüdeki sonuçların üzerine yazılmasını önleyebilirsiniz.

Özel test sonuçları yazmak için testinizi ayarlamak üzere:

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

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

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

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

3. adım: Uygulamanızı imzalayın

  1. Uygulamadaki tüm yapıtların imzalandığından emin olun. Örneğin, bunu, sağlama profili ve kimlik gibi imzalama ayarlarını belirterek Xcode üzerinden yapabilirsiniz. Daha fazla bilgi için Apple Codesigning (Apple Kod İmzalama) başlıklı makaleyi inceleyin.

4. adım: Uygulamanızı yüklemeye hazır hale getirin

Uygulamanız için bir IPA dosyası oluşturun (daha sonra bu dosyayı bulmanız gerekir).

  1. Görüntülenen 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.

  2. Açılan pencerede Geliştirme > İleri'yi tıklayın.

  3. İsteğe bağlı: Daha hızlı bir derleme elde etmek için Bitcode'dan yeniden oluştur seçeneğinin işaretini kaldırın ve Sonraki'yi tıklayın. Test Lab test çalıştırmak için uygulamanızın inceltilmesini veya yeniden oluşturulmasını gerektirmez. Bu nedenle, bu seçeneği güvenle devre dışı bırakabilirsiniz.

  4. Dışa aktar'ı tıklayın, ardından uygulamanızın IPA dosyasını indirmek istediğiniz dizini girin.

5. adım: Uygulama imzasını doğrulayın

  1. .ipa dosyasının sıkıştırmasını açıp codesign --verify --deep --verbose /path/to/MyApp.app komutunu çalıştırarak uygulama imzasını doğrulayın. Burada "MyApp", sıkıştırması açılan klasördeki uygulamanın adıdır (her proje için farklılık gösterir). Beklenen çıktı MyApp.app: valid on disk.

6. adım: Testinizi yerel olarak çalıştırın

Testinizi Test Lab ile çalıştırmadan önce davranışını kontrol etmek için yerel olarak çalıştırabilirsiniz. Yerel olarak test etmek 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://

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

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

Testinizde birden fazla döngü varsa scenario işaretine döngü numarasını 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

Sonraki adımlar

Testinizi Firebase konsolunu veya gcloud KSA'yı kullanarak çalıştırın.