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

Bạn nên tạo ứng dụng thực hiện tại địa phương theo các bước đã mô tả trước đó, sau đó kiểm thử việc tích hợp nhà thông minh trên môi trường lưu trữ của riêng bạn theo 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 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 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 soát thiết bị thử nghiệm.

3. Gỡ lỗi từ Chrome. Sử dụng đ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 của mình trong thực tế để gỡ lỗi cho mã.

Kiểm soát thiết bị thử nghiệm

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

Để kiểm tra khả năng điều khiển thiết bị bằng phương thức thực hiện tại địa phương, hãy làm theo các bước sau:

Để biết thêm thông tin chi tiết về môi trường 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 tại địa phương bằng Chrome DevTools. Trước khi gỡ lỗi, hãy đảm bảo rằng môi trường của bạn được thiết lập đúng cách:

• 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 thiết bị Google Nest có thể truy cập được (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ộ như thiết bị Google Home hoặc thiết bị Google Nest mà bạn đang thử nghiệm.
• Mạng của bạn không chặn các gói dữ liệu 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 Google Home Developer 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 phương thức thực hiện 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 cấu hình quét chính xác trong Google Home Developer Console.

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

Để biết thêm thông tin chi tiết về môi trường 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

Một số điều khác cần lưu ý trong quá trình gỡ lỗi bao gồm:

• Đừng liên kết nhiều thiết bị Google Home hoặc thiết bị 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 thiết bị Google Nest nào được nhắm mục tiêu bằng các lệnh thực hiện tại địa phương.
• Làm mới trang trong Chrome DevTools để tải lại vùng chứa ứng dụng phương thức thực hiện 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 Local Home, điều này có thể cần thiết để kích hoạt lại ý định của nền tảng (chẳng hạn như IDENTIFY) trong ứng dụng phương thức thực hiện tại địa phương. Để đặt lại nền tảng Local Home, hãy khởi động lại thiết bị Google Home hoặc thiết bị 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. Để làm việc này, hãy kiểm tra phần bảng điều khiển của trang Công cụ cho nhà phát triển. 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ừ trình xử lý.
• Tránh duy trì trạng thái chung trong bộ nhớ. Xem Vòng đời ứng dụng.
• 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à ra mắt bản phát hành công khai

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

1. Mở 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. Trên trang Thiết lập và định cấu hình của Google Home Developer Console, hãy di chuyển đến mục Thực hiện đơn hàng tại địa phương rồi bật chế độ cài đặt này.
3. Sử dụng nút Tải JavaScript lên để 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 để đảm bảo 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à phương thức thực hiện tại địa phương hỗ trợ.
   1. Tải JavaScript nhắm đến Node.js lên: Tải tệp bundle.js lên từ thư mục dist/node.
   2. Tải JavaScript nhắm đến 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ư mong đợi trong môi trường thực tế. Để 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 chính thức bằng cách làm theo hướng dẫn trong phần Ra mắt Hành động nhà thông minh. Điều này bao gồm việc hoàn tất các bước tự kiểm tra và yêu cầu chứng nhận.