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

Google Home Developer Console cung cấp trang Kiểm thử, nơi bạn có thể định cấu hình và chạy kiểm thử đối với hoạt động tích hợp Matter bằng Google Home Test Suite. Chiến lược phát hành đĩa đơn Test Suite là một ứng dụng riêng biệt được tích hợp sẵn Developer Console 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 tính năng tích hợp phải được ủy quyền và có sẵn trong Google Home app (GHA) cho tài khoản đang được dùng với Developer Console để được kiểm tra. Xem bài viết Ghép nối vấn đề thiết bị để biết thêm thông tin.

Test Suite có thể chạy trên một nhóm thiết bị thuộc về một cấu hình dự án Matter cụ thể. Bạn cần chạy Test Suite trên (các) công cụ tích hợp để đảm bảo mọi thứ đều hoạt động đúng cách.

Trên trang Thử nghiệm, Matter sản phẩm tích hợp hoàn tất và sẵn sàng để thử nghiệm được liệt kê trong phần Sẵn sàng để thử nghiệm.

Matter thành phần tích hợp đã được thử nghiệm được liệt kê trong phần Đã kiểm thử.

Loại kế hoạch kiểm thử

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

  • Các kế hoạch kiểm thử phát triển được dùng để kiểm thử việc kiểm soát các thiết bị 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 Matter.

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

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 tích hợp mới 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 thử nghiệm đầu tiên mà bạn tạo để tích hợp sẽ tạo phiên bản v.1 cho kế hoạch đó tích hợp. Việc tạo một kế hoạch kiểm thử khác sẽ tạo ra phiên bản v.2 cho kế hoạch đó tích hợp, nhưng phiên bản này sẽ không dựa trên v.1. Thay vào đó, phiên bản này được dựa trên phiên bản chưa tạo phiên bản của tích hợp, giống như v.1 trước đây.

Phiên bản Không áp dụng của chế độ tích hợp đại diện cho phiên bản chưa tạo phiên bản của quá trình tích hợp. Việc này được quản lý 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 thử cho phiên bản Không có của chế độ 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 thì phiên bản v.1 sẽ được tạo.
    • Nếu đã có phiên bản v.1 thì phiên bản v.2 sẽ được tạo. Nếu phiên bản v.2 tồn tại, phiên bản v.3 sẽ được tạo, v.v.
  • Nếu bạn nhấp vào Kiểm thử cho một phiên bản tích hợp được đánh số (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 là đã được kiểm tra lại.

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

Tạo kế hoạch kiểm thử

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 không có phiên bản. Điều này có nghĩa là khi bạn tạo một kế hoạch thử nghiệm để chứng nhận và do đó là tích hợp phiên bản, tất cả siêu dữ liệu có liên quan đến việc tích hợp đó phải là thông tin mà bạn muốn sử dụng cho tính năng tích hợp đã khởi chạy.

Trước khi tạo một kế hoạch thử nghiệm để cấp chứng chỉ, hãy đảm bảo rằng bạn đã hoàn tất sau đây:

  1. Đã tạo hồ sơ công ty.
  2. Đã nhập mã nhà cung cấp phiên bản chính thức (VID) để tích hợp.
  3. Đã thiết lập chế độ thiết lập và thương hiệu.

Nếu bạn chưa hoàn thành tất cả các bước này, hãy tích hợp phiên bản được tạo để thử nghiệm chứng nhận không thể được 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ử, Thử nghiệm thực địa 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 các thành phần xây dựng thương hiệu trước khi Google chứng nhận phiên bản tích hợp.

Cách tạo kế hoạch kiểm thử:

Truy cập Developer Console

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

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

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

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

    • Chọn Kiểm tra chứng chỉ nếu bạn đang chuẩn bị cho bài kiểm tra chứng chỉ trong hệ sinh thái của Google.
    • Không thể sử dụng Bài kiểm thử quá trình phát triển để chứng nhận.
  5. Nhấp vào Kiểm tra. Nếu bạn thấy màn hình lỗi Không tìm thấy thiết bị nào, tức là thiết bị dành cho việc tích hợp này chưa được đưa vào hệ sinh thái. Xem 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ử), hãy cung cấp tên cho kiểm thử và chọn các thiết bị bạn muốn kiểm thử trong danh sách thiết bị.

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

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

Tạo kế hoạch kiểm thử

Nếu bạn muốn thoát khỏi Test Suite, hãy nhấp vào Quay lại trang Nhà phát triển chính giữa.

Chạy kế hoạch kiểm thử

Trong Test Suite, từ trang Tạo kế hoạch thử nghiệm, nhấp vào Run Test (Chạy phép kiểm thử). Trang Môi trường thử nghiệm xuất hiện, với trạng thái và nhật ký của tất cả các lần kiểm thử.

Kết quả kiểm thử sẽ xuất hiện sau khi kiểm thử hoàn tất. Trạng thái của từng lần thực thi bộ kiểm thử sẽ xuất hiện bên cạnh (Đã vượt qua, Không thành công).

Ngăn Nhật ký cho biết trạng thái của từng lần thực thi kiểm thử riêng lẻ.

Kết quả kiểm tra

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

Sau khi hoàn tất:

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

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

Nhật ký kiểm thử

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

Bạn cũng có thể truy cập vào kết quả kiểm thử cho phiên bản tích hợp từ thẻ Kiểm thử trong Developer Console. Nhấp vào Xem để xem Nhật ký kiểm thử của bất kỳ phiên bản tích hợp nào được liệt kê trên trang đó để chuyển đến trang Nhật ký kiểm thử trong Test Suite.

Các trạng thái trên bảng điều khiển

Giai đoạn Kiểm thử sẽ có các trạng thái sau đây trên Console:

Section Trạng thái Nội dung mô tả Yêu cầu Việc nên làm tiếp theo
Sẵn sàng để thử nghiệm Sẵn sàng Phiên bản này của integration đã sẵn sàng để kiểm thử. Không áp dụng Kiểm thử phiên bản này của integration.
Đã kiểm tra Sẵn sàng Phiên bản này của integration đã được thử nghiệm và có thể gửi để Dùng thử tại chỗ 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 thành công đều bao gồm lý do cần xem xét.

Kiểm thử lại nếu muốn.

Khắc phục sự cố

Thiết bị được uỷ quyền không xuất hiện trong Bộ thử nghiệm

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

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

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

Xem Thông tin thiết bị để biết thêm của bạn.

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

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

Khắc phục sự cố với tính năng Sniffer qua Bluetooth

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 được nhập vào dự án Developer Console của bạn.

  • VID 0xFFF10xFFF4 được dành riêng cho mục đích thử nghiệm. Những cookie này có thể dùng để các thử nghiệm vận hành và kiểm soát cơ bản, nhưng không thể sử dụng chúng trong quá trình các giai đoạn phát triển sau:

Sử dụng một ứng dụng kỹ thuật Bluetooth, chẳng hạn như nRF Connect cho thiết bị di động, 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 này từ 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ụ. Biểu đồ này cho biết VID là 5A23 và PID là FFFE — cả ở định dạng nhỏ bé đuôi dài.

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

Kiểm tra để đảm bảo bạn đã nhập đúng giá trị và định dạng vào Hành động Dự án trên bảng điều khiển dựa trên nội dung mà trình theo dõi Bluetooth đang hiển thị.

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