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 quá trình 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 trong Developer Console, giúp 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 uỷ quyền và có sẵn trong Google Home app (GHA) cho tài khoản đang dù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 tập hợp các thiết bị thuộc 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ử.

Các công cụ tích hợp Matter đã được kiểm thử sẽ đượ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ử:

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

  • Các 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 bạn chọn tuỳ chọn này, một phiên bản mới của tính năng tích hợp Matter sẽ được tạo.

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, hệ thống sẽ tạo phiên bản mới của quá trình tích hợp. 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 cho quá trình tích hợp đó, nhưng phiên bản này sẽ không dựa trên v.2. 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 quá trình tích hợp, giống như v.1.

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

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

  • Nếu bạn nhấp vào Kiểm tra để xem phiên bản Không áp dụng của tích hợp, thì phiên bản mới sẽ được tạo. Số phiên bản sẽ cao hơn 1 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 thì phiên bản v.2 sẽ được tạo. Nếu có phiên bản v.2, thì hệ thống sẽ tạo phiên bản v.3, v.v.
  • Nếu bạn nhấp vào Kiểm thử cho một phiên bản được đánh số của công cụ tích hợp (ví dụ: v.1), thì phiên bản mới sẽ v.1 đượ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 Tạo phiên bản tích hợp.

Tạo gói 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 chưa được lập phiên bản. Điều này có nghĩa là khi bạn tạo một kế hoạch kiểm thử để chứng nhận và theo đó là một phiên bản tích hợp, tất cả siêu dữ liệu liên quan đến nội dung 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 đã khởi chạy.

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

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

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 được 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 địa và Chứng nhận.

Ngoài ra, bạn 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 chúng tôi chứng nhận phiên bản tích hợp.

Cách tạo gói thử nghiệm:

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 xử lý.

  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 tra để xem phiên bản Không áp dụng của chế độ tích hợp mà bạn muốn kiểm tra. Thao tác này sẽ tạo ra một phiên bản tích hợp mới.

  4. Chọn loại kiểm tra 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 Kiểm thử chứng nhận nếu bạn đang chuẩn bị cho bài đánh giá cấp giấy chứng nhận trong hệ sinh thái của Google.
    • Không thể sử dụng Bài kiểm tra phát triển để cấp chứng chỉ.
  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à thiết bị dùng để tích hợp này chưa được đưa vào hệ sinh thái. Hãy 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 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 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 các bộ kiểm thử mà bạn muốn chạy.

Tạo gói kiểm thử

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

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

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ử sẽ xuất hiện, cùng với 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 thử sẽ xuất hiện sau khi kiểm tra xong. Trạng thái của từng tệp thực thi của bộ kiểm thử sẽ xuất hiện bên cạnh tệp đó (Đạt, Không thành công).

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

Kết quả kiểm tra

Để kiểm thử lại một kế hoạch kiểm thử ở 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 thử nghiệm 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 Nhật ký kiểm thử trong Test Suite, bạn có thể xem kết quả kiểm thử trước đó của 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 được 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 phần Kế hoạch kiểm thử. Thao tác này sẽ đưa bạn đến trang Test Environment (Môi trường kiểm thử) hiển thị kết quả của lượt 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 vào kết quả kiểm thử cho phiên bản tích hợp từ thẻ Test (Kiểm thử) trong Developer Console. Hãy nhấp vào Xem để xem Nhật ký kiểm thử của mọi phiên bản tích hợp được liệt kê trên trang đó để được chuyển đến trang Nhật ký kiểm thử trong Test Suite.

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 Bảng điều khiển:

Section Trạng thái 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 này của integration đã được thử nghiệm và bạn có thể gửi để Dùng thử thực tế hoặc cấp chứng chỉ.

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

Tất cả trường hợp kiểm thử không thành công đều có 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ị đã 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ị với Mã nhà cung cấp kiểm thử (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 việc sử dụng cùng một tổ hợp VID và PID kiểm thử trên nhiều chế độ tích hợp.

Để khắc phục sự cố, hãy xoá mọi thiết bị thử nghiệm 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_*) của 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ố Bluetooth Sniffer

Giá trị VID/PID mà thiết bị của bạn đang hiển thị 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. Các API này có thể được dùng cho các hoạt động kiểm thử kiểm soát và vận hành cơ bản, nhưng không thể sử 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 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ụ. Điều này cho thấy VID của 5A23 và PID của FFFE – cả hai đều ở định dạng endian nhỏ.

Ứng dụng BLE hiển thị các giá trị theo thứ tự Endian nhỏ,nhưng các giá trị VID/PID mà bạn nhập vào dự án Developer Console lại ở dạng endian 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 Bảng điều khiển Actions dựa trên nội dung mà công cụ 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 sẽ lần lượt là 235AFEFF.