測試應用程式並進行偵錯

建議您按照前述步驟建構當地執行要求應用程式，然後按照下列步驟，在自己的託管環境中測試智慧住宅整合：

1. 在自己的託管環境中，提供執行本機執行應用程式的 HTML 網頁。下列程式碼片段顯示執行本機執行應用程式的靜態 HTML 檔案範例。

   <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. 測試裝置控制。

3. 從 Chrome 偵錯。使用中斷點和記錄檔排解整合問題。

4. 修改並編譯 TypeScript 程式碼，然後重複上述步驟。

重複執行這項建構和測試程序，即可快速查看變更效果，協助您對程式碼問題進行偵錯。

測試裝置控制

在Google Home Developer Console中，您需要指定網頁應用程式的網址，該應用程式會提供在區域執行期間載入 Google Home 或 Google Nest 裝置的 HTML。

如要測試裝置控制功能與本機執行要求，請按照下列步驟操作：

如要進一步瞭解裝置使用的執行階段，請參閱「支援的裝置」。

透過 Chrome 偵錯

您可以使用 Chrome 開發人員工具對本機執行要求應用程式進行偵錯。偵錯前，請確認環境設定正確：

• 您已在控制台中將開發網址設為 Google Home 或 Google Nest 裝置可連上的網址 (透過區域網路或網際網路)，
• 您的機器與要測試的 Google Home 或 Google Nest 裝置連上相同的區域網路。
• 網路不會封鎖裝置之間的封包。
• Google Home Developer Console 和 Google Home 或 Google Nest 裝置登入的是同一個 Google 帳戶。
• 您已更新雲端執行中的 SYNC 回應。otherDeviceIds 欄位中應至少傳回一個有效值。
• 您已在 Google Home Developer Console 中輸入正確的掃描設定資訊。

如要將本機執行要求應用程式連結至 Chrome 開發人員工具偵錯工具，請按照下列步驟操作：

如要進一步瞭解裝置使用的執行階段，請參閱「支援的裝置」。

偵錯提示

偵錯時，請注意下列事項：

• 請勿在同一個區域網路上，將多個 Google Home 或 Google Nest 裝置連結至測試帳戶。您無法控制本機執行指令的目標 Google Home 或 Google Nest 裝置。
• 在 Chrome 開發人員工具中重新整理頁面，使用開發網址中的最新程式碼，重新載入本機執行要求應用程式容器。這項操作不會重設 Local Home 平台，但您可能需要重設，才能在本機執行應用程式中重新觸發平台意圖 (例如 IDENTIFY)。如要重設 Local Home 平台，請重新啟動 Google Home 或 Google Nest 裝置。
• 確認 JavaScript 應用程式載入時沒有錯誤。方法是查看開發人員工具頁面的控制台部分。如果發生問題，系統會顯示類似以下的訊息：「Uncaught TypeError: Cannot read property 'open' of null.」
• IDENTIFY 回應中的 verificationId 必須與 SYNC 回應中的其中一個 otherDeviceIds 相符。
• 請確認裝置可接收 EXECUTE 處理常式的 HTTP、TCP 或 UDP 指令，並正常運作。
• 請務必從處理常式傳回 Promise。
• 避免在記憶體中維護全域狀態。請參閱「應用程式生命週期」。
• 本機執行應用程式擲回的錯誤會顯示在專案錯誤記錄中。

準備並推出正式版

準備好推出智慧住宅動作時，請按照下列步驟操作：

1. 開啟終端機。在專案目錄中執行 npm run build 指令。這個指令會在 dist 目錄下，為應用程式產生下列 JavaScript 組合：

   project-directory/
   └── dist
    ├── web
    │    └── bundle.js
    └── node
         └── bundle.js
   

2. 在 Google Home Developer Console 的「Setup and configuration」(設定) 頁面中，捲動至「Local fulfillment」(本機執行)，然後開啟這項設定。
3. 使用「Upload JavaScript」按鈕，上傳先前產生的套件檔案。

   

   請務必上傳兩個版本的套件檔案 (Node、Web)，確保動作已正確設定，可在本機執行支援的所有執行階段環境中運作。
   1. 上傳 JavaScript 指定 Node.js：從 dist/node 目錄上傳 bundle.js 檔案。
   2. 上傳 JavaScript targeting Chrome (瀏覽器)：從 dist/web 目錄上傳 bundle.js 檔案。
4. 在支援 Google 助理的裝置上測試動作，確認在正式環境中是否能正常運作。詳情請參閱「測試及分享智慧住宅動作」。
5. 如果對動作的運作方式感到滿意，請按照「啟動智慧住宅動作」中的操作說明，將動作提交給 Google 進行正式環境部署。包括完成自我測試和認證要求步驟。