Testowanie i debugowanie aplikacji

Zalecamy utworzenie aplikacji do realizacji lokalnej zgodnie z opisanymi wcześniej krokami, a następnie przetestowanie integracji inteligentnego domu we własnym środowisku hostingowym, wykonując te czynności:

1. W swoim środowisku hostingowym udostępnij stronę HTML, która uruchamia aplikację realizacji lokalnej. Poniższy fragment kodu pokazuje przykład statycznego pliku HTML, który uruchamia aplikację realizacji lokalnej.

   <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. Sterowanie urządzeniem testowym.

3. Debugowanie w Chrome. Używaj punktów przerwania i logów, aby rozwiązywać problemy z integracją.

4. Zmodyfikuj i skompiluj kod TypeScript, a następnie powtórz te czynności.

Powtarzając ten proces kompilowania i testowania, możesz szybko zobaczyć zmiany w działaniu, co pomoże Ci debugować problemy z kodem.

Sterowanie urządzeniem testowym

W Google Home Developer Console musisz podać adres URL aplikacji internetowej, która udostępnia kod HTML wczytywany na urządzeniu Google Home lub urządzeniu Google Nest podczas realizacji lokalnej.

Aby przetestować sterowanie urządzeniem za pomocą realizacji lokalnej, wykonaj te czynności:

Więcej informacji o tym, które środowisko wykonawcze jest używane przez Twoje urządzenie, znajdziesz w sekcji Obsługiwane urządzenia.

Debugowanie z Chrome

Aplikację do realizacji lokalnej możesz debugować za pomocą Narzędzi deweloperskich w Chrome. Zanim zaczniesz debugować, upewnij się, że środowisko jest prawidłowo skonfigurowane:

• w konsoli ustawiono adres URL programowania na adres URL dostępny dla urządzenia Google Home lub urządzenia Google Nest (w lokalnej sieci komputerowej lub przez internet),
• Komputer jest połączony z tą samą lokalną siecią komputerową co testowane urządzenie Google Home lub Google Nest.
• Twoja sieć nie blokuje pakietów między urządzeniami.
• Zaloguj się na to samo konto Google na urządzeniu Google Home Developer Console i na urządzeniu Google Home lub Google Nest.
• Zaktualizowano odpowiedź SYNC w realizacji w chmurze. Powinien on zwracać co najmniej 1 prawidłową wartość w polu otherDeviceIds.
• Wpisano prawidłowe informacje o konfiguracji skanowania w Google Home Developer Console.

Aby połączyć aplikację do realizacji lokalnej z debugerem Narzędzi deweloperskich w Chrome, wykonaj te czynności:

Więcej informacji o tym, które środowisko wykonawcze jest używane przez Twoje urządzenie, znajdziesz w sekcji Obsługiwane urządzenia.

Wskazówki dotyczące debugowania

Podczas debugowania warto pamiętać o kilku dodatkowych kwestiach:

• Nie łącz wielu urządzeń Google Home ani urządzeń Google Nest z kontem testowym w tej samej sieci lokalnej. Nie będziesz mieć możliwości kontrolowania, które urządzenie Google Home lub urządzenie Google Nest jest celem poleceń realizacji lokalnej.
• Odśwież stronę w Narzędziach deweloperskich w Chrome, aby ponownie załadować kontener aplikacji do realizacji lokalnej z najnowszym kodem z adresu URL programowania. Nie powoduje to zresetowania platformy Local Home, co może być konieczne do ponownego wywołania intencji platformy (takich jak IDENTIFY) w aplikacji do realizacji lokalnej. Aby zresetować platformę Local Home, uruchom ponownie urządzenie Google Home lub Google Nest.
• Sprawdź, czy aplikacja JavaScript wczytuje się bez błędów. Aby to zrobić, sprawdź sekcję konsoli na stronie Narzędzi deweloperskich. Jeśli wystąpi problem, zobaczysz komunikat podobny do tego: „Uncaught TypeError: Cannot read property 'open' of null”.
• Wartość verificationId z odpowiedzi IDENTIFY musi być zgodna z jedną z wartości otherDeviceIds z odpowiedzi SYNC.
• W przypadku modułu obsługi EXECUTE upewnij się, że polecenia HTTP, TCP lub UDP mogą być odbierane przez urządzenie i działają zgodnie z oczekiwaniami.
• Pamiętaj, aby zwrócić Promise z modułów obsługi.
• Unikaj utrzymywania stanu globalnego w pamięci. Zobacz Cykl życia aplikacji.
• Błędy zgłaszane przez aplikację do realizacji lokalnej będą widoczne w dziennikach błędów projektu.

Przygotowywanie i publikowanie wersji produkcyjnej

Gdy wszystko będzie gotowe do uruchomienia akcji inteligentnego domu, wykonaj te czynności:

1. Otwórz terminal. W katalogu projektu uruchom polecenie npm run build. To polecenie generuje te pakiety JavaScriptu dla aplikacji w katalogu dist:

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

2. Na stronie Konfiguracja i ustawienia w Google Home Developer Console przewiń do sekcji Realizacja lokalna i włącz to ustawienie.
3. Za pomocą przycisków Prześlij JavaScript prześlij wygenerowane wcześniej pliki pakietu.

   

   Pamiętaj, aby przesłać obie wersje plików pakietu (Node, Web), aby akcja była skonfigurowana do prawidłowego działania we wszystkich środowiskach wykonawczych obsługiwanych przez realizację lokalną.
   1. Prześlij kod JavaScript kierowany na Node.js: prześlij plik bundle.js z katalogu dist/node.
   2. Prześlij kod JavaScript kierowany na Chrome (przeglądarkę): prześlij plik bundle.js z katalogu dist/web.
4. Przetestuj akcję na urządzeniu z Asystentem, aby sprawdzić, czy działa zgodnie z oczekiwaniami w środowisku produkcyjnym. Więcej informacji znajdziesz w artykule Testowanie i udostępnianie akcji inteligentnego domu.
5. Gdy uznasz, że akcja działa prawidłowo, prześlij ją do Google w celu wdrożenia produkcyjnego, postępując zgodnie z instrukcjami podanymi w artykule Uruchamianie akcji inteligentnego domu. Obejmuje to wykonanie autotestu i przesłanie prośby o certyfikację.