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

Oyun uygulamaları farklı kullanıcı arayüzü çerçeveleri üzerine inşa edildiğinde oyun testini otomatikleştirmek zor olabilir. Game Loop testleri, yerel testlerinizi Test Lab ile entegre etmenize ve seçtiğiniz cihazlarda kolayca çalıştırmanıza olanak tanır. Bu kılavuzunda, Firebase Test Lab kullanılarak çalıştırılacak bir Oyun Döngüsü testinin nasıl hazırlanacağı açıklanmaktadır.

Oyun Döngüsü testleri hakkında

1. Adım: Test Lab ö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> 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 ile test çalıştıracak şekilde yapılandırılmış.

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 senaryolar) çalıştırmayı planlıyorsanız çalıştırmak istediğiniz döngüleri görebilirsiniz.

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

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 <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:

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

Testi erken sonlandırma

Oyun Döngüsü testi varsayılan olarak zaman aşımına ulaşılana kadar çalışmaya devam eder beş dakikayı geçmeyecek şekilde ayarlayabilirsiniz. ulaşıldığında test sonlandırılır ve beklemedeki döngüler iptal edilir. Uygulamanızın AppDelegate sınıfında Test Lab'ın özel URL şemasını firebase-game-loop-complete çağırarak testinizi hızlandırabilir veya erken sonlandırabilirsiniz. Örneğin:

/// 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 uygulamanıza özel test sonuçlarını yazacak şekilde cihazın dosya sisteminden emin olun. 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, taşınır. GameLoopResults dizinindeki tüm dosyaları projenizin paketine aktarın. Sakla testinizi oluştururken aşağıdakileri göz önünde bulundurun:

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

• Test Lab, test sayfanızdaki tüm döngüler tamamlanana kadar test sonuçlarınızı işlemez. Bir testin çalışması tamamlandığında, testinizde bunları benzersiz bir sonuç dosyasına eklediğinizden veya bir dosyası oluşturabilirsiniz. Bu şekilde, bir kaynaktan alınan sonuçların üzerine yazmaktan son döngüde olacaktır.

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

1. Uygulamanızın Documents dizininde GameLoopResults.

2. Uygulamanızın kodunda herhangi bir yere (ör. uygulama temsilcinizin) takip etmek için:

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

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

1. Uygulamadaki tüm yapıların imzalandığından emin olun. Örneğin, şunları yapabilirsiniz: temel hazırlık profili ve kimlik gibi imzalama ayarlarını belirleyerek Xcode üzerinden erişebilirsiniz. Daha fazla bilgi için: Apple Kod İmzası

4. Adım: Uygulamanızı yükleme için paketleyin

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

1. Görüntülenen açılır menüde Ürün > Arşivleyin. En son arşivi seçin ve Uygulamayı Dağıt'ı tıklayın.

2. Görüntülenen pencerede Geliştirme > Sonraki.

3. İsteğe bağlı: Daha hızlı bir derleme oluşturmak için Bit kodundan yeniden derle seçeneğini, ardından İleri'yi tıklayın. Test Lab, test çalıştırmak için uygulamanızı inceltmenizi veya yeniden oluşturmanızı gerektirmez. Bu nedenle, bu seçeneği güvenle devre dışı bırakabilirsiniz.

4. Export'u (Dışa Aktar) tıklayın, ardından indirmek istediğiniz dizini girin. uygulamanızın IPA dosyasına gidin.

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

1. Uygulama imzasını doğrulamak için .ipa dosyasını açın ve "Uygulamam" adlı codesign --verify --deep --verbose /path/to/MyApp.app dosyasını çalıştırın. sıkıştırılmış klasörün içindeki uygulama adıdır (her proje için değişiklik gösterir). Beklenen çıkış: MyApp.app: valid on disk.

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

Testinizi yerel olarak çalıştırarak davranışını kontrol etmek için Test Lab Yerel olarak test etmek için oyun uygulamanızı bir simülasyon aracında yükleyip şu komutu çalıştırın:

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

• Simülatörünüzün UDID'sini şu komutu çalıştırarak bulabilirsiniz: instruments -s devices komutudur.

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

Testiniz birden fazla döngü içeriyorsa hangi döngüyü çalıştırmak istediğinizi belirtebilirsiniz döngü numarasını scenario işaretine ileterek. Şunları yapabilirsiniz: Testinizi yerel olarak çalıştırırken aynı anda yalnızca bir döngü çalıştırın. Örneğin, döngüyü ç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.