測試應用程式並進行偵錯

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

在您的代管環境中，提供執行本機執行要求應用程式的 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>

測試裝置控制。
透過 Chrome 進行偵錯。使用中斷點和記錄檔來排解整合問題。
修改及編譯 TypeScript 程式碼，然後重複執行這些步驟。

只要重複這項建構與測試程序，您就能快速輕鬆地查看實際動作變更，並輕鬆找出程式碼問題並進行偵錯。

測試裝置控制功能

您必須在動作主控台中指定網頁應用程式的網址，該網址可提供在本機執行要求期間載入至 Google Home 或 Google Nest 裝置上的 HTML。

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

Chrome

在動作主控台中開啟智慧型住宅專案。
在左側導覽面板中按一下「動作」。
在「設定本機主 SDK (選用)」 >「輸入 Chrome 的測試網址」下方，指定開發伺服器網址，用於提供執行本機執行要求應用程式的 HTML。
按一下「儲存」，Google 最多可能需要 30 分鐘才能傳播您的控制台變更。
重新啟動 Google Home 或 Google Nest 測試裝置。
對智慧型裝置發出指令。舉例來說，如果裝置實作了「OnOff」OnOff特徵，您可以說出「Ok Google，開燈」。

Node.js

在動作主控台中開啟智慧型住宅專案。
在左側導覽面板中按一下「動作」。
在「Configure local Home SDK (optional)」 >「Enter your test URL for Node」下方，指定開發伺服器網址，用於提供執行本機執行要求應用程式的 JavaScript。
按一下「儲存」，Google 最多可能需要 30 分鐘才能傳播您的控制台變更。
重新啟動 Google Home 或 Google Nest 測試裝置。
對智慧型裝置發出指令。舉例來說，如果裝置實作了「OnOff」OnOff特徵，您可以說出「Ok Google，開燈」。

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

透過 Chrome 偵錯

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

您已在主控台中將開發網址設定為 Google Home 或 Google Nest 裝置可存取的網址 (無論位置是區域網路還是透過網際網路)。
電腦連線到與測試用的 Google Home 或 Google Nest 裝置相同的區域網路。
您的網路不會封鎖裝置之間的封包。
您已在 Actions 主控台和 Google Home 或 Google Nest 裝置上登入同一個 Google 帳戶。
您已更新 Cloud 執行要求中的 SYNC 回應。它應該會在 otherDeviceIds 欄位中傳回至少一個有效值。
您已在「Actions」(動作) 控制台中輸入正確的掃描設定資訊。

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

Chrome

在本機開發機器中，安裝並啟動 Google Chrome 瀏覽器。
在 Chrome 瀏覽器的網址欄位中，輸入 chrome://inspect#devices 以啟動 Chrome 檢查器。網頁上的裝置清單應該會列出您的 HTML 檔案，且您的 HTML 檔案應列在 Google Home 或 Google Nest 測試裝置的名稱下方。
按一下 HTML 下方的藍色檢查連結，啟動 Chrome 開發人員工具。切換至「Console」分頁。Local Home 平台會在主控台記錄中輸出應用程式版本和 Local Home SDK 版本。如果您看到記錄檔，表示 Google 已成功載入您的應用程式並可連線至應用程式。否則，請重新啟動 Google Home 或 Google Nest 裝置。

Node.js

在本機開發機器中，安裝並啟動 Google Chrome 瀏覽器。
確定測試裝置的本機 IP 位址。
在 Chrome 瀏覽器的網址欄位中，輸入 chrome://inspect#devices 以啟動 Chrome 檢查器。
選取「設定...」，開啟「目標探索設定」。

在清單中輸入 DEVICE_IP_ADDRESS:9222，然後按一下「Done」(完成)。
按一下指令碼下方的藍色檢查連結，即可啟動 Chrome 開發人員工具。切換至「Console」分頁。Local Home 平台會在主控台記錄中輸出應用程式版本和 Local Home SDK 版本。如果您看到記錄檔，表示 Google 已成功載入您的應用程式並可連線至應用程式。否則，請重新啟動 Google Home 或 Google Nest 裝置。

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

偵錯提示

偵錯時，請注意以下幾點：

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

準備及發布正式版

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

開啟終端機。在專案目錄中執行 npm run build 指令。這個指令會為 dist 目錄下的應用程式產生下列 JavaScript 套件：
```
project-directory/
└── dist
 ├── web
 │    └── bundle.js
 └── node
      └── bundle.js
```
在主控台中，依序點選「Develop」(開發) >「Actions」(動作)，即可上傳 JavaScript 應用程式。在「Configure Local Home SDK」區段中，按一下「Upload JavaScript files」。

圖 3：上傳 JavaScript 應用程式。
在「上傳檔案」對話方塊中，上傳您先前產生的套件檔案。請務必上傳這兩個版本的套件檔案 (節點、網頁)，以便您的動作設定為在本機執行要求支援的所有執行階段環境中正常運作。
1. 上傳指定 Node.js 的 JavaScript：從 dist/node 目錄上傳 bundle.js 檔案。
2. 上傳指定 Chrome 的 JavaScript (瀏覽器)：從 dist/web 目錄上傳 bundle.js 檔案。
在支援 Google 助理的裝置上測試動作，驗證動作在實際執行環境中是否正常運作。詳情請參閱「測試及分享智慧型住宅動作」。
如果您對動作的運作方式感到滿意，請按照「啟動智慧型住宅動作」一文中的操作說明，將其提交至 Google 以進行實際工作環境的部署作業。包括完成自我測試和認證要求步驟。

導入本地出貨應用程式