Catch up on everthing we announced at this year's Firebase Summit. Learn more

Jalankan tes Game Loop

Mungkin sulit untuk mengotomatiskan pengujian game saat aplikasi game dibuat di kerangka kerja UI yang berbeda. Pengujian Game Loop memungkinkan Anda mengintegrasikan pengujian asli dengan Test Lab dan menjalankannya dengan mudah di perangkat yang Anda pilih. Panduan ini menjelaskan cara menyiapkan pengujian Game Loop untuk dijalankan menggunakan Firebase Test Lab.

Tentang tes Game Loop

Apa itu tes Game Loop?

Pengujian Game Loop mensimulasikan tindakan pemain sungguhan untuk memverifikasi bahwa game Anda berperforma baik untuk pengguna dengan cara yang cepat dan skalabel. Loop adalah uji coba penuh atau sebagian pada aplikasi game Anda. Anda dapat menjalankan pengujian Game Loop secara lokal pada simulator atau pada sekumpulan perangkat di Test Lab. Tes Game Loop dapat digunakan untuk:

  • Jalankan melalui permainan Anda sebagai pengguna akhir akan memainkannya. Anda dapat membuat skrip input pengguna, membiarkan pengguna menganggur, atau mengganti pengguna dengan AI (misalnya, jika Anda menerapkan AI dalam game balap mobil, Anda dapat menempatkan pengemudi AI yang bertanggung jawab atas input pengguna) .
  • Jalankan game Anda pada pengaturan kualitas tertinggi untuk mengetahui perangkat mana yang dapat mendukungnya.
  • Jalankan tes teknis, seperti mengkompilasi beberapa shader, menjalankannya, dan memeriksa apakah hasilnya seperti yang diharapkan.

Langkah 1: Skema URL kustom Registrasi Uji Lab

  1. Di Xcode, pilih target proyek.

  2. Klik tab Info, kemudian menambahkan jenis URL baru.

  3. Di bidang Skema URL, masukkan firebase-game-loop . Anda juga dapat mendaftar skema URL kustom dengan menambahkannya ke proyek Anda Info.plist file konfigurasi di mana saja dalam <dict> tag:

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

Aplikasi Anda sekarang dikonfigurasi untuk menjalankan pengujian menggunakan Test Lab.

Langkah 2: Opsional mengkonfigurasi aplikasi Anda

Jalankan beberapa loop

Jika Anda berencana untuk menjalankan beberapa loop (alias skenario) dalam pengujian, Anda harus menentukan loop mana yang ingin Anda jalankan di aplikasi Anda pada waktu peluncuran.

Dalam delegasi aplikasi Anda, menimpa application(_:open:options:) metode:

Cepat

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 &lt;UIApplicationOpenURLOptionsKey, id&gt; *)options {
  if ([url.scheme isEqualToString:(@"firebase-game-loop")]) {
      // ...Enter Game Loop Test logic to override application(_:open:options:).
  }
}

Saat Anda menjalankan beberapa loop dalam pengujian, loop saat ini diteruskan sebagai parameter ke URL yang digunakan untuk meluncurkan aplikasi. Anda juga dapat memperoleh jumlah loop arus oleh parsing URLComponents obyek yang digunakan untuk mengambil skema URL kustom:

Cepat

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

Akhiri tes lebih awal

Secara default, pengujian Game Loop terus berjalan hingga mencapai batas waktu lima menit, bahkan ketika semua loop telah dieksekusi. Ketika batas waktu tercapai, pengujian berakhir dan membatalkan semua loop yang tertunda. Anda dapat mempercepat pengujian atau mengakhirinya awal dengan memanggil skema URL kustom Uji Lab firebase-game-loop-complete di aplikasi Anda AppDelegate. Sebagai contoh:

Cepat

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

Pengujian Game Loop Anda mengakhiri loop saat ini dan mengeksekusi loop berikutnya. Ketika tidak ada lagi loop untuk dijalankan, tes berakhir.

Tulis hasil tes khusus

Anda dapat mengonfigurasi pengujian Game Loop untuk menulis hasil pengujian khusus ke sistem file perangkat Anda. Dengan cara ini, ketika tes mulai berjalan, Test Lab menyimpan file hasil dalam GameLoopsResults direktori pada pengujian perangkat Anda (yang Anda harus membuat diri Anda). Ketika tes berakhir, Test Lab bergerak semua file dari GameLoopResults direktori ke ember proyek Anda. Ingatlah hal-hal berikut saat menyiapkan pengujian Anda:

  • Semua file hasil diunggah terlepas dari jenis, ukuran, atau kuantitas file.

  • Test Lab tidak memproses hasil pengujian Anda hingga semua loop dalam pengujian Anda selesai berjalan, jadi jika pengujian Anda menyertakan beberapa loop yang menulis output, pastikan Anda menambahkannya ke file hasil unik atau membuat file hasil untuk setiap loop. Dengan cara ini, Anda dapat menghindari penimpaan hasil dari loop sebelumnya.

Untuk menyiapkan pengujian Anda untuk menulis hasil pengujian khusus:

  1. Dalam aplikasi Anda Documents direktori, membuat direktori bernama GameLoopResults .

  2. Dari mana saja dalam kode aplikasi Anda (misalnya, delegasi aplikasi Anda), tambahkan yang berikut ini:

    Cepat

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

Langkah 3: Paket aplikasi Anda untuk meng-upload

Terakhir, buat file IPA untuk aplikasi Anda (Anda harus menemukannya nanti).

  1. Di Xcode, pilih profil penyediaan untuk aplikasi target.

  2. Dari menu drop-down yang muncul, klik Produk> Arsip. Pilih arsip terbaru, kemudian klik Mendistribusikan App.

  3. Pada jendela yang muncul, klik Pembangunan> Next.

  4. Opsional: Untuk mendapatkan membangun lebih cepat, hapus Rebuild dari pilihan bitcode, lalu klik Berikutnya. Test Lab tidak memerlukan penipisan atau pembuatan ulang aplikasi Anda untuk menjalankan pengujian sehingga Anda dapat menonaktifkan opsi ini dengan aman.

  5. Klik Ekspor, kemudian masukkan direktori di mana Anda ingin men-download file IPA aplikasi Anda.

Langkah 4: Jalankan tes Anda secara lokal

Anda dapat menjalankan pengujian secara lokal untuk memeriksa perilakunya sebelum menjalankannya dengan Test Lab. Untuk menguji secara lokal, muat aplikasi game Anda di simulator dan jalankan:

xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://
  • Anda dapat menemukan simulator Anda UDID dengan menjalankan instruments -s devices perintah.

  • Jika hanya ada satu simulator berjalan, masukkan string khusus "booted" di tempat SIMULATOR_UDID .

Jika tes Anda berisi beberapa loop, Anda dapat menentukan lingkaran Anda ingin menjalankan dengan melewati jumlah loop ke scenario bendera. Perhatikan bahwa Anda hanya dapat menjalankan satu loop pada satu waktu saat menjalankan pengujian secara lokal. Misalnya, jika Anda ingin menjalankan loop 1, 2, dan 5, Anda harus menjalankan perintah terpisah untuk setiap loop:

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

Langkah berikutnya

Jalankan tes Anda menggunakan Firebase konsol atau CLI gcloud .