Menguji dan men-debug aplikasi

Sebaiknya buat aplikasi pemenuhan lokal menggunakan langkah-langkah yang dijelaskan sebelumnya, lalu uji integrasi smart home di lingkungan hosting Anda sendiri menggunakan langkah-langkah berikut:

  1. Di lingkungan hosting Anda sendiri, sajikan halaman HTML yang menjalankan aplikasi pemenuhan lokal Anda. Cuplikan berikut menunjukkan contoh file HTML statis yang menjalankan aplikasi pemenuhan lokal Anda.

    <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. Menguji kontrol perangkat.

  3. Debug dari Chrome. Gunakan titik henti sementara dan log untuk memecahkan masalah integrasi Anda.

  4. Ubah dan kompilasi kode TypeScript Anda, lalu ulangi langkah-langkah ini.

Dengan mengulangi proses build dan pengujian ini, Anda dapat melihat perubahan yang diterapkan dengan cepat untuk membantu Anda men-debug masalah pada kode.

Menguji kontrol perangkat

Di Google Home Developer Console, Anda harus menentukan URL aplikasi web, yang menayangkan HTML yang dimuat di perangkat Google Home atau Google Nest selama pemenuhan lokal.

Untuk menguji kontrol perangkat dengan pemenuhan lokal, ikuti langkah-langkah berikut:

Chrome

  1. Di halaman Penyiapan dan konfigurasi integrasi Cloud-to-cloud di Google Home Developer Console, scroll ke Pemenuhan lokal dan aktifkan setelan.
  2. Di bagian Menguji URL > Menguji URL untuk Chrome, tentukan URL server pengembangan yang menayangkan HTML yang menjalankan aplikasi pemenuhan lokal Anda.
  3. Klik Simpan. Mungkin diperlukan waktu hingga 30 menit agar Google menerapkan perubahan konsol Anda.
  4. Mulai ulang perangkat Google Home atau Google Nest pengujian Anda.
  5. Kirim perintah ke perangkat smart Anda. Misalnya, jika perangkat Anda menerapkan trait OnOff, Anda dapat mengucapkan "Ok Google, nyalakan lampu".

Node.js

  1. Di halaman Penyiapan dan konfigurasi Google Home Developer Console, scroll ke Pemenuhan lokal dan aktifkan setelan.
  2. Di bagian Testing URLs > Testing URL for Node, tentukan URL server pengembangan yang menyediakan JavaScript yang menjalankan aplikasi pemenuhan lokal Anda.
  3. Klik Simpan. Mungkin diperlukan waktu hingga 30 menit agar Google menerapkan perubahan konsol Anda.
  4. Mulai ulang perangkat Google Home atau Google Nest pengujian Anda.
  5. Kirim perintah ke perangkat smart Anda. Misalnya, jika perangkat Anda menerapkan trait OnOff, Anda dapat mengucapkan "Ok Google, nyalakan lampu".

Untuk mengetahui detail selengkapnya tentang runtime yang digunakan oleh perangkat Anda, lihat Perangkat yang didukung.

Melakukan debug dari Chrome

Anda dapat men-debug aplikasi pemenuhan lokal menggunakan Chrome DevTools. Sebelum Anda dapat men-debug, pastikan lingkungan Anda telah disiapkan dengan benar:

Untuk menghubungkan aplikasi fulfillment lokal Anda ke debugger Chrome DevTools, ikuti langkah-langkah berikut:

Chrome

  1. Di mesin pengembangan lokal, instal dan luncurkan browser Google Chrome.
  2. Di kolom alamat browser Chrome, luncurkan pemeriksa Chrome dengan memasukkan: chrome://inspect#devices. Anda akan melihat daftar perangkat di halaman tersebut, dan file HTML Anda akan tercantum di bawah nama perangkat Google Home atau Google Nest pengujian Anda.
  3. Klik link periksa berwarna biru di bawah HTML Anda untuk meluncurkan Chrome DevTools. Beralihlah ke tab Console. Platform Local Home menampilkan versi aplikasi Anda dan versi Local Home SDK di log konsol. Jika Anda melihat log, berarti Google telah berhasil memuat aplikasi Anda, dan dapat terhubung ke aplikasi tersebut. Jika tidak, mulai ulang perangkat Google Home atau Google Nest Anda.
    4. Gambar 1: Aplikasi pemenuhan lokal di chrome://inspect.

Node.js

  1. Di mesin pengembangan lokal, instal dan luncurkan browser Google Chrome.
  2. Tentukan alamat IP lokal perangkat pengujian Anda.
  3. Di kolom alamat browser Chrome, luncurkan pemeriksa Chrome dengan memasukkan: chrome://inspect#devices.
  4. Pilih Konfigurasi... untuk membuka Setelan penemuan target.
    5. Gambar 2: Setelan penemuan target di chrome://inspect.
  5. Masukkan DEVICE_IP_ADDRESS:9222 dalam daftar, lalu klik Selesai.
  6. Klik link periksa berwarna biru di bawah skrip Anda untuk meluncurkan Chrome DevTools. Beralihlah ke tab Console. Platform Local Home menampilkan versi aplikasi Anda dan versi Local Home SDK di log konsol. Jika Anda melihat log, berarti Google telah berhasil memuat aplikasi Anda, dan dapat terhubung ke aplikasi tersebut. Jika tidak, mulai ulang perangkat Google Home atau Google Nest Anda.

Untuk mengetahui detail selengkapnya tentang runtime yang digunakan oleh perangkat Anda, lihat Perangkat yang Didukung.

Tips proses debug

Beberapa hal tambahan yang perlu diingat selama proses penelusuran kesalahan meliputi:

  • Jangan menautkan beberapa perangkat Google Home atau Google Nest ke akun pengujian Anda di jaringan lokal yang sama. Anda tidak akan dapat mengontrol perangkat Google Home atau Google Nest mana yang menjadi target dengan perintah fulfillment lokal.
  • Muat ulang halaman di Chrome DevTools untuk memuat ulang penampung aplikasi pemenuhan lokal dengan kode terbaru dari URL pengembangan Anda. Tindakan ini tidak mereset platform Local Home, yang mungkin diperlukan untuk memicu ulang intent platform (seperti IDENTIFY) di aplikasi pemenuhan lokal Anda. Untuk mereset platform Local Home, mulai ulang perangkat Google Home atau Google Nest Anda.
  • Pastikan aplikasi JavaScript Anda dimuat tanpa error. Untuk melakukannya, periksa bagian konsol di halaman DevTools. Jika ada masalah, Anda akan melihat pesan seperti ini: 'Uncaught TypeError: Cannot read property 'open' of null.'
  • verificationId dari respons IDENTIFY harus cocok dengan salah satu otherDeviceIds dari respons SYNC.
  • Untuk handler EXECUTE, pastikan perintah HTTP, TCP, atau UDP Anda dapat diterima oleh perangkat dan berfungsi seperti yang diharapkan.
  • Pastikan untuk menampilkan Promise dari handler.
  • Hindari mempertahankan status global dalam memori. Lihat Siklus proses aplikasi.
  • Error yang ditampilkan oleh aplikasi pemenuhan lokal akan muncul di log error project Anda.

Menyiapkan dan meluncurkan ke produksi

Saat Anda siap meluncurkan Action smart home, ikuti langkah-langkah berikut:

  1. Buka terminal. Di direktori project Anda, jalankan perintah npm run build. Perintah ini akan menghasilkan paket JavaScript berikut untuk aplikasi Anda di direktori dist: 
    project-directory/
└── dist
 ├── web
 │    └── bundle.js
 └── node
      └── bundle.js
  2. Di halaman Penyiapan dan konfigurasi Google Home Developer Console, scroll ke Fulfillment lokal dan aktifkan setelan.
  3. Menggunakan tombol Upload JavaScript, upload file bundle yang sebelumnya Anda buat.
    Gambar 3: Upload aplikasi JavaScript Anda.
    Pastikan untuk mengupload kedua versi file paket (Node, Web) agar Tindakan Anda dikonfigurasi untuk berfungsi dengan benar di semua lingkungan runtime yang didukung pemenuhan lokal.
    1. Upload penargetan JavaScript untuk Node.js: Upload file bundle.js dari direktori dist/node.
    2. Upload penargetan JavaScript Anda ke Chrome (browser): Upload file bundle.js dari direktori dist/web.
  4. Uji Action Anda di perangkat yang dilengkapi dengan Asisten untuk memverifikasi bahwa Action berperilaku seperti yang diharapkan di lingkungan produksi. Untuk mempelajari lebih lanjut, lihat Menguji dan membagikan Action smart home Anda.
  5. Jika Anda sudah puas dengan cara kerja Action, kirimkan ke Google untuk deployment produksi dengan mengikuti petunjuk di Meluncurkan Action smart home Anda. Hal ini mencakup penyelesaian langkah-langkah permintaan sertifikasi dan tes mandiri.
Sebelumnya
Menerapkan aplikasi fulfillment lokal