Google Assistant-Plug-in für Android Studio

Das Google Assistant-Plug-in testet App-Aktionen in Android Studio. Bei der Entwicklung und beim Testen verwenden Sie das Plug-in, um eine Vorschau Ihrer App-Aktionen in Assistant für Ihr Google-Konto zu erstellen. Sie können dann testen, wie die App Action verschiedene Parameter verarbeitet, bevor Sie sie zur Bereitstellung einreichen.

So funktionierts

Das Google Assistant-Plug-in enthält das App Actions-Testtool, eine Funktion, die Ihre shortcuts.xml-Datei parst und eine Vorschau Ihrer App Actions für ein einzelnes Google-Konto erstellt. Mit diesen Vorschauen kann Google Assistant deine App-Aktionen erkennen, bevor die Produktionsversion deiner App in der Google Play Console bereitgestellt wird.

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 diese Werte dann ändern, um Ihre App-Aktionen mit aussagekräftigen Parameterkombinationen zu testen und sicherzustellen, dass sie die richtigen App-Funktionen ausführen. Vorschauen werden im Testtool erstellt, aktualisiert und gelöscht, sodass Sie Ihre App-Aktionen in einer sicheren Umgebung iterieren und testen können.

Nachdem eine Vorschau erstellt wurde, können Sie direkt im Fenster des Testtools eine App-Aktion auf Ihrem Testgerät auslösen. Bei BIIs, die für Nutzertrigger verfügbar sind, können Sie app name direkt in Assistant auf Ihrem Gerät verwenden, um Ihre App Action auszuprobieren. Sie können beispielsweise sagen: „Hey Google, starte mein Training mit der Beispiel-App“, um eine App-Aktion zu starten, die actions.intent.START_EXERCISE BII verwendet.

Unterstützung der Sprache

Das Erstellen von Vorschauen für bestimmte Sprachen im Testtool variiert je nach BII. Auf der Seite für jede BII in der Referenz zum integrierten Intent finden Sie Informationen dazu, welche Funktionen für diese BII verfügbar sind, z. B. ob das Testtool das Erstellen von Vorschauen für eine bestimmte Sprache unterstützt und ob Nutzer App-Aktionen auslösen können.

Plug-in abrufen

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

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

  1. Gehen Sie zu Datei > Einstellungen (Android Studio > Einstellungen unter macOS).
  2. Gehen Sie im Abschnitt Plug-ins zu 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 aus dem öffentlichen Jetbrains-Repository herunterladen.

Einrichtungsanforderungen

Für die Verwendung des Google Assistant-Plug-ins sind mehrere Konfigurationsschritte erforderlich, damit Ihre App Action erfolgreich getestet werden kann. Insbesondere müssen Sie in Android Studio, auf Ihrem Testgerät und für den Zugriff auf die Google Play Console dasselbe Nutzerkonto verwenden.

Bereiten Sie Ihre Entwicklungsumgebung mit den folgenden Konfigurationen vor:

Einschränkungen

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

  • App-Aktionen, die Webinventar und den Aufruf von Apps im Vordergrund enthalten, können nicht direkt im Testtool oder mit adb-Befehlen (Android Debug Bridge) getestet werden. Um diese App-Aktionen zu testen, müssen Sie zuerst mit dem Testtool eine Vorschau erstellen. Lösen Sie diese App-Aktionen dann aus, indem Sie auf Ihrem physischen Gerät mit Google Assistant interagieren.
  • Inline-Inventar für die actions.intent.OPEN_APP_FEATURE BII kann nur sechs Stunden nach dem Erstellen oder Aktualisieren einer Vorschau getestet werden. Aktualisieren Sie die Vorschau des Testtools oder erstellen Sie eine neue Vorschau, um den sechsstündigen Zeitraum zurückzusetzen.

Weitere Tester hinzufügen

Sie können zusätzliche Nutzer in Ihr Projekt einladen, damit sie Ihre App Actions-Integration testen können. Das ist nützlich, wenn Sie das Projekt für andere Mitglieder Ihres Entwicklungsteams freigeben möchten, damit diese es testen können, oder wenn Sie Ihr Projekt zur Vorbereitung auf den Produktionsstart für QA-Tester freigeben. Tester müssen im Google Play Store als Lizenztester hinzugefügt werden und Lesezugriff auf die Google Play Console haben.

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 diesem Play Console-Hilfethema.

    Füge über die Google Play Console einen Lizenztester hinzu.
    Abbildung 1: Ein Lizenztester wird hinzugefügt.

  3. Lade das Google-Konto des Lizenztesters als Nutzer mit Lesezugriff in der Google Play Console ein.

    1. Wählen Sie Nutzer und Berechtigungen > Neue Nutzer einladen > App hinzufügen aus.
    2. Achten Sie darauf, dass unter App-Zugriff das Häkchen aus dem Kästchen Administrator (alle Berechtigungen) entfernt ist.

Sie müssen sich für jeden Tester, den Sie für den Vorschautest aktivieren möchten, separat mit dem Google-Konto des entsprechenden Nutzers in Android Studio anmelden. Nach der Anmeldung mit dem Google Assistant-Plug-in erstellen Sie eine Vorschau für den Testnutzer.

Google Assistant-Plug-in verwenden

Rufen Sie in Android Studio das App Actions-Testtool auf. Rufen Sie dazu Tools > Google Assistant > App Actions-Testtool auf. Wenn Sie das Tool öffnen, ändert sich die Ansicht abhängig davon, ob Sie ein aktives Testtool haben.

Vorschauen erstellen, aktualisieren und löschen

Du kannst zum Testen eine Entwurfsversion der App verwenden. Weitere Informationen finden Sie unter Release vorbereiten und einführen. Teste deine App im Entwurfsmodus, bevor du sie zur Überprüfung einreichst.

Das Testtool erstellt Vorschauen basierend auf Ihrem Google-Konto und dem Namen Ihres App-Pakets (Anwendungs-ID), sodass Sie mehrere Apps mit demselben Google-Konto testen können. Solange die Anwendungs-ID für jede Anwendung unterschiedlich ist, können Sie weiterhin dasselbe Google-Konto zum Erstellen und Testen der Vorschau verwenden. Mehrere Google-Konten mit Zugriff auf dasselbe Anwendungspaket können jeweils das Testtool verwenden, um separate Vorschauen für diese Anwendung 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. Der standardmäßige Name und die Sprache der Anwendung sind test app action und en.
  3. Klicken Sie auf Vorschau erstellen. Lesen und akzeptieren Sie die Richtlinien und Nutzungsbedingungen für App Actions, wenn Sie dazu aufgefordert werden. Nachdem die Vorschau erstellt wurde, wird das Testtool-Fenster aktualisiert und zeigt Informationen zu BIIs in der Datei shortcuts.xml an.

Das Testtool verwendet den App-Namen, um Assistant-Abfragen für Ihre App Actions zu erstellen und zu simulieren. Bereitgestellte App-Aktionen verwenden für den Aufruf den Namen Ihrer Play Store App. Sie können jedoch einen beliebigen Aufrufnamen im Testtool verwenden. Wir empfehlen jedoch, im Testtool den Namen der Anwendung als Aufrufnamen zu verwenden.

Die von Ihnen angegebene Sprache muss mit der Sprache von Google Assistant auf Ihrem Testgerät übereinstimmen. Sie können eine Vorschau jeweils nur in einer Sprache erstellen. Wenn Ihre Assistant-Sprache beispielsweise Englisch (USA) ist, können Sie en-US eingeben, aber nicht en-**, en-GB oder en-US, en-GB. Sie können eine Stammsprache wie en verwenden, 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 im Testtool auf die Schaltfläche Löschen. Geben Sie dann den gewünschten Anwendungsnamen und die Sprache ein, bevor Sie eine neue Vorschau erstellen.

Wenn Sie eine vorhandene Vorschau mit der Datei shortcuts.xml aktualisieren möchten, klicken Sie im Testtool auf die Schaltfläche Aktualisieren. Informationen zur aktuellen Vorschau finden Sie im Abschnitt Test App Action (App-Aktion testen) des Testtoolfensters.

BII konfigurieren

Nachdem Sie eine Vorschau für Ihre App erstellt haben, können Sie verschiedene Parameterwerte für BIIs im Plug-in testen. Für jede BII in der Datei shortcuts.xml rendert das Plug-in ein entsprechendes JSON-LD-Objekt und stellt Standardparameterwerte bereit. Sie können diese Standardwerte ändern, um Ihre App-Aktionen mit aussagekräftigen Parameterkombinationen zu testen und sicherzustellen, dass sie die richtigen App-Funktionen ausführen.

Parameter und ihre Werte folgen in der Regel der Struktur schema.org oder schema.googleapis.com für Attribute und Beschreibungen. Informationen zu jedem BII-Parameter erhalten Sie in den Schematypbeschreibungen eines Parameters und der zugehörigen übergeordneten Parameter.

Beispielsweise unterstützt die BII von actions.intent.CREATE_MONEY_TRANSFER den Intent-Parameter moneyTransfer.transferMode. Auf der Seite schema.googleapis.com für MoneyTransfer wird transferMode als Attribut aufgeführt. Das Attribut transferMode ist eine Übertragungsart und erwartet Werte (z. B. SendMoney) des Aufzählungstyps FinancialTransferMode.

Im Testtool können Sie eine der Aufzählungen als Wert für transferMode angeben:

  • http://schema.googleapis.com/SendMoney
  • http://schema.googleapis.com/ReceiveMoney

App-Aktionen auslösen

Nachdem Sie eine Vorschau erstellt und einen BII konfiguriert haben, können Sie direkt im Testtool-Fenster eine App-Aktion auf Ihrem Testgerät auslösen.

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

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

App-Aktionen, die im Testtool ausgelöst werden, verwenden den angezeigten Befehl Android Debug Bridge (adb). Der generierte adb-Shell-Befehl enthält alle Metadaten, die die Google-Anwendung zum Ausführen einer BII benötigt. Bei diesem Ansatz wird das Verhalten Ihrer App-Aktion nachgeahmt, nachdem Assistant wichtige Informationen aus einer Abfrage extrahiert hat.

Protokollierung in Android Studio

Spezifische Logs für das Testtool sind in den Android Studio-Protokolldateien und nicht als Logcat-Ausgabe verfügbar. Prozesse, die direkt auf Ihrer Workstation ausgeführt werden, generieren Android Studio-Logs. Sie können sie verwenden, um Fehler bei Testtoolvorgängen wie dem Erstellen, Aktualisieren oder Löschen einer Vorschau zu beheben.

Rufen Sie Hilfe > Log-in-Explorer anzeigen auf, um auf Ihre Android Studio-Protokolldateien zuzugreifen (unter macOS Hilfe > Log-in-Finder anzeigen).

Logs zu App-Aktionen in Ihrer App sind in Logcat verfügbar. Logcat erfasst Protokolle von virtuellen oder physischen Geräten, die mit Android Studio verbunden sind.

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

  1. Sie können auf Ihre Logcat-Logmeldungen zugreifen, indem Sie in der Symbolleiste des Android Studio-Toolfensters auf Logcat klicken.
  2. Suchen Sie nach Logs, die ActivityTaskManager enthalten.

Support und zusätzliche Ressourcen

Das Google Assistant-Plug-in bietet Links zu Dokumentation, Codelabs und anderen Ressourcen, die Ihnen bei der Verwendung des Testtools helfen können.

Du kannst Assistant in Android Studio öffnen, indem du Tools > Google Assistant > Hilfe auswählst.

Assistent für App Actions-Testtools Abbildung 2: Im Hilfebereich des Google Assistant-Plug-ins.