測試應用程式並進行偵錯

建議您按照上述步驟建構店內取貨應用程式，然後按照下列步驟，在自己的代管環境中測試智慧住宅整合：

  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

  1. 在 Google Home Developer Console 的「雲端對雲端整合」「設定和設定」頁面中，捲動至「本地履行」，然後開啟這項設定。
  2. 在「測試網址」 >「Chrome 的測試網址」下方，指定提供 HTML 的開發伺服器網址，該 HTML 會執行本機完成應用程式。
  3. 按一下 [儲存]。Google 最多可能需要 30 分鐘，才能將您在控制台中所做的變更全面生效。
  4. 重新啟動測試用的 Google Home 或 Google Nest 裝置。
  5. 對智慧型裝置下達指令。舉例來說，如果裝置實作 OnOff 特徵，你就可以說「Ok Google，開燈」。

Node.js

  1. 在「設定與配置」頁面中， Google Home Developer Console 捲動至「店內取貨」 並開啟這項設定。
  2. 在「測試網址」 >「Node 的測試網址」下方，指定提供 JavaScript 的開發伺服器網址，該 JavaScript 會執行本機完成應用程式。
  3. 按一下 [儲存]。Google 最多可能需要 30 分鐘，才能將您在控制台中所做的變更全面生效。
  4. 重新啟動測試用的 Google Home 或 Google Nest 裝置。
  5. 對智慧型裝置下達指令。舉例來說，如果裝置實作 OnOff 特徵，你就可以說「Ok Google，開燈」。

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

指令，將裝置重設為正常運作模式。

從 Chrome 偵錯

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

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

Chrome

  1. 在本地開發電腦上，安裝並啟動 Google Chrome 瀏覽器。
  2. 在 Chrome 瀏覽器的網址欄位中，輸入 chrome://inspect#devices 啟動 Chrome 檢查器。網頁上應會顯示裝置清單，而 HTML 檔案應會列在測試 Google Home 或 Google Nest 裝置名稱下方。
  3. 按一下 HTML 下方的藍色檢查連結，啟動 Chrome 開發人員工具。 切換到「控制台」分頁。 Local Home 平台會在控制台記錄中輸出應用程式版本和 Local Home SDK 版本。如果看到記錄，表示 Google 已成功載入您的應用程式，且能夠連線。如果沒有，請重新啟動 Google Home 或 Google Nest 裝置。
    4. 圖 1：chrome://inspect 中的本機履行應用程式。

Node.js

  1. 在本地開發電腦上，安裝並啟動 Google Chrome 瀏覽器。
  2. 找出測試裝置的本機 IP 位址。
  3. 在 Chrome 瀏覽器的網址欄位中，輸入 chrome://inspect#devices 啟動 Chrome 檢查器。
  4. 選取「設定...」，開啟「目標探索設定」。
    5. 圖 2：chrome://inspect 中的目標探索設定。
  5. 在清單中輸入 DEVICE_IP_ADDRESS:9222，然後按一下「完成」。
  6. 按一下指令碼下方的藍色檢查連結，啟動 Chrome 開發人員工具。 切換到「控制台」分頁。 Local Home 平台會在控制台記錄中輸出應用程式版本和 Local Home SDK 版本。如果看到記錄，表示 Google 已成功載入您的應用程式，且能夠連線。如果沒有，請重新啟動 Google Home 或 Google Nest 裝置。

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

偵錯提示

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

  • 請勿在同一個本機網路中，將多部 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
  3. 使用「上傳 JavaScript」按鈕，上傳先前產生的套件檔案。
    圖 3：上傳 JavaScript 應用程式。
    請務必上傳兩個版本的套件檔案 (Node 和 Web)， 確保 Action 已設定完畢，可在本機執行的所有執行階段環境中正常運作。
    1. 上傳以 Node.js 為目標的 JavaScript：從 dist/node 目錄上傳 bundle.js 檔案。
    2. 上傳以 Chrome (瀏覽器) 為目標的 JavaScript：從 dist/web 目錄上傳 bundle.js 檔案。
  4. 在支援 Google 助理的裝置上測試動作，確認動作在正式環境中是否正常運作。詳情請參閱「測試及分享智慧住宅動作」。
  5. 確認動作運作正常後，請按照「推出智慧住宅動作」一文的說明，將動作提交給 Google 進行正式版部署。包括完成自我測試和認證申請步驟。
上一頁
導入本地出貨應用程式