Wtyczka Asystenta Google do Android Studio

Wtyczka Asystenta Google testuje działania w aplikacji w Android Studio. W fazie programowania i testowania możesz używać wtyczki do tworzenia podglądu działań w aplikacji w Asystencie na swoim koncie Google. Przed przesłaniem akcji w aplikacji do wdrożenia możesz sprawdzić, jak obsługuje ona różne parametry.

Jak to działa

Wtyczka Asystenta Google zawiera narzędzie App Actions Test Tool – funkcję, która analizuje plik shortcuts.xml i tworzy podgląd działań w aplikacji dla pojedynczego konta Google. Dzięki temu Asystent Google rozpozna Twoje działania w aplikacji przed wdrożeniem jej wersji produkcyjnej w Konsoli Google Play.

Dla każdej intencji wbudowanej (BII) w pliku shortcuts.xml narzędzie renderuje odpowiedni obiekt JSON-LD i udostępnia domyślne wartości parametrów. Następnie możesz zmienić te wartości, aby przetestować działania w aplikacji za pomocą użytecznych kombinacji parametrów i upewnić się, że będą one wykonywać odpowiednie funkcje aplikacji. Podglądy są tworzone, aktualizowane i usuwane w narzędziu testowym, co umożliwia powtarzanie i testowanie akcji w aplikacji w bezpiecznym środowisku.

Po utworzeniu podglądu możesz aktywować na urządzeniu testowym akcję w aplikacji bezpośrednio z okna narzędzia testowego. W przypadku identyfikatorów BII dostępnych do aktywowania przez użytkownika możesz wypróbować akcję w aplikacji za pomocą app name bezpośrednio w Asystencie na urządzeniu. Możesz na przykład powiedzieć „OK Google, rozpocznij ćwiczenie z użyciem przykładowej aplikacji”, aby uruchomić akcję w aplikacji, która korzysta z funkcji actions.intent.START_EXERCISE BII.

Obsługa języka

Tworzenie podglądów określonych języków w narzędziu testowym różni się w zależności od BII. Strona każdego BII w dokumentacji wbudowanej intencji zawiera informacje o funkcjach dostępnych w tym BII, np. o tym, czy narzędzie testowe obsługuje tworzenie podglądów dla określonego języka oraz czy są dostępne działania w aplikacji, które użytkownicy mogą aktywować.

Pobierz wtyczkę

Wtyczka Asystenta Google jest dostępna dla Android Studio. Informacje o instalowaniu i używaniu Android Studio znajdziesz na stronie Android Studio.

Aby zainstalować wtyczkę Asystenta Google w Android Studio, wykonaj te czynności:

1. W systemie macOS kliknij Plik > Ustawienia (Android Studio > Ustawienia).
2. W sekcji Wtyczki kliknij 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 dotyczące konfiguracji

Korzystanie z wtyczki Asystenta Google wymaga wykonania kilku czynności konfiguracyjnych, by można było przetestować akcję w aplikacji. W szczególności musisz używać tego samego konta użytkownika w Android Studio na urządzeniu testowym i aby mieć dostęp do konsoli Google Play.

Przygotuj środowisko programistyczne, używając tych konfiguracji:

• Zaloguj się w Android Studio (w wersji 4.0 lub nowszej).
• Zaloguj się w aplikacji Google na urządzeniu testowym z Androidem, korzystając z tego samego konta.
• Na tym samym koncie uzyskaj dostęp do Konsoli Play do przesłanego pakietu aplikacji, który chcesz przetestować.
• Otwórz aplikację Google na urządzeniu testowym z Androidem i dokończ wstępną konfigurację Asystenta.
• Na urządzeniu testowym włącz synchronizację danych urządzenia.

Ograniczenia

Wtyczka Asystenta Google ma następujące ograniczenia:

• Akcji w aplikacji, które obejmują internetowe zasoby reklamowe i wywołania aplikacji na pierwszym planie, nie można testować bezpośrednio w narzędziu testowym ani przez polecenia Android debug Bridge (adb). Aby przetestować te działania w aplikacji, najpierw utwórz podgląd za pomocą narzędzia testowego. Następnie aktywuj te akcje w aplikacji, korzystając z Asystenta Google na urządzeniu fizycznym.
• Wbudowane zasoby reklamowe na potrzeby actions.intent.OPEN_APP_FEATURE można testować tylko przez 6 godzin od utworzenia lub zaktualizowania podglądu. Aby zresetować 6-godzinny okres, zaktualizuj podgląd narzędzia do testowania lub utwórz nowy.

Dodaj kolejnych testerów

Możesz zaprosić do projektu dodatkowych użytkowników, aby mogli testować integrację z akcjami w aplikacji. Jest to przydatne, gdy chcesz udostępnić projekt innym członkom zespołu programistów, by mogli go przetestować, lub gdy udostępniasz projekt testerom kontroli jakości w ramach przygotowań do wprowadzenia na rynek produkcyjny. Muszą oni zostać dodani w Sklepie Google Play jako testerzy licencji i przyznać dostęp tylko do odczytu do Konsoli Google Play.

Aby dodać kolejnych testerów, wykonaj te czynności:

1. Zaloguj się w Konsoli Play.

2. Postępuj zgodnie z instrukcjami podanymi w sekcji Konfigurowanie licencjonowania aplikacji w tym temacie pomocy na temat Konsoli Play.

   

3. Dodaj konto Google testera licencji jako użytkownika Konsoli Google Play z dostępem tylko do odczytu.

   1. Wybierz Użytkownik i uprawnienia > Zaproś nowych użytkowników > Dodaj aplikację.
   2. W sekcji Dostęp aplikacji odznacz pole wyboru Administrator (wszystkie uprawnienia).

Do każdego testera, któremu chcesz włączyć testowanie wersji testowej, musisz się zalogować w Android Studio, używając konta Google tego użytkownika. Po zalogowaniu się użyj wtyczki Asystenta Google, aby utworzyć podgląd dla użytkownika testowego.

Korzystanie z wtyczki Asystenta Google

Otwórz narzędzie testowe Działania w aplikacji w Android Studio, klikając Narzędzia > Asystent Google > Narzędzie testowe Działań 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. Więcej informacji znajdziesz w artykule Przygotowywanie i publikowanie wersji. Przetestuj aplikację w wersji roboczej, zanim prześlesz ją do sprawdzenia.

Narzędzie testowe tworzy podgląd na podstawie Twojego konta Google i nazwy pakietu aplikacji (identyfikator aplikacji), dzięki czemu możesz przetestować wiele aplikacji za pomocą tego samego konta Google. Dopóki masz inny identyfikator aplikacji, do tworzenia i testowania podglądu nadal możesz używać tego samego konta Google. Każde z kont Google z dostępem do tego samego pakietu aplikacji może tworzyć za pomocą narzędzia testowego osobne podglądy aplikacji.

Aby utworzyć podgląd, wykonaj te czynności w Android Studio:

1. Otwórz narzędzie testowe akcje w aplikacji.
2. Opcjonalnie wpisz nazwę i język aplikacji do przetestowania. Domyślna nazwa i język aplikacji to test app action i en.
3. Kliknij Utwórz podgląd. Jeśli pojawi się taka prośba, przeczytaj i zaakceptuj zasady i warunki korzystania z działań w aplikacji. Po utworzeniu podglądu w oknie narzędzia testowego pojawią się informacje o obiektach BIIs znajdujących się w pliku shortcuts.xml.

Narzędzie testowe używa nazwy aplikacji do tworzenia i symulowania zapytań do Asystenta dotyczących działań w aplikacji. Wdrożone akcje aplikacji używają do wywoływania nazwy aplikacji ze Sklepu Play, ale w narzędziu testowym możesz użyć dowolnej nazwy wywołania. Zalecamy jednak użycie nazwy aplikacji jako nazwy wywołania w narzędziu testowym.

Podany język musi być taki sam jak język Asystenta Google na Twoim urządzeniu testowym. Podgląd można utworzyć tylko w jednym języku naraz. Jeśli na przykład językiem Asystenta jest angielski (Stany Zjednoczone), możesz wpisać en-US, ale nie en-**, en-GB ani en-US, en-GB. Możesz użyć języka głównego, np. en, aby uwzględnić zarówno en-GB, jak i en-US.

Aby zmienić nazwę aplikacji lub wybrany język w istniejącym podglądzie, kliknij przycisk Usuń w narzędziu testowym. Następnie wpisz odpowiednią nazwę aplikacji i język, zanim utworzysz nowy podgląd.

Aby zaktualizować istniejący podgląd, aby pasował do pliku shortcuts.xml, w narzędziu testowym kliknij przycisk Aktualizuj. Informacje o bieżącym podglądzie znajdziesz w sekcji Testuj działanie w aplikacji w oknie narzędzia testowego.

Skonfiguruj BII

Po utworzeniu podglądu aplikacji możesz przetestować we wtyczce różne wartości parametrów BII. W przypadku każdego BII w pliku shortcuts.xml wtyczka renderuje odpowiedni obiekt JSON-LD i podaje domyślne wartości parametrów. Możesz zmienić te wartości domyślne, aby przetestować działania w aplikacji za pomocą znaczących kombinacji parametrów, i upewnić się, że będą one działać prawidłowo.

W przypadku właściwości i opisów parametry i ich wartości są zwykle zgodne ze strukturą schema.org lub schema.googleapis.com. Informacje o dowolnym parametrze BII znajdziesz w opisach typu schematu parametru i jego parametrów wyższego poziomu.

Na przykład obiekt actions.intent.CREATE_MONEY_TRANSFER BII obsługuje parametr intencji moneyTransfer.transferMode. Na stronie schema.googleapis.com witryny MoneyTransfer podana jest transferMode jako usługa. Właściwość transferMode jest trybem przenoszenia i oczekuje wartości (np. SendMoney) wyszczególnionego typu FinancialTransferMode.

W narzędziu testowym możesz podać dowolne z tych wyliczeń jako wartość transferMode:

• http://schema.googleapis.com/SendMoney
• http://schema.googleapis.com/ReceiveMoney

Wyzwalaj działania w aplikacji

Po utworzeniu podglądu i skonfigurowaniu BII możesz aktywować akcję w aplikacji na urządzeniu testowym bezpośrednio z okna narzędzia testowego.

Aby aktywować akcję w aplikacji za pomocą narzędzia testowego, wykonaj te czynności:

1. Podłącz urządzenie testowe.
2. W sekcji Wybierz urządzenie docelowe wybierz urządzenie, na którym chcesz wywoływać działanie w aplikacji.
3. W sekcji Testuj działanie aplikacji kliknij przycisk Uruchom działanie aplikacji.

Działania w aplikacji aktywowane w narzędziu testowym korzystają z wyświetlonego polecenia Android Debug Bridge (adb). Wygenerowane polecenie powłoki adb zawiera wszystkie metadane wymagane przez aplikację Google do wykonania metody BII. Ta metoda naśladuje zachowanie akcji w aplikacji po wyodrębnieniu przez Asystenta kluczowych informacji z zapytania.

Logowanie w Android Studio

Logi specyficzne dla narzędzia testowego są dostępne w plikach dziennika Android Studio, a nie w danych wyjściowych Logcat. Procesy działające bezpośrednio na Twojej stacji roboczej generują logi Android Studio. Możesz ich używać do rozwiązywania problemów z operacjami narzędzi testowych, takich jak tworzenie, aktualizowanie i usuwanie podglądu.

Aby uzyskać dostęp do plików dziennika Android Studio, kliknij Pomoc > Pokaż eksplorator dzienników (Pomoc > Pokaż wyszukiwarkę logowania w systemie macOS).

Logi dotyczące działań w aplikacji dotyczących Twojej aplikacji są dostępne w usłudze Logcat. Logcat przechwytuje logi z urządzeń wirtualnych lub fizycznych połączonych z Android Studio.

Aby pobrać dzienniki działań w aplikacji na swoim urządzeniu, wykonaj te czynności:

1. Aby uzyskać dostęp do komunikatów logu Logcat, kliknij Logcat na pasku okna narzędzia Android Studio.
2. Wyszukaj logi zawierające ActivityTaskManager.

Uzyskaj pomoc i dodatkowe materiały

Wtyczka Asystenta Google zawiera linki do dokumentacji, ćwiczeń z programowania i innych materiałów ułatwiających naukę i uzyskiwanie pomocy w korzystaniu z narzędzia testowego.

Aby otworzyć Asystenta w Android Studio, wybierz Narzędzia > Asystent Google > Pomoc.

Rysunek 2. Sekcja pomocy wtyczki Asystenta Google.