Với các kiểm thử Vòng lặp trò chơi, bạn có thể viết các kiểm thử gốc cho công cụ phát triển trò chơi của mình, sau đó chạy các kiểm thử đó 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 nhiều khung giao diện người dùng hoặc khung kiểm thử. Kiểm thử Vòng lặp trò chơi mô phỏng các hành động của người chơi thực và khi bạn chạy kiểm thử này trên Test Lab, kiểm thử này sẽ cung cấp một cách nhanh chóng và có thể 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 cho bạn biết cách chạy 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 sớm bài kiểm thử.
Kiểm thử vòng lặp trò chơi là gì?
Vòng lặp là quá trình chạy toàn bộ hoặc một phần kiểm thử trên ứng dụng trò chơi. Bạn có thể chạy kiểm thử Vòng lặp trò chơi trên máy 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ể sử dụng kiểm thử Vòng lặp trò chơi để:
Chạy qua trò chơi của bạn như cách người dùng cuối sẽ 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 đã triển khai AI trong trò chơi đua xe, bạn có thể đặt trình điều khiển AI phụ trách 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 chương trình đổ bóng, thực thi các chương trình đó và kiểm tra xem kết quả có như mong đợi không.
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ý lược đồ URL tuỳ chỉnh của Firebase Test Lab trong ứng dụng của mình:
Trong Xcode, hãy chọn một mục tiêu dự án.
Nhấp vào thẻ Thông tin, sau đó thêm một loại URL mới.
Trong trường URL Schemes (Lược đồ URL), hãy nhập
firebase-game-loop. Bạn cũng có thể đăng ký giao thức URL tuỳ chỉnh bằng cách thêm giao thức đó vào tệp cấu hìnhInfo.plistcủ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 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 đã đăng ký nhiều giao thức URL tuỳ chỉnh và bạn dự định chạy nhiều vòng lặp (còn gọi là các tình huống) trong 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 tại thời điểm khởi chạy.
Trong trình uỷ quyền ứng dụng, hãy ghi đè phương thức application(_:open:options:):
Swift
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 <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 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 giao thức URL tuỳ chỉnh:
Swift
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).
}
}
}
Bước 3: Tạo và chạy kiểm thử
Sau khi đăng ký giao thức URL tuỳ chỉnh của Test Lab, bạn có thể chạy chương trình kiểm thử trong bảng điều khiển Firebase hoặc bằng CLI gcloud beta. Tạo tệp IPA cho ứng dụng của bạn (nếu bạn chưa tạo) (bạn sẽ cần tìm tệp này sau).
Chạy kiểm thử trong bảng điều khiển Firebase
Mở bảng điều khiển Firebase rồi tạo một dự án nếu bạn chưa làm việc này.
Trên trang Test Lab của bảng điều khiển Firebase, hãy nhấp vào Run Your First Test > Run an iOS Game Loop (Chạy kiểm thử đầu tiên > Chạy vòng lặp trò chơi trên iOS).
Trong phần Upload App (Tải ứng dụng lên), hãy nhấp vào Browse (Duyệt qua), sau đó chọn tệp IPA của ứng dụng (nếu bạn chưa chọn, hãy tạo tệp IPA cho ứng dụng).
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à các tình huống) cùng một lúc hoặc chọn chạy nhiều vòng lặp cụ thể, 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 bất kỳ nội dung nào vào trường Scenarios (Tình huống)), Test Lab chỉ chạy vòng lặp 1.
Trong phần 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 Bắt đầu kiểm thử.
Chạy thử nghiệm bằng CLI beta của gcloud
Nếu bạn chưa làm như vậy, hãy định cấu hình môi trường SDK gcloud cục bộ, sau đó nhớ cài đặt thành phần gcloud beta.
Chạy lệnh
gcloud beta firebase test ios runvà sử dụng các cờ sau để định cấu hình quá trình chạy:
| Cờ cho kiểm thử Vòng lặp trò chơi | |
|---|---|
--type
|
Bắt buộc: Chỉ định loại kiểm thử iOS mà bạn muốn chạy. Bạn có thể nhập loại kiểm thử |
--app
|
Bắt buộc: Đường dẫn tuyệt đối (Google Cloud Storage hoặc hệ thống tệp) đến tệp IPA của ứng dụng. Cờ này chỉ hợp lệ khi chạy kiểm thử Vòng lặp trò chơi. |
--scenario-numbers
|
Các vòng lặp (còn gọi là tình huống) mà bạn muốn chạy trong ứng dụng. Bạn có thể nhập một vòng lặp, danh sách vòng lặp hoặc một dải vòng lặp. Vòng lặp mặc định là 1.
Ví dụ: |
--device-model
|
Thiết bị thực tế mà bạn muốn chạy kiểm thử (tìm hiểu xem bạn có thể sử dụng thiết bị nào). |
--timeout
|
Thời lượng tối đa bạn muốn chạy kiểm thử. Bạn có thể nhập một số nguyên để biểu thị thời lượng tính bằng giây hoặc một số nguyên và enum để biểu thị thời lượng dưới dạng một đơn vị thời gian dài hơn. Ví dụ:
|
Ví dụ: lệnh sau đây chạy 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ề Giao diện dòng lệnh (CLI) của gcloud, hãy xem tài liệu tham khảo.
Chạy kiểm thử cục bộ
Để chạy kiểm thử cục bộ, hãy tải ứng dụng trò chơi của bạn trong trình mô phỏng rồi 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 vì SIMULATOR_UDID.
Nếu 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 kiểm thử cục bộ. Ví dụ: nếu muốn chạy 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=1xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://?scenario=2xcrun simctl openurl SIMULATOR_UDID firebase-game-loop://?scenario=5
Kết thúc kiểm thử sớm
Theo mặc định, quy trình kiểm thử Vòng lặp trò chơi sẽ tiếp tục chạy cho đến khi hết 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 thời gian chờ kết thúc, 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 kiểm thử hoặc kết thúc sớm bằng cách gọi giao thức URL tuỳ chỉnh của Test Lab firebase-game-loop-complete trong AppDelegate của ứng dụng. Ví dụ:
Swift
/// 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) {}];
}
Kiểm thử Vòng lặp trò chơi sẽ chấm dứt 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, quá 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 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ử (mà bạn phải tự tạo). Khi kiểm thử kết thúc, Test Lab sẽ di chuyển tất cả tệp từ thư mục GameLoopResults sang bộ chứa của dự án. Khi thiết lập kiểm thử, hãy lưu ý những điều sau:
Tất cả tệp kết quả đều được tải lên bất kể loại tệp, kích thước hoặc số lượng.
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 kiểm thử chạy xong. Vì vậy, nếu kiểm thử của bạn bao gồm nhiều vòng lặp ghi kết quả, hãy đảm bảo bạn 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ừ vòng lặp trước.
Cách thiết lập chương trình kiểm thử để viết kết quả kiểm thử tuỳ chỉnh:
Trong thư mục
Documentscủa ứng dụng, hãy tạo một thư mục có tênGameLoopResults.Từ bất kỳ vị trí nào trong mã của ứng dụng (ví dụ: ứng dụng uỷ quyền), 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]; } }