Bắt đầu với kiểm thử Game Loop dành cho iOS

Với các bài kiểm thử Vòng lặp trò chơi, bạn có thể viết các bài kiểm thử gốc cho công cụ phát triển trò chơi của mình, sau đó chạy chúng trong Test Lab trên các thiết bị mà bạn chọn. Bằng cách này, bạn không cần lo lắng về việc viết cho các khung kiểm thử hoặc giao diện người dùng khác nhau. Bài kiểm thử Vòng lặp trò chơi mô phỏng các hành động của một người chơi thực. Khi bạn chạy bài kiểm thử này trên Test Lab, bài kiểm thử sẽ cung cấp một cách nhanh chóng và có khả năng mở rộng để xác minh rằng trò chơi của bạn hoạt động tốt cho người dùng.

Trang này hướng dẫn bạn cách chạy bài kiểm thử Vòng lặp trò chơi, sau đó xem và quản lý kết quả kiểm thử trên trang Test Lab của bảng điều khiển Firebase. Bạn cũng có thể tuỳ chỉnh thêm các bài kiểm thử bằng các tính năng không bắt buộc, chẳng hạn như viết kết quả kiểm thử tuỳ chỉnh hoặc kết thúc bài kiểm thử sớm.

Bài kiểm thử Vòng lặp trò chơi là gì?

Vòng lặp là một lần chạy toàn bộ hoặc một phần bài kiểm thử trên ứng dụng trò chơi. Bạn có thể chạy bài kiểm thử Vòng lặp trò chơi cục bộ trên một trình mô phỏng hoặc trên một nhóm thiết bị trong Test Lab. Bạn có thể sử dụng bài kiểm thử Vòng lặp trò chơi để:

• Chạy trò chơi như cách người dùng cuối chơi. Bạn có thể viết tập lệnh cho dữ liệu đầu vào của người dùng, để người dùng ở trạng thái rảnh hoặc thay thế người dùng bằng AI (ví dụ: nếu bạn 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ề dữ liệu đầu vào của người dùng).

• Chạy trò chơi ở chế độ cài đặt chất lượng cao nhất để tìm hiểu xem thiết bị nào có thể hỗ trợ trò chơi.

• Chạy một bài kiểm thử kỹ thuật, chẳng hạn như biên dịch nhiều trình đổ bóng, thực thi các trình đổ bóng đó và kiểm tra để đảm bảo đầu ra đúng như dự kiến.

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

Trước tiên, bạn phải đăng ký Firebase Test Lab's lược đồ URL tuỳ chỉnh trong ứng dụng:

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

2. Nhấp vào thẻ Info (Thông tin), sau đó thêm một URL type (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ý lược đồ URL tuỳ chỉnh bằng cách thêm lược đồ đó vào tệp cấu hình của dự án ở bất kỳ vị trí nào trong thẻ <dict> tag:Info.plist

   <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 bài kiểm thử bằng Test Lab.

Bước 2 (không bắt buộc): Định cấu hình ứng dụng để chạy nhiều vòng lặp

Nếu ứng dụng của bạn có nhiều lược đồ URL tuỳ chỉnh đã đăng ký và bạn dự định chạy nhiều vòng lặp (còn gọi là tình huống) trong bài kiểm thử, thì bạn phải chỉ định những vòng lặp mà bạn muốn chạy trong ứng dụng khi khởi chạy.

Trong đại diện ứng dụng, hãy ghi đè phương thức application(_:open:options:):

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

Khi bạn chạy nhiều vòng lặp trong bài kiểm thử, vòng lặp hiện tại sẽ được truyền dưới dạng tham số đến URL dùng để khởi 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 lược đồ URL tuỳ chỉnh:

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

Bước 3: Tạo và chạy bài kiểm thử

Sau khi đăng ký lược đồ URL tuỳ chỉnh của Test Lab, bạn có thể chạy bài kiểm thử trong bảng điều khiển Firebase hoặc bằng CLI gcloud beta. Nếu chưa có, hãy tạo tệp IPA cho ứng dụng của bạn (bạn sẽ cần tìm tệp này sau).

Chạy bài kiểm thử trong bảng điều khiển Firebase

1. Nếu chưa có, hãy mở bảng điều khiển Firebase rồi tạo một dự án.

2. Trên trang Test Lab của bảng điều khiển Firebase, hãy nhấp vào Chạy bài kiểm thử đầu tiên > Chạy vòng lặp trò chơi iOS.

3. Trong phần Upload App (Tải ứng dụng lên), hãy nhấp vào Browse (Duyệt tìm), sau đó chọn tệp IPA của ứng dụng (nếu chưa có, hãy tạo tệp IPA cho ứng dụng của bạn).

4. Không bắt buộc: Nếu bạn muốn chạy nhiều vòng lặp (còn gọi là tình huống) cùng một lúc hoặc chọn các vòng lặp cụ thể để chạy, hãy nhập số vòng lặp vào trường Scenarios (Tình huống).

   Ví dụ: khi bạn nhập "1-3, 5", Test Lab sẽ chạy các vòng lặp 1, 2, 3 và 5. Theo mặc định (nếu bạn không nhập gì vào trường Scenarios), Test Lab chỉ chạy vòng lặp 1.

5. Trong phần Devices (Thiết bị), hãy chọn một hoặc nhiều thiết bị thực mà bạn muốn kiểm thử ứng dụng, sau đó nhấp vào Start Tests (Bắt đầu kiểm thử).

Chạy bài kiểm thử bằng CLI gcloud beta

1. Nếu chưa có, hãy định cấu hình môi trường gcloud SDK cục bộ, sau đó nhớ cài đặt thành phần gcloud beta.

2. Chạy lệnh gcloud beta firebase test ios run và sử dụng các cờ sau để định cấu hình lần chạy:

Ví dụ: lệnh sau đây chạy một bài kiểm thử Vòng lặp trò chơi thực thi các vòng lặp 1, 4, 6, 7 và 8 trên iPhone 8 Plus:

gcloud beta firebase test ios run
 --type game-loop --app path/to/my/App.ipa --scenario-numbers 1,4,6-8
 --device-model=iphone8plus

Để biết thêm thông tin về gcloud CLI, hãy xem tài liệu tham khảo.

Chạy bài kiểm thử cục bộ

Để chạy bài kiểm thử cục bộ, hãy tải ứng dụng trò chơi của bạn trong một trình mô phỏng và chạy:

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

• Bạn có thể tìm thấy 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 bài kiểm thử của bạn chứa 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 bài kiểm thử cục bộ. Ví dụ: nếu bạn 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 mỗi 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

Kết thúc bài kiểm thử sớm

Theo mặc định, bài kiểm thử Vòng lặp trò chơi 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 đạt đến thời gian chờ, bài 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 bài kiểm thử hoặc kết thúc sớm bằng cách gọi lược đồ URL tuỳ chỉnh firebase-game-loop-complete trong AppDelegate của ứng dụng.Test Lab Ví dụ:

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

Bài kiểm thử 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, bài 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 bài kiểm thử Vòng lặp trò chơi để viết 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 bài kiểm thử bắt đầu chạy, Test Lab sẽ lưu trữ các tệp kết quả trong một 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 bài kiểm thử kết thúc, Test Lab di chuyển tất cả các tệp từ thư mục GameLoopResults sang nhóm của dự án. Hãy lưu ý những điều sau khi thiết lập bài kiểm thử:

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

• Test Lab không xử lý kết quả kiểm thử cho đến khi tất cả các vòng lặp trong bài kiểm thử của bạn đã chạy xong. Vì vậy, nếu bài kiểm thử của bạn bao gồm nhiều vòng lặp ghi đầu ra, hãy đảm bảo bạn nối 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 bài kiểm thử để viết 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ụ: đại diện ứng dụng), hãy thêm nội dung sau:

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