Probleme beheben

Bei der Entwicklung von App Actions können Probleme mit der Einrichtung oder mit dem App Actions-Testtool auftreten. Auf dieser Seite werden einige häufig auftretende Probleme und ihre Lösungen beschrieben.

Allgemein

Fehler: In einer Toast-Benachrichtigung wird „Keine App zum Öffnen der URL gefunden“ angezeigt.

Prüfen Sie in Ihrem actions.xml, ob Ihr urlTemplate für die Erfüllung richtig konfiguriert ist. Wenn Sie App-Link-URLs verwenden, müssen Sie die URL manuell mit ACTION_VIEW und der URL aufrufen können. Wenn Sie absichtsbasierte URLs verwenden, muss Ihre Aktivität richtig konfiguriert sein, damit sie mit den bereitgestellten Parametern gestartet werden kann.

Fehler: „App ist nicht installiert“

Dieser Fehler kann darauf hinweisen, dass der <intent-filter> in Ihrer AndroidManifest.xml-Datei den Deeplink, den Sie in Ihrer actions.xml angegeben haben, nicht filtert. Prüfen Sie das zuerst, bevor Sie einen Fehler melden.

Fehler: „Es wurde ein Entitäts-Set-Verweis gefunden, der weder eine Entitäts-Set-ID noch einen URL-Filter enthält.“ wird in Android Studio angezeigt

Dieser Zustand wird durch ein bekanntes Linter-Problem für das <entity-set-reference>-Tag verursacht. Sie können diese Meldung ignorieren. Als Workaround können Sie die Lint-Prüfung für dieses Tag deaktivieren, indem Sie das Attribut tools:ignore="ValidActionsXml" hinzufügen.

Hier ein Beispiel für einen Entitätssatzverweis mit deaktivierter Lint-Prüfung: 

<entity-set-reference entitySetId="example" tools:ignore="ValidActionsXml" />

Fehler: „Ungültiger Speicherort“ für das Actions-Schemadokument beim Hochladen des APK

Der APK-Upload kann fehlschlagen, wenn Sie ein Verschleierungs- oder Optimierungstool verwenden, das sich auf Ressourcen für Ihr Release-APK auswirkt. Tools wie ProGuard, die keine Ressourcendateien verwenden, verursachen dieses Problem nicht.

Um dieses Problem zu beheben, deaktivieren Sie das Tool für die actions.xml-Datei Ihrer App, z. B. mithilfe einer Zulassungsliste.

Fehler: „Ein aktives APK oder Android App Bundle enthält eine actions.xml-Datei. In der Google Play Console wird die Meldung „Damit Sie fortfahren können, müssen Sie die Nutzungsbedingungen von Actions on Google akzeptieren.“ angezeigt.

Dieser Fehler kann beim Erstellen eines App-Release in der Play Console auftreten. So akzeptieren Sie die Nutzungsbedingungen von Actions on Google:

  1. Wählen Sie Ihre App in der Play Console aus.
  2. Gehen Sie zu Einrichten > Erweiterte Einstellungen.
  3. Klicken Sie auf den Tab Actions on Google.
  4. Klicken Sie das Kästchen mit der Bezeichnung App-Aktionen für meine Dienste über Actions on Google aktivieren an und folgen Sie der Anleitung.

Die Schaltfläche „Akzeptieren“ im Formular für die Google Play-Nutzungsbedingungen ist deaktiviert.

Das kann bedeuten, dass der angemeldete Nutzer nicht die erforderliche Zugriffsebene hat, um diese Nutzungsbedingungen zu akzeptieren. Die erste Einreichung muss vom Administrator des Play Console-Profils erfolgen.

App Actions-Testtool

Bevor Sie versuchen, die folgenden Fehler zu beheben, aktualisieren Sie Ihre Installation des App Actions-Testtools auf die neueste Version.

Das Plug-in für das App Actions-Testtool kann meine Datei actions.xml nicht finden.

Achten Sie darauf, dass Sie das richtige <meta-data>-Tag in Ihre AndroidManifest.xml-Datei eingefügt haben.

Die Vorschau meiner App Action stimmt nicht mit meiner aktuellen actions.xml-Datei überein.

Ihre Vorschau wird nicht dynamisch mit dem Inhalt Ihrer actions.xml-Datei aktualisiert. Nachdem Sie die Datei actions.xml manuell geändert oder die Build-Varianten in Android Studio gewechselt haben, speichern Sie die Datei actions.xml und klicken Sie im Testtool auf Vorschau aktualisieren.

Das App Actions-Testtool-Plug-in funktioniert nicht mehr oder es werden Fehler generiert.

Prüfen Sie zuerst, ob Sie Android Studio auf die neueste Version aktualisiert haben. Wenn Sie einen 403-Fehler erhalten, führen Sie das Plug-in möglicherweise für ein Paket aus, für das Sie keine Berechtigungen haben.

Wenn der Fehler weiterhin auftritt, erstellen Sie bitte ein Ticket und senden Sie die folgenden Details an Google:

  • Details zum Fehler-Dialogfeld
  • Android Studio-Logs. Klicken Sie auf Hilfe > Log im Finder anzeigen. Hier wird der Speicherort von idea.log im Finder angezeigt. Suchen Sie in der Logdatei nach „Submit Actions Request Body:“ und fügen Sie die Serverantworten ein (es sollten zwei Ergebnisse für Aktionen vorhanden sein).

Das App Actions-Testtool generiert UnknownHostException oder andere Netzwerkfehler

Mit dem App Actions-Testtool wird eine Vorschau Ihrer App Actions erstellt, sodass Sie Google Assistant-Integrationen mit einem einzigen Google-Konto testen können. Zum Erstellen dieser Vorschauen benötigt das Testtool eine aktive Internetverbindung und gegebenenfalls Proxyzugriff auf Google-Domains.

So beheben Sie Netzwerkprobleme beim Ausführen des Testtools:

  • Achten Sie darauf, dass eine aktive Internetverbindung besteht, bevor Sie Vorschauen generieren.

  • Wenn Ihre Internetverbindung aktiv ist und in Ihrem lokalen Netzwerk ein Proxyserver verwendet wird, prüfen Sie Folgendes:

    • Überprüfen Sie die Proxykonfiguration Ihrer IDE. Weitere Informationen finden Sie in der Anleitung zur Proxykonfiguration für Android Studio oder IntelliJ.
    • Wenn für Ihren Proxy eine Access Control List (ACL) erforderlich ist, aktualisieren Sie die ACL, um dieses URL-Muster zuzulassen: https://actions.googleapis.com/**.

Wenn ich die App Action mit dem Test-Plug-in aufrufe, sagt Assistant: „Tut mir leid, das konnte ich nicht finden.“

Je nach Einrichtung kann diese Antwort aus verschiedenen Gründen angezeigt werden. Versuchen Sie Folgendes:

  1. Melden Sie sich mit demselben Google-Konto in Android Studio, der Play Console und auf Ihrem Testgerät an.
  2. Aktivieren Sie die Synchronisierung von Gerätedaten.
  3. Stelle die Sprache des Geräts und von Google Assistant auf en-US ein.
  4. Prüfen Sie, ob der Paketname der Anwendung in der Google Play Console mit dem Paketnamen in der Testanwendung übereinstimmt.
  5. Prüfen Sie in der urlTemplate-Definition für die Ausführung in Ihrer actions.xml-Datei, ob die Werte android:host und android:scheme mit den Werten in der AndroidManifest-Datei übereinstimmen.
  6. Entfernen Sie alle vorherigen Installationen Ihrer App von Ihrem Testgerät und installieren Sie einen neuen Build.
  7. Löschen Sie die Vorschau im App Actions-Testtool und erstellen Sie eine neue Vorschau.
  8. Suchen Sie im Logcat-Tool nach Fehlern im Zusammenhang mit der Ausführung für Google Assistant. Es sollte ein Intent für Ihre App gestartet werden.
  9. Aktivieren Sie die Einstellung „App-Informationen von Geräten“ für das Konto.
  10. Öffnen Sie Google Assistant und stellen Sie sicher, dass Sie die Einrichtung abgeschlossen haben. Normalerweise wird die Fortschrittsanzeige für die Einrichtung als blauer Balken unten auf dem Bildschirm angezeigt. In einigen Fällen kann sie jedoch anders aussehen.
  11. Wenn Sie Google Assistant verwenden, um eine App Action auszulösen, muss der Aufrufname mit der Vorschau übereinstimmen, die vom App Actions-Testtool erstellt wurde.
  12. Versuchen Sie, Text statt Sprache zu verwenden, um Transkriptionsfehler zu vermeiden.
  13. Konfigurieren Sie Ihren Test-Build so, dass die applicationId genau mit einem in die Google Play Console hochgeladenen APK oder AAB übereinstimmt. Beachten Sie, dass optionale applicationIdSuffix-Attribute das endgültige applicationId von Builds für bestimmte Produktvarianten und Build-Varianten ändern können. In diesem Beispiel ist die applicationId für die Mock-Produktvariante com.example.android.architecture.blueprints.master.mock anstelle von com.example.android.architecture.blueprints.
  14. Konfigurieren Sie die Vorschau so, dass sie einen eindeutigen Aufrufnamen verwendet. Verwenden Sie ein eindeutiges Wort, um die Wahrscheinlichkeit einer Kollision mit anderen Apps zu verringern.
  15. Um Probleme bei der Fehlerbehebung eines gemeinsam nutzbaren Quellcodes zu isolieren, versuchen Sie, die Beispiel-App Actions-Fitness-App auszuführen. Achten Sie darauf, dass die Fitness-App durchgängig funktioniert. Fügen Sie dann nach und nach weitere Funktionen hinzu, um zu sehen, ob Sie Probleme reproduzieren können.
  16. Wenn Sie G Suite-Konten verwenden, muss Google Assistant vom Administrator aktiviert werden. Als Workaround empfehlen wir, ein Testkonto zu erstellen, das kein G Suite-Konto ist, und es als lizenzierten Tester über den Play Store einzurichten. Über dieses Konto sollten Tester in der Lage sein, Vorschauen für ihre App zu erstellen und die App auf ihrem Gerät zu testen.
  17. Wenn Sie Google Assistant als separate App heruntergeladen haben, versuchen Sie, das Beenden der App auf Ihrem Gerät zu erzwingen. In der Regel können Sie das Beenden einer App über die App „Einstellungen“ auf Ihrem Smartphone erzwingen.
  18. Wenn keiner dieser Schritte funktioniert, melden Sie ein Problem im Issue Tracker für App Actions.