Google Assistant-Plug-in für Android Studio

Das Google Assistant-Plug-in testet App Actions in Android Studio. Während der Entwicklung und beim Testen verwenden Sie das Plug-in, um eine Vorschau Ihrer App Actions in Assistant für dein Google-Konto. Sie können dann testen, App Action verarbeitet verschiedene Parameter, bevor sie zur Bereitstellung gesendet werden.

Funktionsweise

Das Google Assistant-Plug-in enthält das App Actions-Testtool, eine Funktion, die die Datei shortcuts.xml parst und eine Vorschau Ihrer App Actions für ein mit nur einem Google-Konto. Mithilfe dieser Vorschauen kann Google Assistant Ihr App Actions vor der Bereitstellung der Produktionsversion deiner App für die Google Play Console

Für jeden integrierten Intent (BII) in der Datei shortcuts.xml rendert das Tool ein entsprechendes JSON-LD-Objekt und stellt Standardparameterwerte bereit. Sie können Ändern Sie dann diese Werte, um Ihre App Actions mit aussagekräftigen Parametern zu testen und sicherzustellen, dass sie die richtigen App-Funktionen funktionieren. Vorschauen werden im Testtool erstellt, aktualisiert und gelöscht. So können Sie Ihre App-Aktionen in einer sicheren Umgebung iterieren und testen.

Nachdem eine Vorschau erstellt wurde, können Sie auf Ihrem Testgerät eine App Action auslösen direkt über das Fenster mit den Testtools. Für BIIs, die verfügbar sind Zum Auslösen von Nutzeraktionen kannst du app name direkt in Assistant auf deinem um App Action auszuprobieren. Sie können beispielsweise „Hey Google, beginne mein Training mit der Beispiel-App“, um eine App-Aktion zu starten, die das actions.intent.START_EXERCISE BII.

Sprachunterstützung

Das Erstellen von Vorschauen für bestimmte Sprachen im Testtool variiert je nach BII. Auf der Seite für jeden BII in der Referenz zu integrierten Intents werden folgende Informationen bereitgestellt: Informationen darüber, welche Funktionen für diesen BII verfügbar sind, ob das Testtool das Erstellen von Vorschauen für eine bestimmte Sprache unterstützt ob App Actions zum Auslösen verfügbar sind.

Plug-in herunterladen

Das Google Assistant-Plug-in ist für Android Studio verfügbar. Für Informationen zur Installation und Verwendung von Android Studio finden Sie in der Android Studio verfügbar.

So installieren Sie das Google Assistant-Plug-in in Android Studio:

  1. Gehen Sie zu Datei > Einstellungen (Android Studio > Einstellungen unter macOS)
  2. Klicken Sie im Abschnitt Plug-ins auf Marketplace und suchen Sie nach „Google Assistant-Plug-in“.
  3. Installieren Sie das Tool und starten Sie Android Studio neu.

Sie können das Plug-in auch direkt über die Öffentliches Jetbrains-Repository.

Voraussetzungen für die Einrichtung

Für die Verwendung des Google Assistant-Plug-ins sind einige Konfigurationsschritte erforderlich, um deine App Action erfolgreich zu testen. Insbesondere müssen Sie die Methode dasselbe Nutzerkonto in Android Studio, auf dem Testgerät und für Google Play Konsolenzugriff.

Bereiten Sie Ihre Entwicklungsumgebung mit den folgenden Konfigurationen vor:

  • Melde dich in Android Studio an (Version 4.0 oder höher).
  • Melden Sie sich mit demselben Konto auf Ihrem Android-Testgerät in der Google App an.
  • Sie benötigen mit demselben Konto Play Console-Zugriff auf das hochgeladene App-Paket, das getestet werden soll.
  • Öffnen Sie die Google App auf Ihrem Android-Testgerät und schließen Sie die ersten Schritte ab. Einrichtung von Assistant.
  • Aktivieren Sie auf Ihrem Testgerät die Synchronisierung der Gerätedaten.

Beschränkungen

Für das Google Assistant-Plug-in gelten die folgenden Einschränkungen:

  • App-Aktionen, die Webinventar und die Aufruf einer App im Vordergrund umfassen, können nicht direkt im Testtool oder mit adb-Befehlen der Android Debug Bridge (ADB) getestet werden. Erstelle zum Testen dieser App Actions zuerst eine Vorschau mit dem Test . Löse diese App Actions dann durch Interaktion mit Google Assistant. auf deinem physischen Gerät.
  • Inline-Inventar für die actions.intent.OPEN_APP_FEATURE BII kann nur sechs Stunden lang getestet werden, nachdem eine Vorschau erstellt oder aktualisiert wurde. Aktualisieren Sie die Vorschau des Testtools oder erstellen Sie eine neue Vorschau, um den 6-Stunden-Zeitraum zurücksetzen.

Weitere Tester hinzufügen

Sie können weitere Nutzer in Ihr Projekt einladen, damit diese Ihre App Actions-Integration Dies ist nützlich, wenn Sie das Projekt mit anderen Mitgliedern Ihres Entwicklungsteams teilen, damit diese alle testen können das Projekt mit Testern der Qualitätssicherung (QS) zur Vorbereitung auf Produktionseinführung. Tester müssen als Lizenztester auf der Google Play Store abgeschlossen und Lesezugriff auf die Google Play Console gewährt wurde.

So fügen Sie weitere Tester hinzu:

  1. Melden Sie sich in der Play Console an.

  2. Folgen Sie der Anleitung unter App-Lizenzierung einrichten in dieser Play Console-Hilfethema.

    Fügen Sie über die Google Play Console einen Lizenztester hinzu.
    Abbildung 1: Lizenztester hinzufügen.

  3. Laden Sie das Google-Konto des Lizenztesters als schreibgeschützten Google Play Console-Nutzer ein. Nutzer.

    1. Wählen Sie Nutzer und Berechtigungen > Neue Nutzer einladen > App hinzufügen.
    2. Entfernen Sie unter App-Zugriff das Häkchen bei Administrator (alle Berechtigungen).

Sie müssen sich für jeden Tester, den Sie für Vorschautests aktivieren möchten, anmelden separat von Android Studio mit dem Google-Konto des Nutzers. Nachdem Sie sich angemeldet haben, verwenden Sie das Google Assistant-Plug-in, um eine Vorschau für den Testnutzer zu erstellen.

Google Assistant-Plug-in verwenden

Greife in Android Studio auf das App Actions-Testtool zu, indem du Tools > Google Assistant > App Actions-Testtool Wenn Sie das Tool öffnen, ändert sich die Ansicht basierend auf unabhängig davon, ob Sie ein aktives Test-Tool in der Vorschau haben.

Vorschauen erstellen, aktualisieren und löschen

Sie können eine Entwurfsversion der App für Tests verwenden. Weitere Informationen Weitere Informationen finden Sie unter Release vorbereiten und einführen. Testen Sie Ihre App im Entwurfsmodus, bevor Sie sie zur Überprüfung einreichen.

Das Testtool erstellt Vorschauen auf Grundlage deines Google-Kontos und des App-Paketnamens (Anwendungs-ID), damit Sie mehrere Apps mit demselben Google-Konto. Solange die App-ID für jede App unterschiedlich ist, müssen Sie können weiterhin dasselbe Google-Konto für die Vorschauerstellung und das Testen verwenden. Mehrere Google-Konten mit Zugriff auf dasselbe App-Paket können jeweils den Testtool, um separate Vorschauen für diese App zu erstellen.

So erstellen Sie eine Vorschau in Android Studio:

  1. Öffnen Sie das App Actions-Testtool.
  2. Geben Sie optional einen App-Namen und eine Sprache zum Testen ein. Standardeinstellung App-Name und Sprache sind test app action und en.
  3. Klicken Sie auf Vorschau erstellen. Wenn du dazu aufgefordert wirst, lies und akzeptiere die App Actions Richtlinien und Nutzungsbedingungen. Sobald die Vorschau erstellt wurde, werden im Testtool-Fenster Informationen zu BIIs angezeigt, die in der Datei shortcuts.xml gefunden wurden.

Das Testtool verwendet den App-Namen, um Assistant zu erstellen und zu simulieren Abfragen für Ihre App Actions an. Für bereitgestellte App Actions wird der Name deiner Play Store App verwendet für den Aufruf. Sie können jedoch einen beliebigen Aufrufnamen im Testtool verwenden. Wir empfehlen jedoch, den Namen Ihrer App als Aufrufnamen im Tool testen.

Die Sprache, die Sie angeben, muss mit der Sprache von Google Assistant auf Ihrem Testgerät und Sie können jeweils nur eine Vorschau in einer Sprache erstellen. Für Wenn deine Assistant-Sprache beispielsweise Englisch (USA) ist, kannst du en-US eingeben, aber nicht en-**, en-GB oder en-US, en-GB. Sie können eine Stammsprache wie als en, um sowohl en-GB als auch en-US einzuschließen.

Um den Namen der App oder die ausgewählte Sprache für eine vorhandene Vorschau zu ändern, klicken Sie auf im Testtool auf die Schaltfläche Löschen. Geben Sie dann die gewünschten und das Gebietsschema aus, bevor Sie eine neue Vorschau erstellen.

Wenn Sie eine vorhandene Vorschau aktualisieren möchten, damit sie mit der Datei shortcuts.xml übereinstimmt, klicken Sie auf das Aktualisieren im Testtool. Informationen zur aktuellen Vorschau finden Sie im Bereich App-Aktion testen des Testtools.

BII konfigurieren

Nachdem Sie eine Vorschau für Ihre App erstellt haben, können Sie verschiedene Parameter für BIIs im Plug-in. Für jeden BII in Ihrem shortcuts.xml-Datei enthält das Plug-in eine entsprechende JSON-LD-Objekt und stellt Standardparameterwerte bereit. Sie können diese zum Testen deiner App Actions mit sinnvollen Parameterkombinationen und sicherzustellen, dass sie die richtigen App-Funktionen ausführen.

Parameter und ihre Werte folgen in der Regel der schema.org- oder schema.googleapis.com-Struktur für Properties und Beschreibungen. Sie finden Informationen zu BII-Parametern durch Zugriff auf das Schema Typbeschreibungen eines Parameters und seiner Parameter auf höherer Ebene.

Beispiel: der BII actions.intent.GET_FOOD_OBSERVATION unterstützt den Intent-Parameter foodObservation.forMeal. Auf der Seite schema.googleapis.com für MealType ist name als Property aufgeführt. Das Attribut forMeal ist ein Übertragungsmodus und erwartet (z. B. MealTypeLunch) des enumerierten Typs MealType.

Im Testtool können Sie eine der folgenden Aufzählungen als Wert für foodObservation.forMeal angeben:

  • https://schema.googleapis.com/MealTypeSnack
  • https://schema.googleapis.com/MealTypeBrunch
  • https://schema.googleapis.com/MealTypeLunch
  • https://schema.googleapis.com/MealTypeBreakfast
  • https://schema.googleapis.com/MealTypeDinner
  • https://schema.googleapis.com/MealTypeDesert

App-Aktionen auslösen

Nachdem Sie eine Vorschau erstellt und einen BII konfiguriert haben, können Sie eine App Action direkt über das Testtool-Fenster auf deinem Testgerät.

So lösen Sie eine App-Aktion mit dem Testtool aus:

  1. Verbinden Sie das Testgerät.
  2. Wählen Sie im Abschnitt Zielgerät auswählen das Gerät aus, auf dem Sie die App Action auslösen.
  3. Klicken Sie im Abschnitt Test App Action (App-Aktion testen) auf die Schaltfläche Run App Action (App-Aktion ausführen).

Für App Actions, die im Testtool ausgelöst werden, wird das angezeigte Android Debug Bridge (adb) verwenden. Den generierten Shell-Befehl adb enthält alle Metadaten, die von der Google App zum Ausführen eines BII benötigt werden. Dieser Ansatz ahmt das Verhalten deiner App Action nach Assistant nach extrahiert wichtige Informationen aus einer Abfrage.

Protokollierung in Android Studio

Spezifische Protokolle für das Testtool sind in den Android Studio-Protokolldateien verfügbar, nicht als Logcat-Ausgabe. Prozesse, die direkt auf Ihrer Workstation ausgeführt werden, generieren Android Studio-Protokolle. Sie können sie zur Fehlerbehebung bei Test-Tool-Vorgängen wie dem Erstellen, eine Vorschau aktualisieren oder löschen.

Wenn Sie auf Ihre Android Studio-Protokolldateien zugreifen möchten, wählen Sie Hilfe > Protokoll im Explorer anzeigen aus (Hilfe > Protokoll im Finder anzeigen unter macOS).

Protokolle im Zusammenhang mit App Actions für Ihre App sind in Logcat verfügbar. Logcat erfasst Protokolle von virtuellen oder physischen Geräten, die mit Android verbunden sind Studio

So rufen Sie App Actions-Protokolle für Ihr Gerät ab:

  1. Klicken Sie in der Symbolleiste des Android Studio-Toolfensters auf Logcat, um auf Ihre Logcat-Protokollmeldungen zuzugreifen.
  2. Suchen Sie nach Logs, die ActivityTaskManager enthalten.

Support und zusätzliche Ressourcen

Das Google Assistant-Plug-in enthält Links zur Dokumentation, zu Codelabs, und andere Ressourcen, die dir dabei helfen, Neues zu lernen und Hilfe bei der Verwendung des Testtools zu erhalten.

Sie können Assistant in Android Studio öffnen, indem Sie Tools > Google Assistant > Hilfe auswählen.

Assistent im Testtool für App Actions Abbildung 2: Hilfebereich des Google Assistant-Plug-ins