Rozwiąż problemy

Podczas tworzenia akcji w aplikacji możesz napotkać problemy z konfiguracją lub narzędziem do testowania akcji w aplikacji. Na tej stronie opisujemy niektóre typowe problemy i sposoby ich rozwiązywania.

Ogólne

Błąd: „Nie znaleziono aplikacji, aby otworzyć URL” pojawia się w powiadomieniu wyskakującym

Sprawdź realizację zamówienia urlTemplate w actions.xml, aby upewnić się, że jest prawidłowo skonfigurowana. Jeśli używasz adresów URL linków do aplikacji, upewnij się, że możesz ręcznie wywołać adres URL za pomocą polecenia ACTION_VIEW i adresu URL. Jeśli używasz adresów URL opartych na intencjach, upewnij się, że Activity jest prawidłowo skonfigurowana do uruchamiania przy użyciu podanych parametrów.

Błąd: „Aplikacja nie jest zainstalowana”

Ten błąd może oznaczać, że element <intent-filter> w pliku AndroidManifest.xml nie filtruje precyzyjnego linku określonego w actions.xml. Zanim zgłosisz błąd, sprawdź, czy nie jest to spowodowane tym problemem.

W Android Studio pojawia się błąd: „Nie znaleziono odwołania do zestawu encji zawierającego identyfikator zestawu i filtr URL”.

Ten stan jest spowodowany znanym problemem z linterem w przypadku tagu <entity-set-reference>. Możesz zignorować tę wiadomość. Aby obejść ten problem, możesz wyłączyć sprawdzanie błędów dla tego tagu, dodając do niego atrybut tools:ignore="ValidActionsXml".

Oto przykład odniesienia do zestawu encji z wyłączonym sprawdzaniem błędów: 

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

Błąd: „Nieprawidłowa lokalizacja” dokumentu schematu działań podczas przesyłania pliku APK

Przesyłanie pliku APK może się nie powieść, jeśli używasz narzędzia do zaciemniania kodu lub optymalizacji, które wpływa na zasoby w pliku APK wersji. Narzędzia takie jak ProGuard, które nie uwzględniają plików zasobów, nie powodują tego problemu.

Aby rozwiązać ten problem, spróbuj wyłączyć narzędzie w pliku actions.xml aplikacji (np. za pomocą listy dozwolonych).

Błąd: „Aktywny plik APK lub pakiet Android App Bundle zawiera plik actions.xml. W Konsoli Google Play pojawia się komunikat „Aby kontynuować, zaakceptuj Warunki korzystania z Actions on Google”.

Ten błąd może się pojawić podczas tworzenia wersji aplikacji w Konsoli Play. Aby zaakceptować Warunki korzystania z usługi Actions on Google:

  1. Wybierz aplikację w Konsoli Play.
  2. Kliknij Konfiguracja > Ustawienia zaawansowane.
  3. Kliknij kartę Actions on Google.
  4. Zaznacz pole Integrate my services with App Actions using Actions on Google (Zintegruj moje usługi z akcjami w aplikacji za pomocą Actions on Google) i postępuj zgodnie z instrukcjami.

Przycisk „Akceptuję” w formularzu Warunków korzystania z usługi Google Play jest wyłączony.

Może to oznaczać, że zalogowany użytkownik nie ma wymaganego poziomu dostępu, aby zaakceptować te warunki. Upewnij się, że pierwsze zgłoszenie zostało przesłane przez administratora profilu w Konsoli Play.

Narzędzie do testowania akcji w aplikacji

Zanim wypróbujesz którekolwiek z poniższych rozwiązań, zaktualizuj narzędzie do testowania akcji w aplikacji do najnowszej wersji.

Wtyczka narzędzia do testowania akcji w aplikacji nie może znaleźć pliku actions.xml.

Upewnij się, że w pliku AndroidManifest.xml został dodany prawidłowy tag <meta-data>.

Podgląd akcji w aplikacji nie pasuje do mojego bieżącego pliku actions.xml.

Podgląd nie aktualizuje się dynamicznie wraz z zawartością pliku actions.xml. Po ręcznej zmianie pliku actions.xml lub po przełączeniu wariantów kompilacji w Android Studio zapisz plik actions.xml i kliknij Zaktualizuj podgląd w narzędziu do testowania.

Wtyczka narzędzia do testowania akcji w aplikacji przestała działać lub generuje błędy.

Najpierw sprawdź, czy masz zainstalowaną najnowszą wersję Android Studio. Jeśli pojawia się błąd 403, być może uruchamiasz wtyczkę w pakiecie, do którego nie masz uprawnień.

Jeśli błąd nadal występuje, zgłoś go i wyślij do Google te informacje:

  • Szczegóły okna błędu
  • Logi Android Studio. Kliknij Pomoc > Pokaż dziennik w Finderze. Pokazuje lokalizację idea.log w Finderze. Wyszukaj w pliku dziennika „Submit Actions Request Body:” i wklej odpowiedzi serwera (powinny być 2 wyniki dotyczące działań).

Narzędzie do testowania akcji w aplikacjach generuje błąd UnknownHostException lub inne błędy sieci

Narzędzie do testowania akcji w aplikacji tworzy podgląd akcji w aplikacji, umożliwiając testowanie integracji z Asystentem Google na jednym koncie Google. Aby utworzyć te podglądy, narzędzie testowe wymaga aktywnego połączenia z internetem i w razie potrzeby dostępu do domen w Google Domains przez serwer proxy.

Aby rozwiązać problemy z siecią podczas korzystania z narzędzia do testowania, sprawdź, czy nie występują te typowe problemy:

  • Przed wygenerowaniem podglądów upewnij się, że masz aktywne połączenie z internetem.

  • Jeśli połączenie z internetem jest aktywne, a sieć lokalna korzysta z serwera proxy, sprawdź te ustawienia:

    • Sprawdź konfigurację serwera proxy IDE. Więcej informacji znajdziesz w instrukcjach konfiguracji serwera proxy dla Android Studio lub IntelliJ.
    • Jeśli serwer proxy wymaga listy kontroli dostępu (ACL), zaktualizuj ją, aby zezwolić na ten wzorzec adresu URL: https://actions.googleapis.com/**.

Gdy wywołuję akcję w aplikacji za pomocą wtyczki testowej, Asystent mówi: „Nie udało mi się tego znaleźć”.

W zależności od konfiguracji ta odpowiedź może pojawić się z różnych powodów. Wykonaj te czynności:

  1. Zaloguj się w Android Studio, Konsoli Play i na urządzeniu testowym za pomocą tego samego konta Google.
  2. Włącz synchronizację danych z urządzenia.
  3. Ustaw język urządzenia i Asystenta Google na en-US.
  4. Sprawdź, czy nazwa pakietu aplikacji w Konsoli Google Play jest zgodna z nazwą pakietu w aplikacji testowej.
  5. W definicji realizacji urlTemplate w pliku actions.xml sprawdź, czy wartości android:host i android:scheme są zgodne z wartościami zadeklarowanymi w pliku AndroidManifest.
  6. Usuń wszystkie poprzednie instalacje aplikacji z urządzenia testowego i zainstaluj nową kompilację.
  7. Usuń podgląd z narzędzia do testowania akcji w aplikacjach i utwórz nowy podgląd.
  8. Sprawdź w narzędziu Logcat, czy nie występują błędy związane z realizacją żądań Asystenta Google. Powinna pojawić się intencja uruchomiona w aplikacji.
  9. Włącz na koncie ustawienie „Informacje o aplikacjach z Twoich urządzeń”.
  10. Otwórz Asystenta Google i upewnij się, że konfiguracja została zakończona. (Zwykle pasek postępu konfiguracji jest niebieski i znajduje się u dołu ekranu, ale w niektórych przypadkach może wyglądać inaczej).
  11. Jeśli używasz Asystenta Google do wywoływania akcji w aplikacji, upewnij się, że nazwa wywołania jest zgodna z podglądem utworzonym przez narzędzie do testowania akcji w aplikacji.
  12. Aby uniknąć błędów transkrypcji, spróbuj użyć wprowadzania tekstu zamiast głosu.
  13. Skonfiguruj kompilację testową tak, aby applicationId dokładnie odpowiadał plikowi APK lub pakietowi aplikacji przesłanemu do Konsoli Google Play. Pamiętaj, że opcjonalne właściwości applicationIdSuffix mogą zmienić ostateczną wartość applicationId kompilacji w przypadku niektórych wariantów usługi i wariantów kompilacji. W tym przykładzie applicationId dla przykładowego wariantu usługi to com.example.android.architecture.blueprints.master.mock, a nie com.example.android.architecture.blueprints.
  14. Skonfiguruj podgląd, aby używać unikalnej nazwy wywołania. Spróbuj użyć unikalnego słowa, które zmniejszy ryzyko kolizji z innymi aplikacjami.
  15. Aby wyizolować problemy podczas rozwiązywania problemów z bazą kodu, którą można udostępniać, spróbuj uruchomić przykładową aplikację Akcje w aplikacji – aplikacja treningowa. Upewnij się, że aplikacja treningowa działa od początku do końca. Następnie stopniowo dodawaj do tej aplikacji kolejne funkcje, aby sprawdzić, czy uda Ci się odtworzyć problemy.
  16. Jeśli używasz kont G Suite, upewnij się, że Asystent Google został włączony przez administratora. Zalecamy utworzenie konta testowego innego niż G Suite jako obejścia problemu i skonfigurowanie go jako licencjonowanego testera w Sklepie Play. Z tego konta testerzy powinni mieć możliwość tworzenia wersji testowych aplikacji i testowania ich na swoim urządzeniu.
  17. Jeśli Asystent Google został pobrany jako osobna aplikacja, spróbuj wymusić jego zatrzymanie na urządzeniu. Zatrzymanie aplikacji można zwykle wymusić w aplikacji Ustawienia na telefonie.
  18. Jeśli żadne z tych rozwiązań nie zadziała, zgłoś problem w narzędziu Issue Tracker akcji w aplikacji.