Probleme beheben

Bei der Entwicklung von App Actions können Probleme mit der Einrichtung oder 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üfe das Fulfillment urlTemplate in deinem actions.xml, um sicherzustellen, dass es richtig konfiguriert ist. Wenn du App-Link-URLs verwendest, musst du deine URL manuell mit ACTION_VIEW und der URL auslösen können. Wenn du Intent-basierte URLs verwendest, achte darauf, dass deine Aktivität richtig konfiguriert ist, damit sie mit den angegebenen Parametern gestartet werden kann.

Fehler: „App ist nicht installiert“

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

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

Dieser Zustand wird durch ein bekanntes Linter-Problem für das Tag <entity-set-reference> verursacht. In diesem Fall können Sie diese Nachricht ignorieren. Als Problemumgehung 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äts-Set-Verweis mit deaktivierter Lint-Prüfung: 

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

Fehler: „Ungültiger Standort“ für das Aktionsschema-Dokument beim Hochladen der APK

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

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

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

Dieser Fehler kann beim Erstellen eines App-Release in der Play Console auftreten. So akzeptieren Sie die Nutzungsbedingungen für 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 über 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 vorgenommen werden.

App Actions-Testtool

Bevor Sie eine der folgenden Fehlerbehebungen versuchen, aktualisieren Sie Ihre Installation des App Actions-Testtools auf die neueste Version.

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

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

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

Die Vorschau wird nicht dynamisch mit dem Inhalt der Datei actions.xml 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 Plug-in für das App Actions-Testtool funktioniert nicht mehr oder generiert Fehler.

Prüfen Sie zuerst, ob Sie Android Studio auf die aktuelle 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, melden Sie ihn bitte und senden Sie die folgenden Details an Google:

  • Details des Fehlerdialogfelds
  • Android Studio-Protokolle Gehen Sie zu Hilfe > Log im Finder anzeigen. Hier sehen Sie den Speicherort der idea.log im Finder. Suchen Sie in der Protokolldatei nach „Submit Actions Request Body:“ und fügen Sie die Serverantworten ein (es sollten zwei Ergebnisse für Aktionen vorhanden sein).

Das Testtool für App Actions generiert UnknownHostException oder andere Netzwerkfehler.

Das App Actions-Testtool erstellt eine Vorschau deiner App Actions, sodass du Google Assistant-Integrationen mit einem einzigen Google-Konto testen kannst. Zum Erstellen dieser Vorabversionen benötigt das Testtool eine aktive Internetverbindung und, falls erforderlich, einen Proxy-Zugriff auf Google-Domains.

Prüfen Sie Folgendes, um Netzwerkprobleme beim Ausführen des Testtools zu beheben:

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

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

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

Wenn Sie die App-Aktion mit dem Test-Plug-in aufrufen, sagt Assistant: „Das konnte ich leider nicht finden.“

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

  1. Melde dich mit demselben Google-Konto in Android Studio, der Play Console und auf deinem 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. Achten Sie darauf, dass die Werte für android:host und android:scheme in der urlTemplate-Definition für die Auftragsausführung in der Datei actions.xml mit den Werten in der Datei AndroidManifest ü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 aus dem App Actions-Testtool und erstellen Sie eine neue Vorschau.
  8. Prüfen Sie im Logcat-Tool, ob Fehler im Zusammenhang mit der Ausführung für Google Assistant vorliegen. Es sollte ein Intent für Ihre App gestartet werden.
  9. Aktivieren Sie die Einstellung „App-Informationen von meinen Geräten“ für das Konto.
  10. Öffne Google Assistant und schließe die Einrichtung ab. (Normalerweise wird die Fortschrittsanzeige für die Einrichtung als blauer Balken am unteren Bildschirmrand angezeigt, in einigen Fällen kann sie jedoch anders aussehen.)
  11. Wenn du Google Assistant verwendest, um eine App-Aktion auszulösen, muss der Aufrufname mit der Vorschau übereinstimmen, die vom App Actions-Testtool erstellt wurde.
  12. Verwenden Sie die Texteingabe anstelle der 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. Beachten Sie, dass optionale applicationIdSuffix-Attribute die 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 statt com.example.android.architecture.blueprints.
  14. Konfigurieren Sie die Vorschau so, dass ein eindeutiger Aufrufname verwendet wird. Verwenden Sie ein eindeutiges Wort, um die Wahrscheinlichkeit von Konflikten mit anderen Apps zu verringern.
  15. Wenn Sie Probleme mit einer gemeinsam nutzbaren Codebasis beheben möchten, können Sie die Beispiel-App „App Actions Fitness“ ausführen. Achten Sie darauf, dass die Fitness-App vollständig funktioniert. Fügen Sie dann schrittweise zusätzliche Funktionen zu dieser App hinzu, um zu sehen, ob Sie Probleme reproduzieren können.
  16. Wenn du ein G Suite-Konto verwendest, muss Google Assistant vom Administrator aktiviert werden. Wir empfehlen, als Behelfslösung ein Testkonto zu erstellen, das nicht zur G Suite gehört, und es im Google Play Store als lizenzierten Tester einzurichten. Über dieses Konto sollten Tester Vorabversionen ihrer App erstellen und die App auf ihrem Gerät testen können.
  17. Wenn Sie Google Assistant als separate App heruntergeladen haben, erzwingen Sie das Beenden der App auf Ihrem Gerät. In der Regel können Sie das Beenden einer App über die Einstellungen Ihres Smartphones erzwingen.
  18. Wenn keiner dieser Schritte funktioniert, melde das Problem im Issue Tracker für App Actions.