Kiểm thử quá trình tích hợp Matter

Google Home Developer Console cung cấp trang Test (Kiểm thử) để bạn có thể định cấu hình và chạy kiểm thử dựa trên việc tích hợp Matter bằng cách sử dụng Google Home Test Suite. Test Suite là một ứng dụng riêng biệt được tích hợp vào Developer Console, có chức năng xử lý mọi hoạt động kiểm thử tích hợp.

Các thiết bị cho Mã nhà cung cấp và Mã sản phẩm của chức năng tích hợp phải được uỷ quyền và cung cấp trong Google Home app (GHA) cho tài khoản đang được sử dụng cùng với Developer Console để được kiểm thử. Hãy xem bài viết Ghép nối thiết bị theo chuẩn Matter để biết thêm thông tin.

Test Suite có thể chạy trên một nhóm thiết bị thuộc một cấu hình dự án Matter cụ thể. Việc chạy Test Suite trên(các) nội dung tích hợp là rất quan trọng để đảm bảo mọi thứ hoạt động đúng cách.

Trên trang Kiểm thử, các công cụ tích hợp Matter đã hoàn tất và sẵn sàng để kiểm thử sẽ được liệt kê trong phần Sẵn sàng kiểm thử.

Bạn có thể xem danh sách các chức năng tích hợp Matter đã được kiểm thử trong phần Đã kiểm thử.

Loại gói thử nghiệm

Có hai loại kế hoạch kiểm thử:

  • Kế hoạch kiểm thử Phát triển được dùng để kiểm thử các thiết bị điều khiển bằng Matter. Bạn có thể chỉnh sửa nhưng không thể gửi các giấy chứng nhận này để lấy chứng chỉ Matter.

  • Kế hoạch kiểm thử chứng nhận chỉ dành riêng cho chứng nhận Matter và không chỉnh sửa được. Khi chọn tuỳ chọn này, bạn sẽ tạo một phiên bản mới của chức năng tích hợp Matter.

Các phiên bản tích hợp

Khi bạn tạo kế hoạch kiểm thử để chứng nhận, một phiên bản mới của chức năng tích hợp sẽ được tạo. Phiên bản được đánh số này được liệt kê trong tất cả danh sách tích hợp trong Developer Console, từ thẻ Kiểm thử trở đi.

Phiên bản mới không bao giờ được tạo từ các phiên bản được đánh số khác. Ví dụ: kế hoạch kiểm thử đầu tiên mà bạn tạo cho quá trình tích hợp sẽ tạo phiên bản v.1 cho quá trình tích hợp đó. Việc tạo một kế hoạch kiểm thử khác sẽ tạo phiên bản v.2 để tích hợp đó, nhưng phiên bản này sẽ không dựa trên phiên bản 1. Thay vào đó, phiên bản này dựa trên thực thể chưa tạo phiên bản của chức năng tích hợp, giống như phiên bản 1.

Phiên bản Không áp dụng của một chế độ tích hợp đại diện cho thực thể chưa được tạo phiên bản của quá trình tích hợp. Bạn có thể quản lý hoạt động này trên thẻ Phát triển.

Nói cách khác, trên Matter > Kiểm thử trong Developer Console:

  • Nếu bạn nhấp vào Kiểm tra phiên bản Không áp dụng của chức năng tích hợp, thì một phiên bản mới sẽ được tạo. Số phiên bản sẽ cao hơn một số so với mọi phiên bản được đánh số hiện có.
    • Nếu không có phiên bản được đánh số nào, hệ thống sẽ tạo phiên bản v.1.
    • Nếu phiên bản v.1 tồn tại, phiên bản v.2 sẽ được tạo. Nếu phiên bản v.2 tồn tại, thì phiên bản v.3 sẽ được tạo, v.v.
  • Nếu bạn nhấp vào Kiểm thử để xem phiên bản được đánh số của chức năng tích hợp (ví dụ: v.1), thì phiên bản mới sẽ không được tạo. Thay vào đó, phiên bản v.1 sẽ được kiểm thử lại.

Để biết thêm thông tin, hãy xem bài viết Phiên bản tích hợp.

Tạo kế hoạch thử nghiệm

Các phiên bản tích hợp là thông tin tổng quan nhanh về quá trình tích hợp chưa có phiên bản. Điều này có nghĩa là khi bạn tạo kế hoạch kiểm thử để chứng nhận (và từ đó tạo ra một phiên bản tích hợp), tất cả siêu dữ liệu liên quan đến chức năng tích hợp đó phải là thông tin bạn muốn sử dụng cho nội dung tích hợp đã chạy.

Trước khi tạo kế hoạch kiểm thử để chứng nhận, hãy đảm bảo bạn đã làm những việc sau:

  1. Đã tạo hồ sơ công ty.
  2. Đã nhập Mã nhà cung cấp (VID) phát hành công khai để tích hợp.
  3. Thiết lập chế độ thiết lập và xây dựng thương hiệu.

Nếu chưa hoàn tất tất cả các bước này để tích hợp, bạn sẽ không thể chứng nhận phiên bản tích hợp được tạo để kiểm thử chứng nhận. Bạn sẽ phải tạo một phiên bản mới, tức là làm lại các bước Kiểm thử, Dùng thử thực tế và Chứng nhận.

Bạn cũng sẽ phải tạo một phiên bản mới và bắt đầu lại nếu muốn cập nhật bộ nhận diện thương hiệu trước khi chứng nhận phiên bản tích hợp.

Cách tạo kế hoạch thử nghiệm:

Chuyển đến Play Console

  1. Trong danh sách dự án, hãy nhấp vào Open (Mở) bên cạnh dự án bạn muốn xử lý.

  2. Trong trình đơn điều hướng ở bên trái của trang, hãy chuyển đến Matter > Test (Kiểm thử).

  3. Nhấp vào Kiểm tra phiên bản Không áp dụng của chế độ tích hợp mà bạn muốn kiểm tra. Hành động này tạo ra một phiên bản tích hợp mới.

  4. Chọn loại thử nghiệm là Kiểm tra phát triển hoặc Kiểm tra chứng nhận. Tạo kế hoạch thử nghiệm mới

    • Chọn Thử nghiệm chứng nhận nếu bạn đang chuẩn bị xin cấp giấy chứng nhận trong hệ sinh thái của Google.
    • Không thể dùng Bài kiểm tra về phiên bản phát triển để xin chứng nhận.
  5. Nhấp vào Kiểm tra. Nếu bạn thấy màn hình lỗi No device found (Không tìm thấy thiết bị nào) thì tức là một thiết bị dùng cho tính năng tích hợp này chưa được đưa vào hệ sinh thái. Vui lòng xem phần Khắc phục sự cố ghép nối để biết thêm thông tin.

  6. Trên màn hình Configure your test (Định cấu hình kiểm thử của bạn), hãy đặt tên cho kiểm thử và chọn những thiết bị bạn muốn kiểm thử trong danh sách thiết bị.

  7. Nhấp vào nút Tiếp theo: Kế hoạch thử nghiệm.

  8. Trên trang Tạo kế hoạch kiểm thử, trong phần Bộ kiểm thử, hãy chọn bộ kiểm thử mà bạn muốn chạy.

Tạo kế hoạch thử nghiệm

Nếu bạn muốn thoát khỏi Test Suite, hãy nhấp vào Quay lại Trung tâm dành cho nhà phát triển.

Chạy kế hoạch thử nghiệm

Trong Test Suite, trên trang Create a test plan (Tạo kế hoạch kiểm thử), hãy nhấp vào Run Test (Chạy hoạt động kiểm thử). Trang Môi trường kiểm thử xuất hiện, kèm theo trạng thái và nhật ký của tất cả các lượt kiểm thử.

Kết quả kiểm tra sẽ xuất hiện sau khi kiểm tra xong. Trạng thái của từng quá trình thực thi bộ thử nghiệm sẽ xuất hiện bên cạnh (Đạt, Không đạt).

Ngăn Logs (Nhật ký) cho thấy trạng thái của từng phiên chạy thử nghiệm riêng lẻ.

Kết quả kiểm tra

Để kiểm thử lại một kế hoạch kiểm thử trên trang Môi trường kiểm thử, hãy nhấp vào Kiểm thử lại ở trên cùng sau khi phiên chạy kiểm thử hoàn tất.

Sau khi hoàn tất:

Xem và diễn giải kết quả kiểm tra

Trên trang Test history (Nhật ký kiểm thử) trong Test Suite, bạn có thể xem kết quả kiểm thử trước đó cho kế hoạch phát triển hoặc kế hoạch kiểm thử chứng nhận chưa gửi bằng cách nhấp vào Retest (Kiểm thử lại) cho kế hoạch kiểm thử mong muốn trong phần Test Plan (Kế hoạch kiểm thử). Thao tác này sẽ đưa bạn đến trang Môi trường kiểm thử, nơi hiển thị kết quả của quá trình kiểm thử đó.

Nhật ký kiểm tra

Đối với kế hoạch chứng nhận đã gửi, hãy nhấp vào Kết quả trong phần Đã lưu để chứng nhận để xem báo cáo kết quả kiểm thử.

Bạn cũng có thể truy cập kết quả kiểm thử để lấy phiên bản tích hợp qua thẻ Test (Kiểm thử) trong Developer Console. Hãy nhấp vào Xem để xem Nhật ký kiểm tra của mọi phiên bản tích hợp được liệt kê trên trang đó để chuyển đến trang Nhật ký kiểm tra trong Test Suite.

Trạng thái của bảng điều khiển

Bạn sẽ gặp các trạng thái sau đây trên Play Console trong giai đoạn Kiểm thử:

Section Trạng thái Nội dung mô tả Yêu cầu Việc cần làm tiếp theo
Sẵn sàng để thử nghiệm Sẵn sàng Phiên bản integration này đã sẵn sàng để thử nghiệm. Không áp dụng Kiểm thử phiên bản integrationnày.
Đã kiểm tra Sẵn sàng Phiên bản integration này đã được thử nghiệm và bạn có thể gửi để tham gia Thử nghiệm thực tế hoặc cấp giấy chứng nhận.

Phiên bản đã được kiểm tra và lưu.

Tất cả các trường hợp kiểm thử không đạt đều có lý do để Google xem xét.

Kiểm tra lại (nếu muốn).

Khắc phục sự cố

Thiết bị được chỉ định không xuất hiện trong Bộ thử nghiệm

Nếu bạn đã ghép nối một thiết bị có Mã nhà cung cấp thử nghiệm (VID) và Mã sản phẩm (PID), nhưng mã này không xuất hiện khi bạn cố gắng kiểm thử thiết bị bằng Bộ thử nghiệm trong Developer Console, thì có thể là do bạn sử dụng cùng một tổ hợp VID và PID thử nghiệm cho nhiều chế độ tích hợp.

Để khắc phục sự cố, hãy xoá tất cả thiết bị kiểm thử khỏi Developer Console và ghép nối thiết bị bạn muốn kiểm thử lại.

Để xác thực rằng bạn đã ghép nối đúng thiết bị, bạn có thể đặt Thông tin nhà sản xuất và Kiểu máy (giá trị CHIP_DEVICE_CONFIG_DEVICE_*) cho thiết bị thành các giá trị duy nhất trong chương trình cơ sở kiểm thử.

Hãy xem bài viết Thông tin thiết bị để biết thêm thông tin.

Xác minh VID/PID của thiết bị

Nếu muốn bắt đầu phát triển công cụ tích hợp với Google, bạn phải tạo một dự án và công cụ tích hợp trên Google Home Console.

Khắc phục sự cố liên quan đến Bluetooth Sniffer

Giá trị VID/PID mà thiết bị của bạn đang báo hiệu phải khớp với VID/PID đã nhập vào dự án Developer Console.

  • VID 0xFFF10xFFF4 chỉ dành cho mục đích thử nghiệm. Các API này có thể được dùng cho các hoạt động kiểm thử và vận hành cơ bản, nhưng không thể dùng trong các giai đoạn phát triển sau đây:

Khi sử dụng một ứng dụng kỹ thuật Bluetooth như nRF Connect for Mobile, bạn có thể xem VID/PID của thiết bị báo hiệu trong trường Dữ liệu dịch vụ.

Trong ảnh chụp màn hình về phiên bản Android của nRF Connect, bạn sẽ thấy VID/PID được liệt kê là 5A23FFFE, bắt đầu từ byte thứ tư của trường Dữ liệu dịch vụ. Đây là mã cho biết VID của 5A23 và PID của FFFE – cả hai đều ở định dạng nhỏ cuối cùng.

Ứng dụng BLE hiển thị các giá trị theo thứ tự cuối nhỏ,nhưng các giá trị VID/PID mà bạn nhập vào dự án Developer Console lại ở mức cuối lớn.

Xác thực rằng bạn đã nhập các giá trị và định dạng phù hợp vào dự án trên Bảng điều khiển Thao tác dựa trên nội dung mà trình phát hiện Bluetooth đang hiển thị.

Đối với các giá trị trong ảnh chụp màn hình ví dụ, VID và PID trong Developer Console lần lượt sẽ là 235AFEFF.