Chạy kiểm thử Vòng lặp trò chơi

Có thể khó tự động hoá quy trình kiểm thử trò chơi khi các ứng dụng trò chơi được tạo trên nhiều khung giao diện người dùng. Kiểm thử Vòng lặp trò chơi cho phép bạn tích hợp các kiểm thử gốc với Test Lab và dễ dàng chạy các kiểm thử đó trên thiết bị mà bạn chọn. Hướng dẫn này mô tả cách chuẩn bị một bài kiểm thử Vòng lặp trò chơi để chạy bằng Firebase Test Lab.

Giới thiệu về các bài kiểm thử Vòng lặp trò chơi

Thử nghiệm Vòng lặp trò chơi mô phỏng hành động của một người chơi thực để xác minh rằng trò chơi của bạn hoạt động hiệu quả cho người dùng theo cách nhanh chóng và có thể mở rộng. Vòng lặp là một quy trình chạy thử nghiệm đầy đủ hoặc một phần trên ứng dụng trò chơi của bạn. Bạn có thể chạy thử nghiệm Vòng lặp trò chơi cục bộ trên trình mô phỏng hoặc trên một nhóm thiết bị trong Test Lab. Bạn có thể dùng các kiểm thử Vòng lặp trò chơi để:

  • Chơi thử trò chơi của bạn như một người dùng cuối. Bạn có thể viết kịch bản cho hoạt động nhập của người dùng, để người dùng ở trạng thái không hoạt động hoặc thay thế người dùng bằng AI (ví dụ: nếu triển khai AI trong một trò chơi đua xe, bạn có thể đặt một trình điều khiển AI chịu trách nhiệm về hoạt động nhập của người dùng).
  • Chạy trò chơi ở chế độ cài đặt chất lượng cao nhất để biết những thiết bị có thể hỗ trợ trò chơi đó.
  • Chạy một quy trình kiểm thử kỹ thuật, chẳng hạn như biên dịch nhiều chương trình đổ bóng, thực thi các chương trình đó và kiểm tra để đảm bảo đầu ra như mong đợi.

Bước 1: Đăng ký giản đồ URL tuỳ chỉnh của Test Lab

  1. Trong Xcode, hãy chọn một mục tiêu dự án.

  2. Nhấp vào thẻ Thông tin, sau đó thêm một Loại URL mới.

  3. Trong trường URL Schemes (Lược đồ URL), hãy nhập firebase-game-loop. Bạn cũng có thể đăng ký giản đồ URL tuỳ chỉnh bằng cách thêm giản đồ đó vào tệp cấu hình Info.plist của dự án ở bất kỳ vị trí nào trong thẻ <dict>:

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

Ứng dụng của bạn hiện được định cấu hình để chạy một kiểm thử bằng Test Lab.

Bước 2: Định cấu hình ứng dụng (không bắt buộc)

Chạy nhiều vòng lặp

Nếu dự định chạy nhiều vòng lặp (còn gọi là tình huống) trong kiểm thử, bạn phải chỉ định những vòng lặp mà bạn muốn chạy trong ứng dụng tại thời điểm ra mắt.

Trong uỷ quyền ứng dụng, hãy ghi đè phương thức application(_:open:options:):

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

Khi chạy nhiều vòng lặp trong quá trình kiểm thử, vòng lặp hiện tại sẽ được truyền dưới dạng một tham số đến URL dùng để chạy ứng dụng. Bạn cũng có thể lấy số vòng lặp hiện tại bằng cách phân tích cú pháp đối tượng URLComponents dùng để tìm nạp giản đồ URL tuỳ chỉnh:

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

Kết thúc sớm một kiểm thử

Theo mặc định, một thử nghiệm Vòng lặp trò chơi sẽ tiếp tục chạy cho đến khi đạt đến thời gian chờ là 5 phút, ngay cả khi tất cả các vòng lặp đã được thực thi. Khi hết thời gian chờ, quá trình kiểm thử sẽ kết thúc và huỷ mọi vòng lặp đang chờ xử lý. Bạn có thể tăng tốc quá trình kiểm thử hoặc kết thúc sớm bằng cách gọi lược đồ URL tuỳ chỉnh Test Lab của firebase-game-loop-complete trong AppDelegate của ứng dụng. Ví dụ:

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

Thử nghiệm Vòng lặp trò chơi sẽ kết thúc vòng lặp hiện tại và thực thi vòng lặp tiếp theo. Khi không còn vòng lặp nào để chạy, quy trình kiểm thử sẽ kết thúc.

Viết kết quả kiểm thử tuỳ chỉnh

Bạn có thể định cấu hình kiểm thử Vòng lặp trò chơi để ghi kết quả kiểm thử tuỳ chỉnh vào hệ thống tệp của thiết bị. Bằng cách này, khi quá trình kiểm thử bắt đầu chạy, Test Lab sẽ lưu trữ các tệp kết quả trong thư mục GameLoopsResults trên thiết bị kiểm thử (bạn phải tự tạo thư mục này). Khi quá trình kiểm thử kết thúc, Test Lab sẽ di chuyển tất cả các tệp từ thư mục GameLoopResults sang nhóm của dự án. Khi thiết lập kiểm thử, hãy lưu ý những điều sau:

  • Tất cả các tệp kết quả đều được tải lên bất kể loại tệp, kích thước hay số lượng.

  • Test Lab sẽ không xử lý kết quả kiểm thử cho đến khi tất cả các vòng lặp trong kiểm thử của bạn đã chạy xong. Vì vậy, nếu kiểm thử của bạn có nhiều vòng lặp ghi đầu ra, hãy nhớ thêm các vòng lặp đó vào một tệp kết quả duy nhất hoặc tạo một tệp kết quả cho mỗi vòng lặp. Bằng cách này, bạn có thể tránh ghi đè kết quả từ một vòng lặp trước đó.

Cách thiết lập kiểm thử để ghi kết quả kiểm thử tuỳ chỉnh:

  1. Trong thư mục Documents của ứng dụng, hãy tạo một thư mục có tên là GameLoopResults.

  2. Từ bất kỳ vị trí nào trong mã của ứng dụng (ví dụ: uỷ quyền ứng dụng), hãy thêm nội dung sau:

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

Bước 3: Ký ứng dụng

  1. Đảm bảo rằng tất cả các cấu phần phần mềm trong ứng dụng đều được ký. Ví dụ: bạn có thể thực hiện việc này thông qua Xcode bằng cách chỉ định các chế độ cài đặt ký như hồ sơ cung cấp và danh tính. Để biết thêm thông tin, hãy xem: Ký mã của Apple

Bước 4: Đóng gói ứng dụng để tải lên

Tạo tệp IPA cho ứng dụng của bạn (sau này bạn sẽ cần tìm tệp này).

  1. Trong trình đơn thả xuống xuất hiện, hãy nhấp vào Sản phẩm > Lưu trữ. Chọn tệp lưu trữ gần đây nhất, rồi nhấp vào Phân phối ứng dụng.

  2. Trong cửa sổ xuất hiện, hãy nhấp vào Phát triển > Tiếp theo.

  3. Không bắt buộc: Để tạo bản dựng nhanh hơn, hãy bỏ chọn tuỳ chọn Rebuild from Bitcode (Tạo lại từ Bitcode), rồi nhấp vào Next (Tiếp theo). Test Lab không yêu cầu bạn giảm kích thước hoặc tạo lại ứng dụng để chạy thử nghiệm, vì vậy, bạn có thể tắt lựa chọn này một cách an toàn.

  4. Nhấp vào Xuất, sau đó nhập một thư mục mà bạn muốn tải tệp IPA của ứng dụng xuống.

Bước 5: Xác minh chữ ký ứng dụng

  1. Xác minh chữ ký ứng dụng bằng cách giải nén tệp .ipa rồi chạy codesign --verify --deep --verbose /path/to/MyApp.app, trong đó "MyApp" là tên của ứng dụng trong thư mục đã giải nén (thay đổi theo từng dự án). Kết quả đầu ra dự kiến là MyApp.app: valid on disk.

Bước 6: Chạy thử nghiệm cục bộ

Bạn có thể chạy thử nghiệm cục bộ để kiểm tra hành vi của thử nghiệm trước khi chạy thử nghiệm bằng Test Lab. Để kiểm thử cục bộ, hãy tải ứng dụng chơi trò chơi của bạn vào một trình mô phỏng rồi chạy:

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

  • Bạn có thể tìm UDID của trình mô phỏng bằng cách chạy lệnh instruments -s devices.

  • Nếu chỉ có một trình mô phỏng đang chạy, hãy nhập chuỗi đặc biệt "booted" thay cho SIMULATOR_UDID.

Nếu kiểm thử của bạn có nhiều vòng lặp, bạn có thể chỉ định vòng lặp mà bạn muốn chạy bằng cách truyền số vòng lặp đến cờ scenario. Xin lưu ý rằng bạn chỉ có thể chạy một vòng lặp tại một thời điểm khi chạy kiểm thử cục bộ. Ví dụ: nếu muốn chạy các vòng lặp 1, 2 và 5, bạn phải chạy một lệnh riêng cho từng vòng lặp:

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

Các bước tiếp theo

Chạy kiểm thử bằng bảng điều khiển Firebase hoặc giao diện dòng lệnh gcloud.