Kiểm thử bằng Google Cloud CLI

bookmark_border Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Hướng dẫn này mô tả cách chạy một XCTest hoặc một kiểm thử Vòng lặp trò chơi bằng cách sử dụ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

Điều này bao gồm cả công cụ gcloud CLI.

2. Đảm bảo rằng bản cài đặt của bạn là bản mới nhất và có 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. Đặt dự án Firebase của bạn trong gcloud, trong đó PROJECT_ID là mã dự án Firebase của bạn:

        gcloud config set project PROJECT_ID

Bước 2: Chạy thử nghiệm

Chạy XCTest

1. Tải tệp .zip của 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 thử nghiệm.

   Test Lab cho phép bạn chạy các 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à các phương diện kiểm thử của kiểm thử. Để xem các lựa 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 đơn giản hơn một chút, vì hướng này chỉ có các lựa chọn là portrait và landscape.

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

3. Sau khi chọn một nhóm các phương diện kiểm thử, bạn có thể để Test Lab chạy các kiểm thử bằng lệnh firebase test ios run. Đối với mỗi tổ hợp phương diện thử nghiệm mà bạn muốn thử nghiệm, 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ể kiểm thử của bạn sẽ không thành công do sự 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à Test Lab sử dụng. Để chỉ định phiên bản Xcode được hỗ trợ cho kiểm thử, 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ử trong bảng điều khiển Firebase, bạn có thể tuỳ ý gắn nhãn ma trận kiểm thử bằ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 thử nghiệm Vòng lặp trò chơi

Chạy lệnh gcloud beta firebase test ios run và dùng các cờ sau để định cấu hình lượt 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 hiện 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.

Bước 3 (Không bắt buộc): Tự động hoá các kiểm thử mà bạn sẽ tạo trong tương lai

Viết tập lệnh cho các lệnh gcloud bằng Test Lab

Bạn có thể sử dụng tập lệnh shell hoặc tệp hàng loạt để tự động hoá các lệnh kiểm thử ứng dụng di động mà bạn sẽ chạy bằng dòng lệnh gcloud. Tập lệnh bash mẫu này chạy một XCTest với thời gian chờ là 2 phút và báo cáo nếu quá trình chạy thử nghiệm 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

Test Lab 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 kiểm thử mà bạn chạy bằng tập lệnh hoặc tệp hàng loạt.

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

Khi bắt đầu kiểm tra, bạn sẽ nhận được một đường liên kết đến trang Kết quả kiểm tra. Các 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 mà bạn đã chọn và thời lượng hết thời gian chờ kiểm thử được đặt cho các kiểm thử của bạn. Sau khi các thử nghiệm chạy xong, bạn có thể xem xét kết quả thử nghiệm. Xem phần Phân tích kết quả Firebase Test Lab để tìm hiểu thêm về cách diễn giải kết quả thử nghiệm.

Bước tiếp theo

Đọc tài liệu về Google Cloud SDK để khám phá các lựa chọn kiểm thử được cung cấp công khai hoặc ở giai đoạn beta.