Rozszerzenie Google Home dla VS Code

Matter    Chmura–chmura    Pakiet SDK Local Home

Google Home Extension for Visual Studio Code została zaprojektowana i stworzona z myślą o programistach Google Home Platform. To rozszerzenie zapewnia dostęp do Google Assistant Simulator, Google Cloud Logging, przeglądarki grafu Home oraz innych narzędzi, które upraszczają Matter i proces tworzenia inteligentnego domu.

Funkcje rozszerzenia Google Home

Symulator Asystenta Google

Aby sprawdzić, czy urządzenia inteligentnego domu współpracują prawidłowo z ekosystemem Google Home, możesz w dowolnym momencie wchodzić w interakcję z Assistant Simulator bez wychodzenia z VS Code.

Assistant Simulator umożliwia łatwe sterowanie urządzeniami przez wpisywanie zapytań, na przykład „Włącz światło”. W VS Code Assistant Simulator odpowiada wiadomościami tekstowymi na podstawie Twoich poleceń, na przykład „OK, włączam światło”. Więcej informacji znajdziesz w artykule Korzystanie z Symulatora Asystenta Google.

Wyrażenia zbiorcze

Aby przetestować integrację z Google Home, możesz wysłać zbiorcze wypowiedzi do Symulacji Asystenta Google, uruchamiając skrypt wypowiedzi. Więcej informacji znajdziesz w artykule Wykonywanie zbiorczych wypowiedzi.

Narzędzia do rejestrowania Matter

Narzędzia do rejestrowania Matter mogą zbierać wszystkie dzienniki związane z debugowaniem Matter, w tym dzienniki Google Home app (GHA) i Usługi Google Play (GMS Core). Logi można wyświetlać w VS Code za pomocą filtrów i wyszukiwania słów kluczowych. Logi można pobrać z dodatkowymi informacjami debugowania, takimi jak Android i wersja aplikacji, i przesłać do Google w celu zgłoszenia problemów.

Cloud Logging

Cloud Logging zawiera informacje o debugowaniu i kluczowe dane, które ułatwiają analizowanie sposobu korzystania z Action. Aby ułatwić Ci tworzenie aplikacji, Google Home Extension wyświetla w czasie rzeczywistym wiadomości Google Cloud Logging tuż obok kodu podczas rozwiązywania problemów. Więcej informacji znajdziesz w artykule Wyświetlanie Cloud Logging.

Wyświetlający panel Context Graph

Wyświetlacz Home Graph jest teraz dostępny bezpośrednio w Google Home Extension, dzięki czemu możesz sprawdzić stan urządzenia w Twoim Home Graph w VS Code. Więcej informacji znajdziesz w artykule Wyświetlanie wykresu głównego i uruchamianie testów.

Instalowanie rozszerzenia Google Home w VS Code

Aby zainstalować Google Home Extension, wykonaj te czynności w VS Code:

1. Na pasku aktywności kliknij ikonę Rozszerzenia.

2. Wyszukaj google home, a potem kliknij Zainstaluj.

   

Możesz też pobrać Google Home Extension bezpośrednio z Marketplace VS Code.

Pobierz Google Home Extension

Konfigurowanie rozszerzenia Google Home w VS Code

Po zainstalowaniu rozszerzenia Google Home Extension i ponowym uruchomieniu VS Code musisz się zalogować i wybrać projekt, aby móc korzystać z Assistant Simulator i wyświetlać logi Cloud Logging.

Zaloguj się przez Google i wybierz projekt w chmurze

Możesz zalogować się na swoje konto dewelopera z poziomu Google Home Extension, autoryzując VS Code do komunikacji z usługami Google w Twoim imieniu.

1. Kliknij ikonę Google Home na pasku aktywności, aby otworzyć Google Home Extension.

   

2. Kliknij Zaloguj się przez Google, aby otworzyć widok logowania w przeglądarce.

   

3. Wybierz konto połączone z urządzeniami inteligentnego domu.

4. Na stronie autoryzacji Zaloguj się przez Google kliknij Zezwól.

5. Otworzy się karta przeglądarki i okno Otwórz Visual Studio Code. Aby kontynuować, kliknij Otwórz Visual Studio Code.

   

6. Zostaniesz przekierowany do VS Code, gdzie będziesz musiał(-a) wyrazić zgodę na otwarcie identyfikatora URI przez rozszerzenie Google Home. Aby zakończyć proces logowania, kliknij Otwórz.

   

7. Po zalogowaniu się Google Home Extension wczyta Twoje projekty. Gdy skończysz, kliknij Wybierz projekt.

   

8. W wyświetlonym oknie Szukaj i wybierz projekt kliknij Wybierz projekt.

Instalowanie narzędzia Android Debug Bridge (ADB)

Aby wyświetlić dzienniki Matter na telefonie Android, musisz zainstalować ADB:

1. Zainstaluj ADB na komputerze.
2. Włącz Opcje programisty i Debugowanie USB na telefonie z Androidem.

Instalowanie narzędzi SoC urządzeń Matter

Aby wyświetlić dzienniki debugowania z urządzeń Matter:

1. Większość układów SoC urządzeń wyeksportuje porty szeregowe, takie jak /dev/ttyUSBx w systemie Linux lub /dev/tty.SLAB_USBtoUART lub /dev/tty.usbserial w systemie macOS. Narzędzie LogViewer może odczytać dziennik bezpośrednio z urządzenia.
2. Niektóre typy SoC, takie jak NXP czy Silicon Labs, mogą wymagać zainstalowania zewnętrznych narzędzi (np. JLink). Więcej informacji znajdziesz w sekcji Obsługiwane urządzenia.

Korzystanie z rozszerzenia Google Home w VS Code

Wyświetlanie zasobów dla deweloperów

W sekcji POMOC I OPINIE kliknij Zacznij korzystać z Google Home i zasoby, aby otworzyć stronę Zasoby, na której znajdziesz przydatne informacje o programowaniu w ekosystemie Google Home.

Korzystanie z symulatora Asystenta Google

Aby otworzyć Assistant Simulator w VS Code, na pasku bocznym kliknij GOOGLE ASSISTANT SIMULATOR. W polu Wiadomość wpisz zapytanie i naciśnij Enter.

Możesz wyświetlić Assistant Simulator odpowiedzi i kliknąć przycisk Wyślij ponownie po zapytaniu.

Uruchamianie zbiorczych wypowiedzi

Przesuń kursor na pasek menu SYMULATORA ASISTENTA GOOGLE i wybierz jedną z tych opcji, aby skonfigurować skrypty:

• Kliknij file_upload, aby otworzyć istniejące skrypty wypowiedzi.

• Aby zapisać historię w skrypcie *.utterance, kliknij file_download.

  

Aby rozpocząć wysyłanie zbiorczych wypowiedzi, wybierz jedną z tych opcji:

• Kliknij play_arrow, aby w menu wybrać skrypt wypowiedzi.

• Otwórz bezpośrednio plik *.utterance i kliknij play_arrow.

  

Wyświetlanie Cloud Logging

W sekcji SZYBKI DOSTĘP kliknij Dzienniki Cloud, aby otworzyć stronę Dzienniki Cloud, na której znajdziesz dzienniki należące do wybranego projektu.

Użytkownicy mogą filtrować dzienniki według poziomu ważności i zakresu czasowego.

Domyślnie dzienniki są ograniczone do 50 wierszy. Jeśli użytkownik chce wyświetlić więcej logów, przewiń stronę w dół i kliknij Więcej, aby wyświetlić więcej logów.

Wyświetlanie wykresu strony głównej i uruchamianie testów

W sekcji SZYBKI DOSTĘP kliknij Domowy podgląd grafu, aby otworzyć panel Domowy podgląd grafu, w którym możesz znaleźć urządzenia należące do wybranego projektu. Możesz też kliknąć Uruchom test, aby przeprowadzić testy urządzenia.

Spowoduje to uruchomienie w przeglądarce pakietu testów z wybranym urządzeniem gotowym do testowania. Kliknij Rozpocznij i poczekaj na wyniki testu.

Po zakończeniu wszystkich testów możesz sprawdzić ich szczegóły i otwarte logi.

Debugowanie Matter za pomocą rozszerzenia Google Home

Rejestrowanie w Androidzie

W sekcji NARZĘDZIA DO ZAPISYWANIA INFORMACJI kliknij Android Dzienniki, aby otworzyć stronę Android Dzienniki, wybrać telefon Android, z którym chcesz się połączyć, i rozpocząć wyświetlanie dzienników.

Po połączeniu telefonu Android będziesz mieć możliwość wyświetlania dzienników wiersz po wierszu. Pamiętaj, że logi są filtrowane, co oznacza, że wyświetlane są tylko logi związane z modułem GHA i  Google Play servicesMatter. Możesz też ustawić poziom ważności, aby filtrować dzienniki, lub wykonać wyszukiwanie słowa kluczowego w dziennikach.

Logowanie urządzenia Matter

W sekcji NARZĘDZIA DO ZAPISYWANIA INFORMACJI kliknij Dzienniki urządzenia, aby otworzyć stronę Zasoby. Najpierw wybierz Typ SoC:

Następnie wybierz Urządzenie Matter:

Następnie możesz pobrać wszystkie dzienniki urządzenia i użyć filtrów, takich jak Poważność i Wyszukiwanie, aby znaleźć interesujące Cię informacje.

Pobieranie wszystkich dzienników sprawy

W sekcji SZYBKI DOSTĘP kliknij Pobierz dzienniki, aby otworzyć okno Pobierz dzienniki. Wybierz dzienniki do pobrania i kliknij OK.

Wybierz folder, do którego mają zostać pobrane dzienniki, i kliknij Zapisz:

Następnie dzienniki zostaną zapisane w folderze docelowym:

Wyodrębnij zapisany plik ZIP. Zawiera on informacje o urządzeniu i pliki dziennika.

Plik z informacjami o urządzeniu będzie zawierać wszystkie informacje o wersji potrzebne do debugowania problemów.

Prześlij opinię

Aby przesłać swoje opinie na temat tego, jak możemy ulepszyć proces tworzenia aplikacji za pomocą Google Home Extension, wybierz jedną z tych opcji:

• W panelu POMOC I OPINIE kliknij Prześlij opinię, aby przekazać nam swoje sugestie.
• W panelu POMOC I OPINIE kliknij Zgłoś problem, aby zgłosić dowolny problem z Google Home Extension.

• Na stronie Materiały znajdziesz też ikonę opinii.