Kiểm thử bằng Google Cloud CLI

Hướng dẫn này mô tả cách chạy quy trình kiểm thử XCTest hoặc Vòng lặp trò chơi bằng gcloud CLI.

Bước 1: Định cấu hình môi trường Google Cloud SDK cục bộ

1. Tải Google Cloud SDK xuống

Trong đó có cả công cụ CLI của gcloud.

2. Đảm bảo bản cài đặt của bạn là phiên bản mới nhất và bao gồm lệnh gcloud firebase:

         gcloud components update

3. Đăng nhập vào gcloud CLI bằng Tài khoản Google của bạn:

         gcloud auth login

4. Thiết lập dự án Firebase của bạn trong gcloud, trong đó PROJECT_ID là mã dự án Firebase:

        gcloud config set project PROJECT_ID

Bước 2: Chạy kiểm thử

Chạy XCTest

1. Tải tệp .zip của bài kiểm thử lên bằng cách chạy lệnh sau (nếu bạn chưa đóng gói ứng dụng, hãy xem phần Đóng gói XCTest):

   cd FOLDER_WITH_TEST_OUTPUT/Build/Products ; \
   zip -r MyTests.zip Debug-iphoneos YOUR_SCHEME_iphoneosDEPLOYMENT_TARGET-arm64.xctestrun

2. Chọn phương diện kiểm thử.

   Phòng thử nghiệm cho phép bạn chạy kiểm thử trên nhiều phiên bản iOS, thiết bị, hướng màn hình và ngôn ngữ. Các cấu hình này được gọi là tham số kiểm thử của kiểm thử. Để xem các tuỳ chọn cho từng phương diện (ví dụ: các phiên bản Xcode được hỗ trợ cho phiên bản iOS của thiết bị), hãy thay thế models, versions hoặc locales cho dimension trong lệnh sau:

   gcloud firebase test ios dimension list

   Hướng màn hình có phần đơn giản hơn, vì các lựa chọn duy nhất là portrait và landscape.

   Xem qua danh sách phương diện kiểm thử và chọn một vài tổ hợp mà bạn muốn tiến hành kiểm thử. Truy cập vào phần Gói giá để xem số lượng tổ hợp quảng cáo tối đa bạn có thể chạy mỗi ngày.

3. Sau khi chọn một tập hợp thứ nguyên kiểm thử, bạn có thể yêu cầu Phòng thử nghiệm chạy các lượt kiểm thử của mình bằng lệnh firebase test ios run. Đối với mỗi tổ hợp phương diện kiểm thử mà bạn muốn kiểm thử, hãy thêm một cờ --device riêng:

   gcloud firebase test ios run --test PATH/TO/MyTests.zip \
    --device model=MODEL_ID_1,version=VERSION_ID_1,locale=LOCALE_1,orientation=ORIENTATION_1 \
    --device model=MODEL_ID_2,version=VERSION_ID_2,locale=LOCALE_2,orientation=ORIENTATION_2 \
    etc...

   Có thể chương trình kiểm thử của bạn sẽ không thành công do không tương thích giữa phiên bản Xcode mà kiểm thử được tạo và phiên bản Xcode mặc định mà Phòng thử nghiệm sử dụng. Để chỉ định một phiên bản Xcode được hỗ trợ cho thử nghiệm của bạn, hãy sử dụng cờ --xcode-version:

   gcloud firebase test ios run --test PATH/TO/MyTests.zip \
    --device model=MODEL_ID_1,version=VERSION_ID_1,locale=LOCALE_1,orientation=ORIENTATION_1 \
    --xcode-version=15

   Để giúp bạn xác định và định vị ma trận kiểm thử của mình trong bảng điều khiển của Firebase, bạn có thể tuỳ ý gắn nhãn ma trận kiểm thử bằng cách sử dụng cờ --client-details matrixLabel="<label>" trong ví dụ sau:

   gcloud beta firebase test ios run --test PATH/TO/MyTests.zip \
     --device model=MODEL_ID_1,version=VERSION_ID_1,locale=LOCALE_1,orientation=ORIENTATION_1 \
     --client-details matrixLabel="my label"

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

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

Cờ cho kiểm thử Vòng lặp trò chơi
--type	Bắt buộc: Chỉ định loại thử nghiệm iOS mà bạn muốn chạy. Bạn có thể nhập loại kiểm thử xctest (mặc định) hoặc game-loop.
--app	Bắt buộc: Đường dẫn tuyệt đối (GCS 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à các tình huống) bạn muốn chạy trong ứng dụng của mình. Bạn có thể nhập một vòng lặp, một danh sách hoặc các vòng lặp hoặc một loạt các vòng lặp. Vòng lặp mặc định là 1. Ví dụ: --scenario-numbers=1-3,5 chạy vòng lặp 1, 2, 3 và 5.
--device-model	Thiết bị thực mà bạn muốn chạy bài kiểm thử trên đó (tìm hiểu xem bạn có thể sử dụng thiết bị nào).
--timeout	Khoảng thời gian tối đa mà bạn muốn chạy chương trình 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à giá trị liệt kê để biểu thị thời lượng dưới dạng đơn vị thời gian dài hơn. Ví dụ: --timeout=200 buộc kiểm thử phải chấm dứt khi chạy được đến 200 giây. --timeout=1h buộc kiểm thử phải chấm dứt khi chạy được đến 1 giờ.

Ví dụ: lệnh sau đây chạy quy trình kiểm thử Vòng lặp trò chơi. Quy trình này sẽ thực thi 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.

Bước 3 (Không bắt buộc): Tự động hoá các thử nghiệm mà bạn xây dựng trong tương lai

Viết tập lệnh gcloud bằng Phòng thử nghiệm

Bạn có thể sử dụng các tập lệnh shell hoặc tệp lô để tự động hoá các lệnh kiểm thử ứng dụng di động mà bạn thường chạy bằng dòng lệnh gcloud. Tập lệnh bash mẫu này chạy XCTest với thời gian chờ là 2 phút và báo cáo nếu lượt chạy kiểm thử hoàn tất thành công:

if gcloud firebase test ios run --test MyTest.zip --timeout 2m
then
    echo "Test matrix successfully finished"
else
    echo "Test matrix exited abnormally with non-zero exit code: " $?
fi

Mã thoát của tập lệnh

Phòng thử nghiệm cung cấp một số mã thoát mà bạn có thể dùng để hiểu rõ hơn về kết quả của các chương trình kiểm thử mà bạn chạy bằng các tập lệnh hoặc tệp hàng loạt.

Mã thoát	Lưu ý
0	Đã vượt qua tất cả các lần chạy thử nghiệm.
1	Đã xảy ra lỗi chung. Các nguyên nhân có thể bao gồm: tên tệp không tồn tại hoặc lỗi HTTP/mạng.
2	Đã thoát khỏi quá trình kiểm thử do bạn đã cung cấp các lệnh hoặc đối số không xác định.
10	Một hoặc nhiều trường hợp kiểm thử (lớp hoặc phương thức lớp đã kiểm thử) trong quá trình thực thi kiểm thử không đạt.
15	Phòng thử nghiệm Firebase không thể xác định liệu ma trận thử nghiệm đạt hay không thành công do lỗi không mong muốn.
19	Người dùng đã huỷ ma trận kiểm thử.
20	Đã xảy ra lỗi kiểm thử cơ sở hạ tầng.

Bước 4: Điều tra kết quả thử nghiệm

Khi kiểm tra bắt đầu, bạn sẽ nhận được một đường liên kết đến trang Kết quả kiểm tra. Các bài kiểm thử có thể mất vài phút để chạy, tuỳ thuộc vào số lượng cấu hình khác nhau bạn đã chọn và khoảng thời gian chờ kiểm thử được đặt cho các kiểm thử của bạn. Sau khi thử nghiệm chạy xong, bạn có thể xem lại kết quả thử nghiệm. Hãy xem phần Phân tích kết quả trong Phòng thử nghiệm Firebase để tìm hiểu thêm về cách diễn giải kết quả kiểm thử.

Bước tiếp theo

Hãy đọc tài liệu về Google Cloud SDK để khám phá các tuỳ chọn kiểm thử thường có sẵn hoặc ở phiên bản beta.