アプリをテストしてデバッグする

前述の手順を使用してローカル フルフィルメント アプリをビルドしてから、次の手順を使用して独自のホスティング環境でスマートホーム統合をテストすることをおすすめします。

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 で、ウェブアプリの URL を指定する必要があります。この URL は、ローカル フルフィルメント中に Google Home デバイスまたは Google Nest デバイスに読み込まれる HTML を提供します。

ローカル フルフィルメントを使用してデバイス制御をテストする手順は次のとおりです。

デバイスで使用されるランタイムの詳細については、サポートされているデバイスをご覧ください。

というコマンドを使用して、デバイスを通常動作にリセットする必要があります。

Chrome からデバッグする

ローカル フルフィルメント アプリは、Chrome DevTools を使用してデバッグできます。デバッグの前に、環境が正しく設定されていることを確認してください。

• コンソールで開発用 URL を、Google Home デバイスまたは Google Nest デバイスからアクセス可能な URL（ローカルエリア ネットワーク上またはインターネット経由）に設定している。
• マシンが、テストしている Google Home または Google Nest デバイスと同じローカルエリア ネットワークに接続されている。
• ネットワークでデバイス間のパケットがブロックされていない。
• Google Home Developer Console と Google Home デバイスまたは Google Nest デバイスで同じ Google アカウントにログインしている。
• クラウド フルフィルメントで SYNC レスポンスを更新している。otherDeviceIds フィールドで少なくとも 1 つの有効な値が返されます。
• Google Home Developer Console に正しいスキャン構成情報を入力している。

ローカル フルフィルメント アプリを Chrome DevTools デバッガに接続する手順は次のとおりです。

デバイスで使用されるランタイムの詳細については、サポートされているデバイスをご覧ください。

デバッグのヒント

デバッグ中は次の点に注意してください。

• 同じローカル ネットワーク上のテストアカウントに複数の Google Home デバイスまたは Google Nest デバイスをリンクしないでください。ローカル フルフィルメント コマンドの対象となる Google Home デバイスまたは Google Nest デバイスを制御することはできません。
• Chrome DevTools でページを更新し、ローカル フルフィルメント アプリ コンテナを再読み込みして、開発用 URL からの最新のコードを確認します。これによってローカルホーム プラットフォームがリセットされることはありません。なお、リセットは、ローカル フルフィルメント アプリでプラットフォーム インテント（IDENTIFY など）を再トリガーするために必要になることがあります。ローカルホーム プラットフォームをリセットするには、Google Home デバイスまたは Google Nest デバイスを再起動します。
• JavaScript アプリがエラーなしで読み込まれていることを確認します。これを行うには、DevTools ページのコンソール セクションを確認してください。問題がある場合は、「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. [Upload JavaScript] ボタンを使用して、以前に生成したバンドル ファイルをアップロードします。

   

   ローカル フルフィルメントがサポートするすべてのランタイム環境でアクションが正しく動作するように、両方のバージョンのバンドル ファイル（Node、Web）をアップロードしてください。
   1. Node.js をターゲットとする JavaScript をアップロードする: dist/node ディレクトリから bundle.js ファイルをアップロードします。
   2. Chrome（ブラウザ）をターゲットとする JavaScript をアップロードする: dist/web ディレクトリから bundle.js ファイルをアップロードします。
4. アシスタント搭載デバイスでアクションをテストし、本番環境で想定どおり動作することを確認します。詳細については、スマートホーム アクションのテストと共有をご覧ください。
5. アクションの動作に問題がなければ、スマートホーム アクションをリリースする手順に沿って、本番環境にデプロイするために Google に提出します。これには、セルフテストと認定申請の手順が含まれます。