Wtyczka Asystenta Google do Android Studio

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:

  1. Kliknij Plik > Ustawienia (Android Studio > Ustawienia w systemie macOS).
  2. W sekcji Wtyczki otwórz Marketplace i wyszukaj „Wtyczka Asystenta Google”.
  3. 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:

  1. Zaloguj się w Konsoli Play.
  2. Wykonaj instrukcje z sekcji Konfigurowanie licencjonowania aplikacji w tym artykule: w artykule w Centrum pomocy Konsoli Play.

    Dodaj testera licencji w Konsoli Google Play.
    Rysunek 1. Dodawanie testera licencji.
  3. Zaproś konto Google testującego licencję jako użytkownika Konsoli Google Play tylko do odczytu.

    1. Wybierz Użytkownik i uprawnienia > Zaproś nowych użytkowników > Dodaj aplikację.
    2. 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:

  1. Otwórz narzędzie testowe akcji w aplikacji.
  2. Opcjonalnie wpisz nazwę aplikacji i język, na których chcesz przeprowadzić test. Domyślny nazwa i język aplikacji to test app action i en.
  3. 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:

  1. Podłącz urządzenie testowe.
  2. W sekcji Wybierz urządzenie docelowe wskaż urządzenie, na którym chcesz wywoła działanie w aplikacji.
  3. 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:

  1. Aby uzyskać dostęp do komunikatów logcat, kliknij Logcat na pasku narzędzi Android Studio.
  2. 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.

Asystent narzędzia do testowania akcji w aplikacji Rysunek 2. Sekcja pomocy wtyczki Asystenta Google.