Bắt đầu kiểm thử bằng gcloud CLI

Hướng dẫn này mô tả cách chạy kiểm thử đo lường, Robo hoặc Vòng lặp trò chơi bằng gcloud CLI.

Để biết danh sách đầy đủ các lệnh gcloud mà bạn có thể sử dụng với ứng dụng Android trong Test Lab, hãy truy cập vào tài liệu tham khảo về gcloud firebase test android.

Trước khi bắt đầu

Nếu bạn chưa thực hiện, hãy thêm Firebase vào dự án Android.

Bước 1. Thiết lập giao diện dòng lệnh (CLI) của gcloud

  1. Tải Google Cloud SDK xuống
  2. Trong đó có cả công cụ CLI của gcloud.

  3. Đảm bảo bản cài đặt của bạn đã được cập nhật:
    gcloud components update
    
  4. Đăng nhập vào CLI gcloud bằng Tài khoản Google của bạn:
    gcloud auth login
    
  5. Thiết lập dự án Firebase trong gcloud, trong đó PROJECT_ID là mã nhận dạng của dự án Firebase:
    gcloud config set project PROJECT_ID
    

Bước 2. Kiểm tra các thiết bị thử nghiệm hiện có

Dùng các lệnh gcloud sau để xem thiết bị thử nghiệm và ngôn ngữ có sẵn cho thử nghiệm của bạn.

Bạn cũng có thể tải mẫu xuống Ứng dụng Notepad để bắt đầu chạy các lệnh ngay lập tức. Sử dụng tệp nhị phân app-debug-unaligned.apk và tệp kiểm thử đo lường app-debug-test-unaligned.apk, nằm trong trong NotePad/app/build/outputs/apk/.

  • models list: Lấy danh sách thiết bị Android hiện có mà bạn có thể kiểm thử chống lại.

    gcloud firebase test android models list

    Trong dữ liệu đầu ra lệnh:

    • Cột MODEL_ID chứa giá trị nhận dạng mà sau này bạn có thể dùng để chạy chương trình kiểm thử trên mẫu thiết bị.
    • Cột OS_VERSION_ID chứa các phiên bản hệ điều hành được hỗ trợ theo thiết bị.

    Kết quả mẫu

    đầu ra của danh sách mô hình Android thử nghiệm gcloud firebase

  • models describe: Nhận thêm thông tin về một MODEL_ID Android cụ thể.

    gcloud firebase test android models describe MODEL_ID

    Dữ liệu đầu ra chứa thương hiệu, nhà sản xuất, phiên bản hệ điều hành, các cấp độ API được hỗ trợ, Giao diện nhị phân của ứng dụng (ABI) được hỗ trợ, ngày phát hành và liệu thiết bị là thiết bị thực hay ảo.

  • versions list: Lấy danh sách các phiên bản hệ điều hành hiện có để kiểm thử.

    gcloud firebase test android versions list

    Bạn có thể sử dụng giá trị nhận dạng từ một trong hai cột đầu tiên của kết quả lệnh (OS_VERSION_IDVERSION) để sau này chạy kiểm thử trên một phiên bản Android OS. Nếu bạn không chỉ định phiên bản hệ điều hành Android để kiểm thử, thì hệ thống sẽ sử dụng phiên bản mặc định được ghi chú trong cột TAGS.

    Kết quả mẫu

    danh sách phiên bản Android của gcloud

  • locales list: Lấy danh sách ngôn ngữ hiện có sẵn để kiểm thử.

    gcloud firebase test android versions list

    Cột đầu tiên của kết quả lệnh, LOCALE, chứa giá trị nhận dạng mà bạn có thể sử dụng sau này để chạy kiểm thử theo ngôn ngữ. Nếu bạn không chỉ định ngôn ngữ để kiểm thử, thì tiếng Anh sẽ được dùng làm ngôn ngữ mặc định.

Bước 3. Chạy kiểm thử

Giờ đây, khi đã biết phạm vi các mẫu thiết bị, ngôn ngữ và phiên bản hệ điều hành có sẵn để kiểm thử ứng dụng, bạn có thể chỉ định các thiết bị bằng lệnh gcloud firebase test android run và cờ --device để chạy kiểm thử đo lường hoặc Robo.

Chạy thử nghiệm Robo

Ngay cả khi không có chương trình kiểm thử đo lường nào, bạn vẫn có thể tìm lỗi trong ứng dụng. Hãy sử dụng chương trình kiểm thử Robo để tự động xem xét giao diện người dùng của ứng dụng. Thử nghiệm Robo tập luyện ứng dụng bằng cách thực hiện một thao tác tĩnh bạn có thể phân tích các đường dẫn khác nhau thông qua giao diện người dùng của ứng dụng, sau đó thu thập thông tin trong ứng dụng để tìm sự cố và các vấn đề tiềm ẩn khác.

Để chạy thử nghiệm Robo, hãy chạy lệnh mẫu sau:

gcloud firebase test android run \
  --type robo \
  --app app-debug-unaligned.apk \
  --device model=Nexus6,version=21,locale=en,orientation=portrait  \
  --device model=Nexus7,version=19,locale=fr,orientation=landscape \
  --timeout 90s \
  --client-details matrixLabel="Example matrix label"
  • Tham số --type robo được ngầm định nếu không có giá trị --type nào được chỉ định.
  • Cách xác định và định vị ma trận thử nghiệm trong bảng điều khiển của Firebase: bạn có thể sử dụng --client-details matrixLabel="Example matrix label" (không bắt buộc) gắn cờ để gắn nhãn ma trận thử nghiệm của bạn.
  • Bạn có thể xem tập hợp đầy đủ các tuỳ chọn dòng lệnh cho chạy bài kiểm thử bằng cách nhập: gcloud help firebase test android run.

Thay vì chỉ định các đối số này trên dòng lệnh, bạn có thể tuỳ ý chỉ định đối số trong tệp đối số có định dạng YAML. Chạy gcloud topic arg-files để tìm hiểu cách sử dụng tính năng này.

Để tìm hiểu cách điều tra kết quả kiểm thử từ kiểm thử Robo, hãy xem phần Phân tích kết quả kiểm thử.

Chạy bài kiểm thử đo lường

Bây giờ, hãy sử dụng công cụ dòng lệnh gcloud để chạy Espresso các bài kiểm thử cấu hình thiết bị Android đã chỉ định. Sử dụng Loại kiểm thử instrumentation để chạy các chương trình kiểm thử trong app-debug-test-unaligned.apk như sau:

gcloud firebase test android run \
  --type instrumentation \
  --app app-debug-unaligned.apk \
  --test app-debug-test-unaligned.apk \
  --device model=Nexus6,version=21,locale=en,orientation=portrait  \
  --device model=Nexus7,version=19,locale=fr,orientation=landscape
  --client-details matrixLabel="Example matrix label"
  • Tham số đo lường --type được ngầm định nếu APK kiểm thử được chỉ định cùng với --test.
  • Để giúp bạn xác định và định vị các ma trận kiểm thử trong bảng điều khiển Firebase, bạn có thể sử dụng cờ --client-details matrixLabel="Example matrix label" không bắt buộc để gắn nhãn cho ma trận kiểm thử.
  • Bạn có thể xem bộ tuỳ chọn dòng lệnh đầy đủ để chạy kiểm thử bằng cách nhập gcloud help firebase test android run.

Thay vì chỉ định các đối số này trên dòng lệnh, bạn có thể tuỳ ý chỉ định đối số trong tệp đối số có định dạng YAML. Chạy gcloud topic arg-files để tìm hiểu cách sử dụng tính năng này.

gcloud CLI hỗ trợ Android Test Orchestrator. Orchestrator yêu cầu AndroidJUnitRunner phiên bản 1.1 trở lên. Để bật chế độ này, hãy sử dụng gcloud firebase test android run bằng
--use-orchestrator cờ. Để tắt tính năng này, hãy sử dụng cờ --no-use-orchestrator.

Bạn cũng có thể kiểm soát cách Test Lab chạy kiểm thử đo lường bằng cách sử dụng các cờ bổ sung không hiển thị ở trên. Ví dụ: bạn có thể sử dụng Cờ --test-targets để kiểm thử một lớp hoặc phương thức lớp mà chương trình kiểm thử của bạn sử dụng APK. Bạn cũng có thể tìm hiểu xem liệu quy trình kiểm thử không thành công của bạn thực sự không ổn định hay không phải bằng cách sử dụng cờ --num-flaky-test-attempts. Cờ này chỉ định số lượng số lần thực thi lại kiểm thử nếu một hoặc nhiều trường hợp kiểm thử không thành công vì bất kỳ lý do gì. Để tìm hiểu thêm, hãy xem bài viết gcloud firebase test android run.

Báo cáo mức độ sử dụng mã cho kiểm thử đo lường

Test Lab hỗ trợ các công cụ báo cáo mức độ sử dụng mã EMMAJaCoCo. Nếu đã tích hợp một trong hai công cụ này vào bản dựng cho ứng dụng, bạn có thể nhận được báo cáo mức độ sử dụng mã cho các bài kiểm thử Test Lab bằng cách chạy gcloud firebase test android run với một số đối số bổ sung. Nếu bạn chưa bật Android Test Orchestrator, hãy sử dụng các bước sau:

gcloud firebase test android run \
  --type instrumentation \
  --app your-app.apk \
  --test your-app-test.apk \
  --device model=TestDevice,version=AndroidVersion  \
  --environment-variables coverage=true,coverageFile="/sdcard/Download/coverage.ec" \
  --directories-to-pull /sdcard/Download

Nếu bạn đang tạo báo cáo mức độ sử dụng mã trong khi đồng thời sử dụng Kiểm thử Android Orchestrator, hãy sửa đổi các biến môi trường của bạn như sau:

gcloud firebase test android run \
  --type instrumentation \
  --app your-app.apk \
  --test your-app-test.apk \
  --device model=TestDevice,version=AndroidVersion  \
  --environment-variables clearPackageData=true,coverage=true,coverageFilePath="/sdcard/Download/" \
  --directories-to-pull /sdcard/Download

Khi Test Lab chạy xong bài kiểm thử của bạn, hãy tìm báo cáo mức độ sử dụng mã trong Google Cloud Storage:

  1. Mở đường liên kết đến bảng điều khiển Firebase mà công cụ gcloud đã in phía trên bảng kết quả thử nghiệm trong thiết bị đầu cuối của bạn.
  2. Nhấp vào một lần thực thi kiểm thử trong danh sách tại đường liên kết đó để mở trang chi tiết của lần thực thi đó.
  3. Nhấp vào Kết quả kiểm tra để chuyển đến bộ chứa Cloud Storage có kết quả đó kết quả kiểm thử của phiên bản thực thi.
  4. Mở artifacts/coverage.ec để xem báo cáo mức độ sử dụng mã.

Phân tích kết quả kiểm thử

Sau vài phút, ứng dụng sẽ in bản tóm tắt cơ bản về kết quả kiểm tra của bạn công cụ gcloud:

Kết quả kiểm thử lệnh

Kết quả của lần chạy kiểm thử dòng lệnh cũng bao gồm một đường liên kết để xem bài kiểm thử kết quả. Để tìm hiểu thêm về cách diễn giải những kết quả này, hãy xem Đang phân tích Firebase Test Lab để tìm kết quả trên Android.

Nhập văn bản và đăng nhập tuỳ chỉnh bằng kiểm thử Robo

Thử nghiệm Robo tự động hoàn tất các màn hình đăng nhập dùng Tài khoản Google để xác thực, trừ khi bạn sử dụng --no-auto-google-login . Ứng dụng thử nghiệm cũng có thể hoàn tất các màn hình đăng nhập tuỳ chỉnh bằng tài khoản thử nghiệm thông tin đăng nhập mà bạn cung cấp. Bạn cũng có thể sử dụng thông số này để cung cấp tuỳ chỉnh văn bản nhập cho các trường văn bản khác mà ứng dụng của bạn sử dụng.

Để hoàn tất các trường văn bản trong ứng dụng, hãy sử dụng --robo-directives và cung cấp danh sách các cặp key-value được phân tách bằng dấu phẩy, trong đó key là tên tài nguyên Android của phần tử giao diện người dùng mục tiêu, còn value là chuỗi văn bản. Bạn cũng có thể sử dụng cờ này để yêu cầu Robo bỏ qua Thành phần trên giao diện người dùng (ví dụ: "đăng xuất"). EditText các trường được hỗ trợ nhưng không hỗ trợ trường văn bản trong phần tử WebView trên giao diện người dùng.

Ví dụ: bạn có thể sử dụng tham số sau đây để đăng nhập tuỳ chỉnh:

--robo-directives username_resource=username,password_resource=password

Lệnh và cờ có sẵn

Giao diện dòng lệnh (CLI) của Test Lab gcloud có sẵn một số lệnh và cờ cho phép bạn chạy thử nghiệm với các thông số kỹ thuật khác nhau:

Đang viết tập lệnh gcloud bằng Test Lab

Bạn có thể sử dụng các 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. Nội dung sau đây tập lệnh bash mẫu chạy một bài kiểm thử đo lường với thời gian chờ là 2 phút và nếu lần chạy thử nghiệm hoàn tất thành công:

if gcloud firebase test android run --app my-app.apk --test my-test.apk --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ể sử dụng để hiểu rõ hơn về kết quả kiểm thử mà bạn chạy bằng tập lệnh hoặc tệp hàng loạt.

Viết tập lệnh cho mã thoát cho Test Lab

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 một kiểm thử không đạt.
15 Firebase Test Lab không thể xác định liệu ma trận thử nghiệm có vượt qua hay không không thành công do lỗi không mong muốn.
18 Môi trường thử nghiệm cho lần chạy thử nghiệm này không được hỗ trợ do các phương diện thử nghiệm không tương thích. Lỗi này có thể xảy ra nếu API Android đã chọn không được loại thiết bị đã chọn hỗ trợ.
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.