Kiểm thử và gỡ lỗi ứng dụng

Bạn nên tạo ứng dụng thực hiện đơn hàng tại địa phương bằng các bước được mô tả ở trên, sau đó kiểm thử tính năng tích hợp nhà thông minh trên môi trường lưu trữ của riêng bạn bằng các bước sau:

  1. Trong môi trường lưu trữ của riêng bạn, hãy phân phát trang HTML chạy ứng dụng thực hiện đơn hàng cục bộ. Đoạn mã sau đây cho thấy ví dụ về tệp HTML tĩnh chạy ứng dụng thực hiện đơn hàng cục bộ.

    <html>
  <head>
    <!-- Local Home SDK -->
    <script src="//www.gstatic.com/eureka/smarthome/smarthome_sdk.js"></script>
    <!-- Local app under development -->
    <script src="local_execution.js"></script>
  </head>

</html>

  2. Kiểm thử chức năng điều khiển thiết bị.

  3. Gỡ lỗi từ Chrome. Sử dụng các điểm ngắt và nhật ký để khắc phục sự cố tích hợp.

  4. Sửa đổi và biên dịch mã TypeScript, sau đó lặp lại các bước này.

Bằng cách lặp lại quy trình xây dựng và kiểm thử này, bạn có thể nhanh chóng thấy được các thay đổi trong hoạt động và dễ dàng phát hiện cũng như gỡ lỗi các vấn đề với mã của mình.

Kiểm thử chức năng điều khiển thiết bị

Trong bảng điều khiển Hành động, bạn cần chỉ định URL của ứng dụng web. URL này sẽ phân phát HTML được tải trên thiết bị Google Home hoặc Google Nest trong quá trình thực hiện cục bộ.

Để kiểm thử chức năng kiểm soát thiết bị bằng phương thức thực hiện cục bộ, hãy làm theo các bước sau:

Chrome

  1. Mở dự án Nhà thông minh trong bảng điều khiển Hành động.
  2. Trong bảng điều hướng bên trái, hãy nhấp vào Thao tác.
  3. Trong phần Định cấu hình SDK nhà cục bộ (không bắt buộc) > Nhập URL thử nghiệm cho Chrome, hãy chỉ định URL máy chủ phát triển phân phát HTML chạy ứng dụng thực hiện đơn hàng cục bộ.
  4. Nhấp vào Lưu. Có thể mất đến 30 phút để Google truyền tải các thay đổi của bạn trên bảng điều khiển.
  5. Khởi động lại thiết bị Google Home hoặc Google Nest dùng để thử nghiệm.
  6. Ra lệnh cho thiết bị thông minh. Ví dụ: nếu thiết bị của bạn triển khai thuộc tính OnOff, bạn có thể nói "Ok Google, bật đèn".

Node.js

  1. Mở dự án Nhà thông minh trong bảng điều khiển Hành động.
  2. Trong bảng điều hướng bên trái, hãy nhấp vào Thao tác.
  3. Trong phần Configure local home SDK (optional) (Định cấu hình SDK trang chủ cục bộ (không bắt buộc)) > Enter your testing URL for Node (Nhập URL kiểm thử cho Node), hãy chỉ định URL máy chủ phát triển phân phát JavaScript chạy ứng dụng thực hiện đơn hàng cục bộ.
  4. Nhấp vào Lưu. Có thể mất đến 30 phút để Google truyền tải các thay đổi của bạn trên bảng điều khiển.
  5. Khởi động lại thiết bị Google Home hoặc Google Nest dùng để thử nghiệm.
  6. Ra lệnh cho thiết bị thông minh. Ví dụ: nếu thiết bị của bạn triển khai thuộc tính OnOff, bạn có thể nói "Ok Google, bật đèn".

Để biết thêm thông tin chi tiết về thời gian chạy mà thiết bị của bạn sử dụng, hãy xem phần Thiết bị được hỗ trợ.

Gỡ lỗi từ Chrome

Bạn có thể gỡ lỗi ứng dụng thực hiện đơn hàng cục bộ bằng Công cụ của Chrome cho nhà phát triển. Trước khi có thể gỡ lỗi, hãy đảm bảo rằng môi trường của bạn được thiết lập chính xác:

  • Bạn đã đặt URL phát triển trong bảng điều khiển thành một URL mà thiết bị Google Home hoặc Google Nest có thể truy cập (trên mạng cục bộ hoặc qua Internet),
  • Máy của bạn được kết nối với cùng một mạng cục bộ với thiết bị Google Home hoặc Google Nest mà bạn đang kiểm thử.
  • Mạng của bạn không chặn các gói giữa các thiết bị.
  • Bạn đã đăng nhập bằng cùng một Tài khoản Google trên Actions Console và trên thiết bị Google Home hoặc Google Nest.
  • Bạn đã cập nhật phản hồi SYNC trong quy trình thực hiện đơn hàng trên đám mây. Hàm này phải trả về ít nhất một giá trị hợp lệ trong trường otherDeviceIds.
  • Bạn đã nhập thông tin chính xác về cấu hình quét trong bảng điều khiển Hành động.

Để kết nối ứng dụng thực hiện cục bộ với trình gỡ lỗi Chrome DevTools, hãy làm theo các bước sau:

Chrome

  1. Trên máy phát triển cục bộ, hãy cài đặt và khởi chạy trình duyệt Google Chrome.
  2. Trong trường địa chỉ của trình duyệt Chrome, hãy khởi chạy trình kiểm tra Chrome bằng cách nhập: chrome://inspect#devices. Bạn sẽ thấy danh sách thiết bị trên trang và tệp HTML sẽ được liệt kê theo tên của thiết bị Google Home hoặc Google Nest thử nghiệm.
  3. Nhấp vào đường liên kết kiểm tra màu xanh dương bên dưới HTML để khởi chạy Công cụ của Chrome cho nhà phát triển. Chuyển sang thẻ Bảng điều khiển. Nền tảng Home Local sẽ xuất phiên bản ứng dụng và phiên bản SDK Home Local trong nhật ký bảng điều khiển. Nếu bạn thấy nhật ký, tức là Google đã tải thành công ứng dụng của bạn và có thể kết nối với ứng dụng đó. Nếu không, hãy khởi động lại thiết bị Google Home hoặc Google Nest.
    4. Hình 1: Ứng dụng thực hiện đơn hàng cục bộ trong chrome://inspect.

Node.js

  1. Trên máy phát triển cục bộ, hãy cài đặt và khởi chạy trình duyệt Google Chrome.
  2. Xác định địa chỉ IP cục bộ của thiết bị thử nghiệm.
  3. Trong trường địa chỉ của trình duyệt Chrome, hãy khởi chạy trình kiểm tra Chrome bằng cách nhập: chrome://inspect#devices.
  4. Chọn Configure... (Thiết lập…) để mở Target discovery settings (Cài đặt khám phá mục tiêu).
    5. Hình 2: Chế độ cài đặt khám phá mục tiêu trong chrome://inspect.
  5. Nhập DEVICE_IP_ADDRESS:9222 vào danh sách rồi nhấp vào Xong.
  6. Nhấp vào đường liên kết kiểm tra màu xanh dương bên dưới tập lệnh để khởi chạy Công cụ của Chrome cho nhà phát triển. Chuyển sang thẻ Bảng điều khiển. Nền tảng Home Local sẽ xuất phiên bản ứng dụng và phiên bản SDK Home Local trong nhật ký bảng điều khiển. Nếu bạn thấy nhật ký, tức là Google đã tải thành công ứng dụng của bạn và có thể kết nối với ứng dụng đó. Nếu không, hãy khởi động lại thiết bị Google Home hoặc Google Nest.

Để biết thêm thông tin chi tiết về thời gian chạy mà thiết bị của bạn sử dụng, hãy xem phần Thiết bị được hỗ trợ.

Mẹo gỡ lỗi

Sau đây là một số điều khác cần lưu ý trong quá trình gỡ lỗi:

  • Không liên kết nhiều thiết bị Google Home hoặc Google Nest với tài khoản thử nghiệm của bạn trên cùng một mạng cục bộ. Bạn sẽ không thể kiểm soát thiết bị Google Home hoặc Google Nest nào được nhắm đến bằng các lệnh thực hiện cục bộ.
  • Làm mới trang trong Chrome DevTools để tải lại vùng chứa ứng dụng thực hiện đơn hàng tại địa phương bằng mã mới nhất từ URL phát triển. Thao tác này không đặt lại nền tảng Nhà cục bộ. Bạn có thể cần đặt lại nền tảng này để kích hoạt lại ý định của nền tảng (chẳng hạn như IDENTIFY) trong ứng dụng thực hiện cục bộ. Để đặt lại nền tảng Nhà cục bộ, hãy khởi động lại thiết bị Google Home hoặc Google Nest.
  • Kiểm tra để đảm bảo ứng dụng JavaScript của bạn tải mà không gặp lỗi. Để thực hiện việc này, hãy kiểm tra phần bảng điều khiển của trang DevTools. Nếu có vấn đề, bạn sẽ thấy một thông báo như sau: Uncaught TypeError: Cannot read property ‘open’ of null.
  • verificationId từ phản hồi IDENTIFY phải khớp với một trong các otherDeviceIds từ phản hồi SYNC.
  • Đối với trình xử lý EXECUTE, hãy đảm bảo thiết bị của bạn có thể nhận được các lệnh HTTP, TCP hoặc UDP và hoạt động như mong đợi.
  • Hãy nhớ trả về Promise từ các trình xử lý.
  • Tránh duy trì trạng thái toàn cục trong bộ nhớ. Xem phần Vòng đời ứng dụng.
  • Các lỗi do ứng dụng thực hiện đơn hàng tại địa phương gửi sẽ xuất hiện trong nhật ký lỗi của dự án.

Chuẩn bị và phát hành công khai

Khi bạn đã sẵn sàng chạy Hành động nhà thông minh, hãy làm theo các bước sau:

  1. Mở một cửa sổ dòng lệnh. Trong thư mục dự án, hãy chạy lệnh npm run build. Lệnh này tạo các gói JavaScript sau cho ứng dụng của bạn trong thư mục dist:
    project-directory/
└── dist
 ├── web
 │    └── bundle.js
 └── node
      └── bundle.js
  2. Trong bảng điều khiển, hãy tải ứng dụng JavaScript lên bằng cách nhấp vào Develop (Phát triển) > Actions (Thao tác). Trong phần Định cấu hình SDK Trang chủ cục bộ, hãy nhấp vào Tải tệp JavaScript lên.
    Hình 3: Tải ứng dụng JavaScript lên.
  3. Trong hộp thoại Tải tệp lên, hãy tải các tệp gói mà bạn đã tạo trước đó lên. Hãy nhớ tải cả hai phiên bản của tệp gói (Node, Web) lên để Hành động của bạn được định cấu hình hoạt động chính xác trên tất cả môi trường thời gian chạy mà tính năng thực hiện cục bộ hỗ trợ.
    1. Tải JavaScript nhắm mục tiêu Node.js lên: Tải tệp bundle.js lên từ thư mục dist/node.
    2. Tải JavaScript nhắm mục tiêu Chrome (trình duyệt) lên: Tải tệp bundle.js lên từ thư mục dist/web.
  4. Kiểm thử Hành động của bạn trên một thiết bị có Trợ lý để xác minh rằng hành động đó hoạt động như dự kiến trong môi trường phát hành chính thức. Để tìm hiểu thêm, hãy xem bài viết Kiểm thử và chia sẻ Hành động nhà thông minh.
  5. Khi bạn hài lòng với cách hoạt động của Hành động, hãy gửi Hành động đó cho Google để triển khai công khai bằng cách làm theo hướng dẫn trong phần Ra mắt Hành động nhà thông minh. Bao gồm cả việc hoàn tất các bước tự kiểm thử và yêu cầu chứng nhận.
Trước
Triển khai ứng dụng thực hiện đơn hàng tại địa phương