Podczas tworzenia akcji w aplikacji możesz napotkać problemy z konfiguracją lub narzędziem testowym takich akcji. Na tej stronie opisujemy niektóre typowe problemy i ich rozwiązania.
Ogólne
Błąd: komunikat „Nie znaleziono aplikacji do otwarcia URL-a”
Sprawdź realizację urlTemplate w actions.xml, aby mieć pewność, że jest poprawnie skonfigurowana. Jeśli używasz adresów URL linków aplikacji, pamiętaj, że możesz ręcznie aktywować adres URL za pomocą właściwości ACTION_VIEW i adresu URL. Jeśli używasz adresów URL opartych na intencji, sprawdź, czy aktywność jest prawidłowo skonfigurowana pod kątem korzystania z podanych parametrów.
Błąd: „Aplikacja nie jest zainstalowana”
Ten błąd może oznaczać, że funkcja <intent-filter> w pliku AndroidManifest.xml nie filtruje precyzyjnego linku podanego w pliku actions.xml.
Sprawdź to, zanim zgłosisz błąd.
Błąd: w Android Studio pojawia się komunikat „Odniesienie do zestawu encji nie zawiera identyfikatora zestawu ani filtra URL”
Ten stan jest spowodowany znanym problemem linter w tagu <entity-set-reference>. Możesz zignorować tę wiadomość. Aby obejść ten problem, możesz wyłączyć sprawdzanie lintowania tego tagu, dodając do niego atrybut tools:ignore="ValidActionsXml".
Oto przykład odniesienia do zestawu encji z wyłączonym sprawdzaniem lintowania:
<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 udać, jeśli używasz narzędzia do zaciemniania kodu lub optymalizacji, które mają wpływ na zasoby pakietu APK wersji. Narzędzia takie jak ProGuard, które unikają plików zasobów, nie powodują tego problemu.
Aby rozwiązać ten problem, spróbuj wyłączyć narzędzie dla pliku actions.xml aplikacji (na przykład 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”. Pojawią się one w Konsoli Google Play.
Ten błąd może się pojawić podczas tworzenia wersji aplikacji w Konsoli Play. Aby zaakceptować Warunki korzystania z usługi Actions on Google, wykonaj te czynności:
- Wybierz aplikację w Konsoli Play.
- Kliknij Konfiguracja > Ustawienia zaawansowane.
- Kliknij kartę Actions on Google.
- Zaznacz pole Integruj moje usługi z działaniami w aplikacji przy użyciu 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. Pamiętaj, że pierwsze przesłanie aplikacji powinien wykonać administrator profilu w Konsoli Play.
Narzędzie testowe akcji w aplikacji
Zanim wypróbujesz którąś z poniższych poprawek, zaktualizuj instalację narzędzia testowego akcji w aplikacji do najnowszej wersji.
Wtyczka narzędzia do testowania działań w aplikacji nie może znaleźć mojego pliku actions.xml.
Sprawdź, czy w pliku AndroidManifest.xml został dodany właściwy tag <meta-data>.
Podgląd akcji w aplikacji nie pasuje do bieżącego pliku actions.xml.
Podgląd nie aktualizuje się dynamicznie zgodnie z zawartością pliku actions.xml. Gdy zmienisz plik actions.xml ręcznie lub po zmianie wersji kompilacji w Android Studio, zapisz plik actions.xml i w narzędziu testowym kliknij Zaktualizuj podgląd.
Wtyczka narzędzia do testowania działań w aplikacji przestała działać lub generuje błędy.
Najpierw upewnij się, że masz zainstalowaną najnowszą wersję Android Studio. Jeśli pojawi się błąd 403, być może korzystasz z wtyczki z pakietem, w którym nie masz uprawnień do uruchamiania.
Jeśli błąd będzie się powtarzał, zgłoś błąd i prześlij do Google te informacje:
- Szczegóły okna błędu
- Logi Android Studio. Kliknij Pomoc > Pokaż dziennik w Finderze. Zobaczysz lokalizację urządzenia
idea.logw Finderze. W pliku dziennika wyszukaj tekst „Submit Actions Request Body:” (Treść żądania działania) w pliku dziennika i wklej odpowiedzi serwera (powinny to być dwa wyniki).
Narzędzie testowe akcji w aplikacji generuje błąd UnknownHostException lub inne błędy sieci
Narzędzie testowe Akcje w aplikacji tworzy podgląd akcji w aplikacji, co pozwala przetestować integracje z Asystentem Google na pojedynczym koncie Google. Do tworzenia takich podglądów narzędzie testowe wymaga aktywnego połączenia z internetem oraz, w razie potrzeby, dostępu przez serwer proxy do domen Google.
Aby rozwiązać problemy z siecią podczas uruchamiania narzędzia testowego, sprawdź, czy nie występują te typowe problemy:
- Przed wygenerowaniem podglądów sprawdź, czy masz aktywne połączenie z internetem.
Jeśli połączenie z internetem jest aktywne, a sieć lokalna korzysta z serwera proxy, sprawdź, co się dzieje:
- Sprawdź konfigurację serwera proxy IDE. Więcej informacji znajdziesz w instrukcjach konfigurowania serwera proxy w Android 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/**.
Podczas wywoływania akcji 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 się pojawić z różnych powodów. Wykonaj te czynności:
- Zaloguj się w Android Studio, Konsoli Play i na urządzeniu testowym, używając tego samego konta Google.
- Włącz synchronizację danych urządzenia.
- Ustaw język urządzenia i Asystenta Google na
en-US. - Sprawdź, czy nazwa pakietu aplikacji w Konsoli Google Play jest taka sama jak nazwa pakietu w aplikacji testowej.
- W definicji
urlTemplaterealizacjiurlTemplatew plikuactions.xmlupewnij się, że wartościandroid:hostiandroid:schemesą zgodne z zadeklarowanymi w plikuAndroidManifest. - Usuń z urządzenia testowego wszystkie wcześniejsze instalacje aplikacji i zainstaluj nową kompilację.
- Usuń podgląd z narzędzia testowego Działania w aplikacji i ponownie utwórz nowy podgląd.
- W narzędziu Logcat sprawdź, czy nie wystąpiły błędy związane z realizacją zamówień Asystenta Google. Powinna pojawić się intencja uruchomiona przez Twoją aplikację.
- Włącz ustawienie „Informacje o aplikacjach dla Twoich urządzeń” na koncie.
- Otwórz Asystenta Google i upewnij się, że konfiguracja została zakończona. Zazwyczaj pasek postępu konfiguracji ma postać niebieskiego paska u dołu ekranu, ale w niektórych przypadkach może wyglądać inaczej.
- Jeśli do aktywowania akcji w aplikacji używasz Asystenta Google, upewnij się, że nazwa wywołania jest zgodna z podglądem utworzonym przez narzędzie testowe akcji w aplikacji.
- Spróbuj wprowadzać tekst zamiast poleceń głosowych, aby uniknąć błędów transkrypcji.
- Skonfiguruj kompilację testową w taki sposób, aby
applicationIddokładnie odpowiadał plikowi APK lub AAB przesłanym do Konsoli Google Play. Pamiętaj, że opcjonalne właściwościapplicationIdSuffixmogą zmieniać ostateczneapplicationIdkompilacji w przypadku określonych smaków produktów i wersji kompilacji. W tym przykładzie atrybutapplicationIdzastępujący smak pozornego produktu tocom.example.android.architecture.blueprints.master.mock, a niecom.example.android.architecture.blueprints. - Skonfiguruj podgląd tak, aby używał unikalnej nazwy wywołania. Spróbuj użyć niepowtarzalnego słowa, które zmniejsza ryzyko kolizji z innymi aplikacjami.
- Aby wykryć problemy podczas rozwiązywania problemów z bazą kodu z możliwością udostępniania, uruchom przykładową aplikację Fitness Actions. Upewnij się, że aplikacja Fitness działa w pełni. Następnie stopniowo dodawaj do aplikacji dodatkowe funkcje, aby sprawdzić, czy da się powielić problemy.
- Jeśli korzystasz z kont G Suite, upewnij się, że administrator włączył Asystenta Google. Aby obejść ten problem, zalecamy utworzenie konta testowego spoza G Suite i skonfigurowanie go jako licencjonowanego testera w Sklepie Play. Z tego konta testerzy powinni mieć możliwość tworzenia podglądów aplikacji i testowania ich przy użyciu tego konta na swoich urządzeniach.
- Jeśli pobierasz Asystenta Google jako oddzielną aplikację, wymuś jego zatrzymanie na urządzeniu. Zatrzymanie aplikacji można zwykle wymusić w aplikacji Ustawienia na telefonie.
- Jeśli żadna z tych czynności nie rozwiąże problemu, zgłoś problem za pomocą narzędzia do śledzenia problemów z działaniami w aplikacji.