Rozwiąż problemy

Podczas tworzenia działań w aplikacji mogą wystąpić problemy z konfiguracją lub narzędziem do testowania działań w aplikacji. Na tej stronie opisujemy niektóre typowe problemy i ich rozwiązania.

Ogólne

Błąd: w powiadomieniu typu toast wyświetla się komunikat „Nie znaleziono aplikacji do otwarcia adresu URL”

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 aplikacji, upewnij się, że możesz ręcznie wywołać adres URL za pomocą ACTION_VIEW i adresu URL. Jeśli używasz adresów URL opartych na intencjach, upewnij się, że Twoja aktywność jest prawidłowo skonfigurowana, aby można było używać podanych parametrów.

Błąd: „Aplikacja nie jest zainstalowana”

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

Błąd: „Nie znaleziono odwołania do zestawu encji zawierającego identyfikator zestawu i filtr URL” w Android Studio

Ten warunek 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 tego tagu przez narzędzie lint, dodając do niego atrybut tools:ignore="ValidActionsXml".

Oto przykład odniesienia do zestawu encji z wyłączonym sprawdzaniem poprawności: 

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

Błąd: „Nieprawidłowa lokalizacja” w przypadku 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 lub optymalizacji, które wpływa na zasoby w pliku APK wersji. Narzędzia takie jak ProGuard, które nie korzystają z plików zasobów, nie powodują tego problemu.

Aby rozwiązać ten problem, spróbuj wyłączyć to 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. Aby kontynuować, zaakceptuj Warunki korzystania z usługi Actions on Google." w Konsoli Google Play

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

  1. Wybierz aplikację w Konsoli Play.
  2. Kliknij Konfiguracja > Ustawienia zaawansowane.
  3. Kliknij kartę Actions on Google.
  4. Zaznacz pole Zintegruj moje usługi z działaniami w aplikacji, korzystając z Actions on Google i postępuj zgodnie z instrukcjami.

Przycisk „Akceptuję” w formularzu Warunków korzystania z usług 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 pierwszą prośbę przesyła administrator profilu w Konsoli Play.

Narzędzie do testowania akcji w aplikacji

Zanim spróbujesz zastosować poniższe rozwiązania, zaktualizuj narzędzie testowe Działań w aplikacji do najnowszej wersji.

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

Sprawdź, czy w pliku AndroidManifest.xml został dodany prawidłowy tag <meta-data>.

Podgląd działania w aplikacji nie jest zgodny z moim obecnym plikiem actions.xml.

Podgląd nie aktualizuje się dynamicznie zgodnie z zawartością pliku actions.xml. Po ręcznym wprowadzeniu zmian w pliku actions.xml lub po przełączeniu wariantów kompilacji w Android Studio zapisz plik actions.xml i w narzędziu testowym kliknij Zaktualizuj podgląd.

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

Najpierw sprawdź, czy masz zainstalowaną najnowszą wersję Androida Studio. Jeśli otrzymujesz błąd 403, być może używasz wtyczki w pakiecie, w którym nie masz uprawnień do jej uruchamiania.

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

  • Okno szczegółów błędu
  • Dzienniki Android Studio. Kliknij Pomoc > Pokaż dziennik w Finderze. Pokazuje lokalizację idea.log w Finderze. W pliku dziennika wyszukaj ciąg „Submit Actions Request Body:” i wklej odpowiedzi serwera (w przypadku działań powinny być 2 wyniki).

Narzędzie do testowania działań w aplikacji generuje UnknownHostException lub inne błędy sieciowe.

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

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

  • Zanim wygenerujesz podglądy, upewnij się, że masz aktywne połączenie z internetem.

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

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

Gdy wywołuję działanie aplikacji za pomocą wtyczki testowej, Asystent odpowiada: „Nie udało mi się tego znaleźć”.

W zależności od konfiguracji ta odpowiedź może pojawiać 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 tymi 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 działań w aplikacji i utwórz nowy.
  8. Sprawdź w narzędziu Logcat, czy nie występują błędy związane z realizacją żądań w Asystencie Google. W aplikacji powinien zostać uruchomiony zamiar.
  9. Włącz ustawienie „Informacje o aplikacjach z Twoich urządzeń” na koncie.
  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 działania w aplikacji, upewnij się, że nazwa wywołania jest zgodna z podglądem utworzonym przez narzędzie do testowania działań w aplikacji.
  12. Aby uniknąć błędów transkrypcji, spróbuj wprowadzić tekst zamiast używać głosu.
  13. Skonfiguruj wersję testową tak, aby jej applicationId dokładnie odpowiadał plikowi APK lub AAB przesłanemu do Konsoli Google Play. Pamiętaj, że opcjonalne właściwości applicationIdSuffix mogą zmienić ostateczną applicationId kompilację w przypadku niektórych wersji produktów i wariantów kompilacji. W tym przykładzie wartość applicationId dla smaku produktu testowego 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. Użyj unikalnego słowa, które zmniejszy ryzyko kolizji z innymi aplikacjami.
  15. Aby wyodrębnić problemy podczas rozwiązywania problemów z kodem źródłowym, który można udostępniać, spróbuj uruchomić przykładową aplikację do ćwiczeń z działaniami w aplikacji. Upewnij się, że aplikacja do ćwiczeń działa w pełni. Następnie stopniowo dodawaj do tej aplikacji kolejne funkcje, aby sprawdzić, czy możesz odtworzyć problemy.
  16. Jeśli używasz kont G Suite, sprawdź, czy Asystent Google jest włączony przez administratora. Zalecamy utworzenie konta testowego innego niż G Suite i skonfigurowanie go jako licencjonowanego testera w Sklepie Play. Z tego konta testerzy powinni móc tworzyć podglądy aplikacji i testować ją na swoim urządzeniu.
  17. Jeśli Asystent Google został pobrany jako osobna aplikacja, spróbuj wymusić jej zatrzymanie na urządzeniu. Zwykle możesz wymusić zatrzymanie aplikacji w aplikacji Ustawienia na telefonie.
  18. Jeśli żadna z tych czynności nie rozwiąże problemu, zgłoś go w narzędziu do śledzenia problemów z działaniami w aplikacji.