Wtyczka Asystenta Google testuje działania aplikacji w Android Studio. Podczas tworzenia i testowania możesz użyć wtyczki, aby wyświetlić podgląd działań w aplikacji w Asystencie na swoim koncie Google. Następnie możesz sprawdzić, jak Akcja w aplikacji obsługuje różne parametry, zanim prześlesz ją do wdrożenia.
Jak to działa
Wtyczka Asystenta Google zawiera narzędzie App Actions Test Tool, które analizuje plik skróty.xml i tworzy podgląd akcji w aplikacji dla jedno konto Google. Te podglądy umożliwiają Asystentowi Google rozpoznawanie działań aplikacji przed wdrożeniem produkcyjnej wersji aplikacji w Konsoli Google Play.
W przypadku każdej intencji wbudowanej w pliku skróty.xml narzędzie renderuje odpowiedni obiekt JSON-LD i zawiera domyślne wartości parametrów. Następnie możesz zmodyfikować te wartości, aby przetestować akcje w aplikacji za pomocą różnych kombinacji parametrów i upewnić się, że działają one prawidłowo. Podglądy są tworzyć, aktualizować i usuwać w narzędziu testowym, co umożliwia iterację testować działania w aplikacji w bezpiecznym środowisku.
Po utworzeniu podglądu możesz wywołać działanie w aplikacji na urządzeniu testowym
bezpośrednio z okna narzędzia testowego. W przypadku interfejsów BIIs, które są dostępne do wywołania przez użytkownika, możesz użyć app name
bezpośrednio w Asystencie na swoim urządzeniu, aby wypróbować działanie akcji w aplikacji. Możesz na przykład powiedzieć „OK Google,
Rozpocznij ćwiczenie przy użyciu Przykładowa aplikacji, aby uruchomić akcję w aplikacji, która wykorzystuje
actions.intent.START_EXERCISE
BII.
Obsługa języków
Tworzenie podglądów w przypadku określonych języków w narzędziu testowym różni się w zależności od BII. Na stronie każdego typu BII we dokumentacji wbudowanej intencji znajdziesz z informacjami o funkcjach dostępnych w ramach tego BII, czy narzędzie testowe obsługuje tworzenie podglądów w konkretnym języku, czy akcje w aplikacji są dostępne do uruchomienia przez użytkowników.
Pobierz wtyczkę
Wtyczka Asystenta Google jest dostępna w Android Studio. Informacje o instalowaniu i korzystaniu z Androida Studio znajdziesz na stronie Android Studio.
Aby zainstalować wtyczkę Asystenta Google w Android Studio, wykonaj te czynności:
- Kliknij Plik > Ustawienia (Android Studio > Ustawienia w systemie macOS).
- W sekcji Wtyczki otwórz Marketplace i wyszukaj „Wtyczka Asystenta Google”.
- Zainstaluj narzędzie i ponownie uruchom Android Studio.
Możesz też pobrać wtyczkę bezpośrednio z publicznego repozytorium Jetbrains.
Wymagania związane z konfiguracją
Korzystanie z wtyczki Asystenta Google wymaga kilku kroków konfiguracyjnych, umożliwia pomyślne przetestowanie akcji w aplikacji. W szczególności należy użyć atrybutu tego samego konta użytkownika w Android Studio, na urządzeniu testowym i w Google Play dostęp do konsoli.
Przygotuj środowisko programistyczne przy użyciu tych konfiguracji:
- Zaloguj się w Android Studio (w wersji 4.0 lub nowszej).
- Zaloguj się w aplikacji Google na urządzeniu testowym z Androidem, używając tego samego konta.
- Dostęp do Konsoli Play masz na tym samym koncie. do przesłanego pakietu aplikacji do przetestowania.
- Otwórz aplikację Google na urządzeniu testowym z Androidem i dokończ początkowy etap Proces konfiguracji Asystenta.
- Włącz synchronizację danych z urządzenia na urządzeniu testowym.
Ograniczenia
Wtyczka Asystenta Google ma te ograniczenia:
- Działania w aplikacji, które obejmują internetowe zasoby reklamowe
i wywoływanie aplikacji na pierwszym planie
nie można przetestować bezpośrednio w narzędziu testowym ani za pomocą mostka debugowania Androida (
adb
) poleceń. Aby przetestować te działania w aplikacji, najpierw utwórz podgląd, korzystając z testu . Następnie uruchom te działania w aplikacji, korzystając z Asystenta Google na urządzeniu fizycznym. - Wbudowane zasoby reklamowe dla
actions.intent.OPEN_APP_FEATURE
BII można przetestować tylko przez 6 godzin od wersji przedpremierowej utworzonych lub zaktualizowanych. Zaktualizuj podgląd narzędzia testowego lub utwórz nowy podgląd, aby zresetuje 6-godzinny okres.
Dodawanie kolejnych testerów
Możesz zaprosić do projektu dodatkowych użytkowników, którzy będą mogli Integracja z akcjami w aplikacji. Jest to przydatne, gdy chcesz udostępnić projekt innym członkom zespołu programistycznego, aby mogli go przetestować, lub gdy udostępniasz projekt testerom kontroli jakości w ramach przygotowań do wdrożenia wersji produkcyjnej. Testerów należy dodać jako testerów licencji w Google Sklepu Play i przyznano dostęp tylko do odczytu do Konsoli Google Play.
Aby dodać dodatkowych testerów:
- Zaloguj się w Konsoli Play.
Wykonaj instrukcje z sekcji Konfigurowanie licencjonowania aplikacji w tym artykule: w artykule w Centrum pomocy Konsoli Play.
Zaproś konto Google testującego licencję jako użytkownika Konsoli Google Play tylko do odczytu.
- Wybierz Użytkownik i uprawnienia > Zaproś nowych użytkowników > Dodaj aplikację.
- W sekcji Dostęp aplikacji upewnij się, że pole Administrator (wszystkie uprawnienia) jest wyczyszczono.
Musisz zalogować się w przypadku każdego testera, któremu chcesz włączyć wersję testową niezależnie od Android Studio, używając konta Google tego użytkownika. Po zalogowaniu użyj wtyczki Asystent Google, by utworzyć podgląd dla użytkownika testowego.
Korzystanie z wtyczki Asystenta Google
Otwórz narzędzie do testowania działań w aplikacji w Android Studio, klikając Narzędzia > Asystent Google > Narzędzie testowe akcji w aplikacji. Po otwarciu narzędzia widok zmienia się w zależności od tego, czy masz aktywny podgląd narzędzia testowego.
Tworzenie, aktualizowanie i usuwanie podglądów
Do testowania możesz użyć wersji roboczej aplikacji. Aby dowiedzieć się więcej, Więcej informacji znajdziesz w artykule Przygotowywanie i publikowanie wersji. Przetestuj aplikację w wersji roboczej przed przesyłając go do sprawdzenia.
Narzędzie do testowania tworzy podglądy na podstawie nazwy Twojego konta Google i pakietu aplikacji (identyfikator aplikacji), dzięki czemu możesz testować wiele aplikacji Konto Google. Jeśli identyfikator aplikacji jest inny dla każdej z nich, mogą nadal używać tego samego konta Google do tworzenia i testowania wersji przedpremierowej. Kilka kont Google z dostępem do tego samego pakietu aplikacji może używać aby utworzyć osobne podglądy tej aplikacji.
Aby utworzyć podgląd, wykonaj te czynności w Android Studio:
- Otwórz narzędzie testowe akcji w aplikacji.
- Opcjonalnie wpisz nazwę aplikacji i język, na których chcesz przeprowadzić test. Domyślny
nazwa i język aplikacji to
test app action
ien
. - Kliknij Utwórz podgląd. Jeśli pojawi się taka prośba, zapoznaj się z zasadami i warunkami usługi dotyczącymi akcji w aplikacji oraz je zaakceptuj. Gdy utworzysz podgląd, aktualizacji okien, aby wyświetlić informacje o BII znalezionych w skróty.xml.
Narzędzie testowe używa nazwy aplikacji do utworzenia i symulowania Asystenta. zapytań w ramach akcji w aplikacji. Wdrożone akcje w aplikacji używają nazwy Twojej aplikacji ze Sklepu Play , ale w narzędziu testowym możesz użyć dowolnej nazwy wywołania. Zalecamy jednak używanie nazwy aplikacji jako nazwy wywołania w interfejsie i testowania.
Podany przez Ciebie region musi odpowiadać językowi Asystenta Google na Twoim
na urządzeniu testowym, a podgląd możesz utworzyć tylko w jednym języku naraz. Jeśli na przykład ustawisz język Asystenta na angielski (USA), możesz wpisać en-US
, ale nie en-**
, en-GB
ani en-US, en-GB
. Możesz użyć lokalizacji głównej, takiej jak en
, aby uwzględnić zarówno en-GB
, jak i en-US
.
Aby zmienić nazwę aplikacji lub wybrany język dla istniejącego podglądu, kliknij kliknij przycisk Usuń w narzędziu testowym. Następnie wpisz odpowiednią wartość nazwę i język aplikacji, zanim utworzysz nowy podgląd.
Aby zaktualizować istniejący podgląd tak, aby pasował do pliku skróty.xml, kliknij Aktualizuj w narzędziu testowym. Informacje o bieżącym Podgląd znajduje się w sekcji Testuj działanie w aplikacji w oknie narzędzia testowego.
Konfigurowanie BII
Po utworzeniu podglądu aplikacji możesz przetestować różne parametry we wtyczce. Za każdy BII skróty.xml, wtyczka renderuje odpowiedni plik Obiekt JSON-LD z domyślnymi wartościami parametrów. Możesz je zmienić wartości domyślne do testowania działań w aplikacji z użyciem istotnych kombinacji parametrów i sprawdzać, czy działają one poprawnie.
Parametry i ich wartości zwykle mają postać schema.org
lub
schema.googleapis.com
dla właściwości i opisów. Więcej
informacje o dowolnym parametrze BII uzyskanym ze schematu
opis parametru i jego parametrów wyższego poziomu.
Na przykład actions.intent.GET_FOOD_OBSERVATION
BII
obsługuje parametr intencji foodObservation.forMeal
.
Strona schema.googleapis.com
dla MealType
zawiera listę name
jako
usłudze.
Właściwość forMeal
to tryb przenoszenia i oczekuje,
wartości (takie jak MealTypeLunch
) wyliczanego typu MealType
.
W
możesz podać dowolne z tych wyliczeń jako wartość
foodObservation.forMeal
:
https://schema.googleapis.com/MealTypeSnack
https://schema.googleapis.com/MealTypeBrunch
https://schema.googleapis.com/MealTypeLunch
https://schema.googleapis.com/MealTypeBreakfast
https://schema.googleapis.com/MealTypeDinner
https://schema.googleapis.com/MealTypeDesert
Wywoływanie działań w aplikacji
Po utworzeniu podglądu i skonfigurowaniu usługi BII możesz aktywować Akcja w aplikacji na urządzeniu testowym bezpośrednio z okna narzędzia testowego.
Aby wywołać działanie w aplikacji za pomocą narzędzia testowego, wykonaj te czynności:
- Podłącz urządzenie testowe.
- W sekcji Wybierz urządzenie docelowe wskaż urządzenie, na którym chcesz wywoła działanie w aplikacji.
- W sekcji Testuj działanie aplikacji kliknij przycisk Uruchom działanie w aplikacji.
Akcje w aplikacji uruchomione w narzędziu testowym wykorzystują wyświetlone
Android Debug Bridge (adb
). Wygenerowane polecenie powłoki adb
zawiera wszystkie metadane wymagane przez aplikację Google do wykonania analizy BII.
Ta metoda naśladuje działanie akcji w aplikacji po działaniu Asystenta
wyodrębnia kluczowe informacje z zapytania.
Rejestrowanie w Android Studio
Dzienniki dotyczące narzędzia testowego są dostępne w pliki dziennika Androida Studio, nie pliki Logcat. dane wyjściowe. Procesy działające bezpośrednio na stacji roboczej generują dzienniki Android Studio. Możesz ich używać do rozwiązywania problemów z operacjami narzędzi testowych, takimi jak tworzenie, zaktualizowanie lub usunięcie podglądu.
Aby uzyskać dostęp do plików z logiem Android Studio, kliknij Pomoc > Pokaż dziennik w Eksploratorze (Pomoc > Pokaż dziennik w Eksploratorze w systemie macOS).
Dzienniki związane z aplikacją dotyczącą akcji są dostępne w Logcat. Logcat przechwytuje dzienniki z urządzeń wirtualnych lub fizycznych połączonych z Androidem Studio.
Aby pobrać dzienniki akcji w aplikacji ze swojego urządzenia, wykonaj te czynności:
- Aby uzyskać dostęp do komunikatów logcat, kliknij Logcat na pasku narzędzi Android Studio.
- Wyszukaj dzienniki zawierające
ActivityTaskManager
.
Pomoc i dodatkowe zasoby
Wtyczka Asystenta Google zawiera linki do dokumentacji, oraz inne zasoby umożliwiające naukę i pomoc w korzystaniu z narzędzia do testów.
Aby otworzyć asystenta w Android Studio, wybierz Narzędzia > Asystent Google > Pomoc.
Rysunek 2. Sekcja pomocy wtyczki Asystenta Google.