Google Home-Erweiterung für VS Code

Device SDK

Google Home Extension for Visual Studio Code wurde für Entwickler der Google Home-Plattform entwickelt. Mit dieser Erweiterung erhalten Sie Zugriff auf Google Assistant Simulator, Google Cloud Logging, den Home Graph Viewer und andere Tools, die die Entwicklung von Matter und Smart-Home-Geräten vereinfachen.

Google Home-Erweiterung für VS Code

Funktionen der Google Home-Erweiterung

Google Assistant-Simulator

Wenn Sie testen möchten, ob Ihre Smart-Home-Geräte ordnungsgemäß mit dem Google Home-System funktionieren, können Sie jederzeit mit Assistant Simulator interagieren, ohne VS Code zu verlassen.

Mit Assistant Simulator können Sie Ihre Geräte ganz einfach per Eingabe steuern, z. B. „Schalte das Licht ein.“ In VS Code antwortet Assistant Simulator auf Ihre Befehle mit Textnachrichten, z. B. „In Ordnung, ich schalte das Licht ein.“ Weitere Informationen finden Sie unter Google Assistant-Simulator verwenden.

Batch-Sätze

Wenn Sie Ihre Google Home-Integration wie einen Automaten testen möchten, können Sie Batch-Sätze an den Google Assistant-Simulator senden, indem Sie ein Skript für die Äußerungen ausführen. Weitere Informationen finden Sie unter Batch-Sätze ausführen.

Matter-Logging-Tools

Mit Matter-Logging-Tools können alle Logs im Zusammenhang mit der Matter-Fehlerbehebung erfasst werden, einschließlich der Google Home app (GHA)-Logs und der Logs der Google Play-Dienste (GMS Core). Die Protokolle können in VS Code mit Filter- und Suchbegriffen angezeigt werden. Protokolle können mit zusätzlichen Informationen zur Fehlerbehebung wie Android und App-Version heruntergeladen und an Google gesendet werden, um Probleme zu melden.

Matter-Protokollierung der Google Home-Erweiterung

Cloud Logging

Cloud Logging bietet Informationen zur Fehlerbehebung und wichtige Messwerte, die Aufschluss über die Nutzung Ihrer Aktion geben. Zur Vereinfachung der Entwicklung werden in der Google Home Extension während der Fehlerbehebung Google Cloud Logging-Nachrichten in Echtzeit direkt neben dem Code angezeigt. Weitere Informationen finden Sie unter Cloud Logging-Daten ansehen.

Home Graph-Betrachter

Der Home Graph Viewer ist jetzt direkt in derGoogle Home Extension verfügbar, sodass Sie den Gerätestatus in Ihrem Home Graph in VS Code prüfen können. Weitere Informationen finden Sie unter Zuhause-Diagramm ansehen und Tests ausführen.

Google Home-Erweiterung für VS Code installieren

So installieren Sie Google Home Extension in VS Code:

  1. Klicken Sie in der Aktivitätsleiste auf das Symbol Erweiterungen.
  2. Suchen Sie nach google home und klicken Sie auf Installieren.

    Google Home Extension Marketplace

Sie können die Google Home Extension auch direkt über den VS Code Marketplace herunterladen.

Google Home Extension herunterladen

Google Home-Erweiterung für VS Code einrichten

Nachdem Sie Google Home Extension installiert und VS Code neu geladen haben, müssen Sie sich anmelden und ein Projekt auswählen, bevor Sie Google Home Extension verwenden und Cloud Logging aufrufen können.Assistant Simulator

Mit Google anmelden und ein Cloud-Projekt auswählen

Sie können sich ab dem Google Home Extension in Ihrem Entwicklerkonto anmelden und VS Code berechtigen, in Ihrem Namen mit Google-Diensten zu kommunizieren.

  1. Klicken Sie in der Aktivitätsleiste auf das Symbol Google Home, um Google Home Extension zu öffnen.

    Symbol der Google Home-Erweiterung
  2. Klicken Sie auf Über Google anmelden, um die Anmeldeseite in Ihrem Browser zu öffnen.

    Google Log-in in VS Code
  3. Wählen Sie das Konto aus, das mit Ihren Smart-Home-Geräten verknüpft ist.

  4. Klicken Sie auf der Autorisierungsseite Über Google anmelden auf Zulassen.

  5. Ein Browsertab wird geöffnet und das Dialogfeld Visual Studio Code öffnen wird angezeigt. Klicken Sie auf Visual Studio Code öffnen, um fortzufahren.

    Dialogfeld „VS Code öffnen“
  6. Sie werden zu VS Code weitergeleitet, wo Sie die Berechtigung erteilen müssen, damit die Google Home-Erweiterung einen URI öffnen kann. Klicken Sie auf Öffnen, um den Anmeldevorgang abzuschließen.

    Google Home-Erweiterung zulassen, einen URI zu öffnen
  7. Nach der Anmeldung werden Ihre Projekte in Google Home Extension geladen. Klicken Sie dann auf Projekt auswählen.

    Projekt auswählen
  8. Wählen Sie im Drop-down-Fenster Projekt suchen und auswählen Ihr Smart-Home-Projekt aus.

Android Debug Bridge (ADB) Tool installieren

Wenn du die Matter-Protokolle auf einem Android-Smartphone aufrufen möchtest, musst du ADB installieren:

  1. Installieren Sie ADB auf Ihrem Computer.
  2. Aktivieren Sie die Entwickleroptionen und das USB-Debugging auf Ihrem Android-Smartphone.

Matter Device SoC Tools installieren

So rufen Sie die Debug-Protokolle von Matter Geräten auf:

  1. Die meisten Geräte-SoCs exportieren serielle Ports wie /dev/ttyUSBx unter Linux oder /dev/tty.SLAB_USBtoUART oder /dev/tty.usbserial unter macOS. Der LogViewer kann das Protokoll direkt vom Gerät lesen.
  2. Für einige SoC-Typen wie NXP oder Silicon Labs müssen möglicherweise externe Tools wie JLink installiert werden. Weitere Informationen finden Sie unter Unterstützte Geräte.

Google Home-Erweiterung für VS Code verwenden

Ressourcen für Entwickler ansehen

Klicken Sie unter HILFE UND FEEDBACK auf Einstieg und Ressourcen, um die Seite Ressourcen zu öffnen. Dort finden Sie hilfreiche Informationen für Ihre Entwicklung im Google Home-System.

Ressourcen für das Google Home-Ökosystem

Google Assistant-Simulator verwenden

Wenn Sie Assistant Simulator in VS Code öffnen möchten, klicken Sie in der Seitenleiste auf GOOGLE ASSISTANT-SIMULATOR. Geben Sie Ihre Suchanfrage in das Feld Nachricht ein und drücken Sie die Enter.

Sie können sich Assistant Simulator Antworten ansehen und nach Ihrer Anfrage auf die Schaltfläche Senden klicken, um sie noch einmal zu senden.

Google Assistant-Simulator verwenden

Batch-Sätze ausführen

Bewegen Sie den Mauszeiger auf die Menüleiste GOOGLE ASSISTANT SIMULATOR und wählen Sie eine der folgenden Optionen aus, um Scripts einzurichten:

  • Klicken Sie auf , um vorhandene Skripts für Äußerungen zu öffnen.

  • Klicken Sie auf , um den Verlauf in einem *.utterance-Script zu speichern.

    Menüsymbole für Batch-Sätze

Wenn Sie Batch-Sätze senden möchten, haben Sie folgende Möglichkeiten:

  • Klicken Sie auf , um im Drop-down-Menü ein Skript für die Äußerung auszuwählen.
  • Öffnen Sie eine *.utterance-Datei direkt und klicken Sie auf .

    Symbol für die Ausführung von Batch-Sätzen

Cloud Logging aufrufen

Klicken Sie unter SCHNELLZUGRIFF auf Cloud Logs, um die Seite Cloud Logs zu öffnen. Dort finden Sie die Logs für das ausgewählte Projekt.

Cloud Logging verwenden

Nutzer können Protokolle nach Schweregrad und Zeitraum filtern.

Logs nach Schweregrad und Zeit filtern

Standardmäßig sind die Protokolle auf 50 Zeilen begrenzt. Wenn der Nutzer weitere Protokolle aufrufen möchte, scrollt er nach unten und klickt auf Mehr.

Weitere Protokolle ansehen

Startseite-Grafik aufrufen und Tests ausführen

Klicken Sie unter SCHNELLZUGRIFF auf Home Graph Viewer (Zuhause-Grafikanzeige), um den Bereich Home Graph Viewer (Zuhause-Grafikanzeige) zu öffnen. Dort finden Sie Geräte, die zum ausgewählten Projekt gehören. Sie können auch auf Test ausführen klicken, um Tests für das Gerät auszuführen.

Home Graph-Betrachter

Dadurch wird die Testsuite in Ihrem Browser gestartet. Ihr Gerät ist ausgewählt und kann getestet werden. Klicken Sie auf Starten und warten Sie auf die Testergebnisse.

Google Home-Test-Suite

Sie können sich die Testdetails und die Protokolle ansehen, nachdem alle Tests abgeschlossen sind.

Testergebnisse

Google Home-Erweiterung für die Matter-Fehlerbehebung verwenden

Android-Protokollierung

Klicken Sie unter MATTER LOGGING TOOLS (MATTER-LOGGING-TOOLS) auf Android Logs (Android Protokolle), um die Seite Android Logs (Android Protokolle) zu öffnen. Wählen Sie das Android-Smartphone aus, mit dem Sie eine Verbindung herstellen möchten, und lassen Sie sich Protokolle anzeigen.

Android-Protokollierung

Nachdem das Android-Smartphone verbunden ist, können Sie die Protokolle zeilenweise aufrufen. Die Protokolle werden gefiltert, sodass nur Protokolle zu GHA und zum Google Play services Matter-Modul angezeigt werden. Sie können auch Schweregrad festlegen, um Protokolle zu filtern, oder Suchen, um nach dem Suchbegriff in Protokollen zu suchen.

Gefilterte Android-Protokollierung

Logging von Matter-Geräten

Klicken Sie unter MATTER LOGGING TOOLS (MATTER-LOGGER) auf Device Logs (Geräteprotokolle), um die Seite Resources (Ressourcen) zu öffnen. Wählen Sie zuerst SoC Type (SoC-Typ) aus:

Logging von Matter-Geräten

Wählen Sie als Nächstes das Matter-Gerät aus:

Matter-Geräteprotokollierung – ausgewähltes Gerät

Anschließend können Sie alle Geräteprotokolle vom Gerät abrufen und mithilfe von Filtern wie Schweregrad und Suchen die gewünschten Informationen finden.

Gefiltertes Logging für Matter-Geräte

Alle Matter-Protokolle herunterladen

Klicken Sie unter SCHNELLER ZUGRIFF auf Protokolle herunterladen, um das Dialogfeld Protokolle herunterladen zu öffnen. Wählen Sie die herunterzuladenden Protokolle aus und drücken Sie auf OK.

Matter-Protokolle herunterladen

Wählen Sie den Ordner aus, in den Sie die Protokolle herunterladen möchten, und klicken Sie auf Speichern:

Matter-Protokoll speichern

Die Protokolle werden dann im Zielordner gespeichert:

Zielordner für Matter-Protokolle

Extrahieren Sie die gespeicherte ZIP-Datei. Sie enthält Geräteinformationen und Protokolldateien.

ZIP-Datei mit Matter-Protokoll

Die Geräteinfodatei enthält alle Versionsinformationen, die zur Fehlerbehebung erforderlich sind.

Matter-Protokoll-Debugging

Feedback geben

Wenn du uns deine Meinung oder Feedback dazu geben möchtest, wie wir die Entwicklung mit Google Home Extension verbessern können, wähle eine der folgenden Optionen aus:

  • Klicken Sie im Bereich HILFE UND FEEDBACK auf Feedback geben, um uns Vorschläge zu machen.
  • Klicken Sie im Bereich HILFE UND FEEDBACK auf Problem melden, um ein Problem mit Google Home Extension
Symbol „Feedback geben“
  • Auf der Seite Ressourcen finden Sie außerdem ein Feedbacksymbol.