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: „Keine App zum Öffnen der URL gefunden“ wird in einer Toast-Benachrichtigung angezeigt

Prüfen Sie, ob die urlTemplate für die Auftragsausführung in actions.xml richtig konfiguriert ist. Wenn du App-Link-URLs verwendest, musst du deine URL manuell mit ACTION_VIEW und der URL auslösen. Wenn du absichtsbasierte URLs verwendest, muss deine Aktivität richtig konfiguriert sein, damit die angegebenen Parameter verwendet werden können.

Fehler: „App ist nicht installiert“

Dieser Fehler kann bedeuten, dass die <intent-filter> in der AndroidManifest.xml-Datei den Deeplink, den du in deinem actions.xml angegeben hast, nicht filtert. Überprüfe dies zuerst, bevor du einen Fehler meldest.

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

Diese Bedingung wird durch ein bekanntes Linter-Problem für das <entity-set-reference>-Tag verursacht. In diesem Fall können Sie diese Nachricht ignorieren. Als Behelfslösung können Sie die Lint-Prüfung für dieses Tag deaktivieren, indem Sie ihm das Attribut tools:ignore="ValidActionsXml" hinzufügen.

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

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

Fehler: "Ungültiger Speicherort" für Aktionsschema-Dokument beim Hochladen des APK

Der APK-Upload kann fehlschlagen, wenn du ein Verschleierungs- oder Optimierungstool verwendest, das sich auf Ressourcen für dein Release-APK auswirkt. Tools wie ProGuard, die Ressourcendateien vermeiden, verursachen dieses Problem nicht.

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

Fehler: „Ein aktives APK oder Android App Bundle enthält eine actions.xml-Datei. Damit du fortfahren kannst, musst du die Nutzungsbedingungen von Actions on Google akzeptieren.“ wird in der Google Play Console angezeigt.

Dieser Fehler kann auftreten, wenn Sie einen App-Release in der Play Console erstellen. So akzeptierst du 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. Klicke auf das Kästchen Integrate my services with App Actions using Actions on Google (Meine Dienste mithilfe von Actions on Google in App Actions einbinden) und folge 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.

Testtool für App Actions

Bevor du eine der folgenden Fehlerbehebungen probierst, musst du deine Installation des App Actions-Testtools auf die neueste Version aktualisieren.

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

Prüfen Sie, ob Sie der Datei AndroidManifest.xml das richtige <meta-data>-Tag hinzugefügt haben.

Die Vorschau meiner App-Aktion stimmt nicht mit meiner aktuellen Datei „actions.xml“ überein.

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

Das Plug-in für das App Actions-Testtool funktioniert nicht mehr oder generiert Fehler.

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 auch in einem Paket aus, für das Sie keine Berechtigungen zur Ausführung haben.

Wenn der Fehler weiterhin besteht, melden Sie ihn bitte und senden Sie die folgenden Informationen an Google:

  • Details zum Fehlerdialog
  • Android Studio-Protokolle. Gehe zu Hilfe > Protokoll im Finder anzeigen. Dadurch wird die Position von idea.log im Finder angezeigt. Suchen Sie in der Protokolldatei nach "Submit Actions Request Body:" und fügen Sie die Serverantworten ein. Es sollten zwei Ergebnisse für Aktionen angezeigt werden.

Das App Actions-Testtool generiert UnknownHostException oder andere Netzwerkfehler

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

Prüfen Sie, ob die folgenden häufigen Probleme vorliegen, um Netzwerkprobleme beim Ausführen des Testtools zu beheben:

  • Achten Sie darauf, dass Sie eine aktive Internetverbindung haben, bevor Sie Vorschauen erstellen.

  • Wenn Ihre Internetverbindung aktiv ist und Ihr lokales Netzwerk einen Proxyserver verwendet, prüfen Sie Folgendes:

    • Prüfen Sie Ihre IDE-Proxykonfiguration. Weitere Informationen finden Sie in der Anleitung zur Proxykonfiguration für Android Studio bzw. IntelliJ.
    • Wenn Ihr Proxy eine Access Control List (ACL) benötigt, aktualisieren Sie die ACL, um das folgende URL-Muster zuzulassen: https://actions.googleapis.com/**.

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

Je nach Einrichtung kann diese Antwort aus verschiedenen Gründen angezeigt werden. Führe die folgenden Schritte aus:

  1. Melden Sie sich in Android Studio, der Play Console und Ihrem Testgerät mit demselben Google-Konto 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üfe, ob der Paketname der App in der Google Play Console mit dem Paketnamen in der Test-App übereinstimmt.
  5. Achten Sie in der Definition urlTemplateder Auftragsausführung der actions.xml-Datei darauf, dass die Werte android:host und android:scheme mit der Deklaration in der Datei AndroidManifest übereinstimmen.
  6. Entfernen Sie alle früheren Installationen Ihrer App von Ihrem Testgerät und installieren Sie einen neuen Build.
  7. Löschen Sie die Vorschau aus dem App Actions-Testtool und erstellen Sie noch einmal eine neue Vorschau.
  8. Suchen Sie im Logcat-Tool nach Fehlern im Zusammenhang mit der Auftragsausführung für Google Assistant. Sie sollten einen Intent für Ihre App sehen.
  9. Aktiviere die Einstellung „App-Informationen für meine Geräte“ für das Konto.
  10. Öffnen Sie Google Assistant und prüfen Sie, ob Sie die Einrichtung abgeschlossen haben. Der Fortschrittsbalken der Einrichtung wird in der Regel als blaue Leiste am unteren Bildschirmrand angezeigt, kann aber in manchen Fällen anders aussehen.
  11. Wenn Sie Google Assistant zum Auslösen einer App-Aktion verwenden, muss der Aufrufname mit der Vorschau übereinstimmen, die vom App Actions-Testtool erstellt wurde.
  12. Verwende Texteingabe statt Spracheingabe, um Transkriptionsfehler zu vermeiden.
  13. Konfiguriere deinen Test-Build so, dass die applicationId genau mit einem APK oder AAB übereinstimmt, das in die Google Play Console hochgeladen wurde. Mit optionalen applicationIdSuffix-Attributen können die endgültigen applicationId von Builds für bestimmte Produktvarianten und Build-Varianten geändert werden. In diesem Beispiel lautet der applicationId für die Beispielproduktsorte com.example.android.architecture.blueprints.master.mock und nicht com.example.android.architecture.blueprints.
  14. Konfiguriere deine Vorschau so, dass ein eindeutiger Aufrufname verwendet wird. Verwenden Sie ein eindeutiges Wort, um das Risiko von Konflikten mit anderen Anwendungen zu verringern.
  15. Um Probleme bei der Fehlerbehebung einer gemeinsam nutzbaren Codebasis zu isolieren, führen Sie die Beispiel-App Actions Fitness App aus. Achten Sie darauf, dass die Fitness-App durchgängig funktioniert. Füge dieser App dann schrittweise weitere Funktionen hinzu, um zu sehen, ob sich die Probleme reproduzieren lassen.
  16. Wenn Sie G Suite-Konten verwenden, muss Google Assistant vom Administrator aktiviert werden. Wir empfehlen, als Behelfslösung ein Nicht-G Suite-Testkonto zu erstellen und es als lizenzierten Tester über den Play Store einzurichten. Über dieses Konto sollten Tester Vorschauen für ihre App erstellen und mit diesem Konto auf ihrem Gerät testen können.
  17. Wenn Sie Google Assistant als separate App heruntergeladen haben, können Sie das Beenden auf Ihrem Gerät erzwingen. In der Regel können Sie das Beenden einer App über die Einstellungen Ihres Smartphones erzwingen.
  18. Wenn keiner dieser Schritte funktioniert, melden Sie ein Problem in der App Action-Problemverfolgung.