Ścieżki w Android Studio

Tworzenie ścieżek w Android Studio ułatwia pisanie i utrzymywanie testów kompleksowych, ponieważ umożliwia opisywanie kroków i asercji każdego testu (zwanego ścieżką) w języku naturalnym. Dzięki wykorzystaniu funkcji Gemini związanych z widzeniem i rozumowaniem kroki napisane w języku naturalnym są przekształcane w działania, które Gemini wykonuje w Twojej aplikacji. Dzięki temu pisanie i rozumienie ścieżek jest łatwe. Możesz też pisać i opisywać bardziej złożone asercje, które Gemini ocenia na podstawie tego, co widzi na urządzeniu, aby określić, czy testy przebiegają prawidłowo.

A ponieważ Gemini analizuje, jakie działania należy wykonać, aby osiągnąć cele, ścieżki są bardziej odporne na subtelne zmiany w układzie lub działaniu aplikacji, co skutkuje mniejszą liczbą niestabilnych testów podczas uruchamiania ich w różnych wersjach aplikacji i na różnych konfiguracjach urządzeń.

Twórz i uruchamiaj ścieżki bezpośrednio w Android Studio na dowolnym lokalnym lub zdalnym urządzeniu z Androidem. Środowisko IDE zapewnia nowy edytor do tworzenia ścieżek oraz wyniki z elementami rozszerzonymi, które pomagają lepiej zrozumieć rozumowanie Gemini i wykonanie ścieżki.

konto dewelopera i włączyć Gemini w Android Studio.

Napisz relację z podróży

Android Studio udostępnia szablon pliku i nowy edytor, które ułatwiają tworzenie i edytowanie ścieżek. Serie czynności są zapisywane przy użyciu składni XML, aby uporządkować opis serii czynności i jej etapy.

Aby utworzyć ścieżkę i rozpocząć jej edytowanie:

1. W panelu Project w Android Studio kliknij prawym przyciskiem myszy moduł aplikacji, dla którego chcesz napisać ścieżkę.
2. Kliknij Nowy > Test > Plik ścieżki.
3. W wyświetlonym oknie podaj nazwę i opis ścieżki.
4. Kliknij OK. Android Studio utworzy plik XML dla Twojej ścieżki o wybranej przez Ciebie nazwie. Możesz użyć widoku Kod, aby edytować kod XML bezpośrednio, lub widoku Projekt, aby ułatwić sobie edycję.
5. Gdy wyświetlasz ścieżkę w widoku Projekt, użyj pola tekstowego, aby opisać każdy etap ścieżki. Każdy krok może zawierać opisowe działania, które Gemini ma wykonać, lub stwierdzenia, które ma ocenić.
6. Naciśnij Enter na klawiaturze, aby rozpocząć nowy prompt w ramach tej samej podróży. W razie potrzeby możesz powtórzyć tę czynność dla każdego kroku ścieżki, który chcesz zdefiniować.

Wskazówki dotyczące pisania ścieżek

Szczegółowe i uporządkowane opisywanie podróży może zwiększyć prawdopodobieństwo, że Gemini dokładnie przeprowadzi zaplanowane podróże w bardziej deterministyczny sposób. Oto kilka wskazówek, które pomogą Ci skuteczniej tworzyć ścieżki:Oddzielaj asercje od działań: Gemini stale ocenia stan aplikacji, aby określić, czy jest ona w „prawidłowym” stanie, który umożliwia kontynuowanie ścieżki. Może jednak być konieczne zdefiniowanie bardziej złożonych asercji w osobnym kroku. Dodatkowo każdy prompt zaczynaj od kluczowych wyrażeń, takich jak „Sprawdź, czy”, „Potwierdź, że” lub „Upewnij się, że”, aby poinformować Gemini, że ten krok ma być potwierdzeniem. * Wydawanie poleceń Gemini za pomocą gestów: oprócz podstawowych interakcji, takich jak klikanie czy wpisywanie na klawiaturze, Gemini obsługuje działania, które wymagają przesuwania palcem po ekranie w określonych kierunkach. Aby na przykład przewinąć treści lub zamknąć niektóre elementy interfejsu, wystarczy opisać kierunek i cel przesunięcia. Domyślnie Gemini przesuwa palcem od środka ekranu, ale możesz poprowadzić go tak, aby przesuwał palcem w innej części ekranu urządzenia. * Unikaj złożonych interakcji i zmian konfiguracji: Gemini nie obsługuje obecnie wszystkich interakcji i zmian konfiguracji, takich jak gesty wieloma palcami, obracanie ekranu czy składanie urządzenia. Nasz zespół pracuje nad ulepszaniem możliwości Gemini.

Uruchamianie ścieżki

Możesz uruchomić test na dowolnym dostępnym urządzeniu lokalnym lub zdalnym, podobnie jak w przypadku innych testów z instrumentacją. Android Studio generuje wyniki z elementami rozszerzonymi, które pomagają zrozumieć przebieg testu.

Aby przetestować ścieżkę:

1. Na głównym pasku narzędzi wybierz urządzenie docelowe, tak jak w przypadku przeprowadzania testu z instrumentacją.
2. Przejdź do pliku XML ścieżki, którą chcesz przetestować, i otwórz go w edytorze.
3. W edytorze wykonaj jedną z tych czynności:
   1. Jeśli jesteś w widoku Projekt, kliknij Uruchom ścieżkę.
   2. Jeśli jesteś w widoku Kod, kliknij Uruchom w marginesie obok miejsca, w którym w pliku XML zdefiniowano nazwę ścieżki.

Android Studio utworzy konfigurację Journeys Test i uruchomi ją na urządzeniu docelowym. Podczas wykonywania Android Studio tworzy i wdraża aplikację oraz łączy się z Gemini, aby określić, jakie działania należy podjąć na każdym etapie.

Podczas uruchamiania ścieżki w edytorze wyświetlane są też ograniczone wyniki, takie jak zrzuty ekranu, podjęte działania i uzasadnienie podczas wykonywania każdego kroku ścieżki. Aby zobaczyć więcej informacji, najedź kursorem na miniaturę w edytorze. Może to być przydatne podczas iteracyjnego ulepszania promptów.

Pokaż wyniki

Gdy Android Studio zakończy testowanie ścieżki, automatycznie pojawi się panel wyników testu, w którym zobaczysz wyniki.

W porównaniu z innymi testami z instrumentacją, które możesz uruchamiać w Android Studio, sposób wyświetlania wyników testów ścieżek różni się w kilku aspektach.

• Panel Testy dzieli ścieżkę na poszczególne kroki. Możesz kliknąć każdy krok, aby dowiedzieć się więcej o tym, jak Gemini go wykonał.
• Panel Wyniki zawiera szczegółowe informacje, które pomogą Ci zrozumieć, jak Gemini zrozumiał i przeanalizował Twoją podróż oraz jak ją zrealizował.
• Zrzuty ekranu wysłane do Gemini są wyświetlane jako pomoc wizualna przy każdej czynności w kroku.
• Obok każdego zrzutu ekranu opisujemy podjęte działanie i uzasadnienie Gemini.
• Każde działanie w kroku jest ponumerowane.

Znane problemy

• Podczas testowania ścieżki domyślnie przyznawane są wszystkie uprawnienia do aplikacji.
• Podczas testowania ścieżki na urządzeniu z Androidem 15 (poziom API 35) może się pojawić ostrzeżenie „Zablokowano niebezpieczną aplikację” dotyczące „AndroidX Crawler”. Aby pominąć to sprawdzenie, możesz kliknąć Zainstaluj mimo to. Możesz też skonfigurować opcje programisty na urządzeniu i wyłączyć opcję Weryfikuj aplikacje przez USB.
• Pliki podróży nie są obecnie wyświetlane w widoku Android w panelu Projekty. Aby wyświetlić pliki ścieżek w projekcie, użyj widoku Projekt.
• Jeśli wiele działań w ramach ścieżki ma dokładnie ten sam prompt, wyniki testu wyświetlane w edytorze ścieżki mogą być nieprawidłowe. W szczególności wszystkie działania z duplikatem promptu będą wyświetlać wyniki testu powiązane z ostatnio zaktualizowaną instancją tego promptu. Aby obejść ten problem, upewnij się, że każde działanie ma unikalny prompt, np. dodając odrębny prefiks lub sufiks.
• Gdy klawiatura zostanie wczytana po raz drugi na nowym emulatorze, pojawi się wyskakujące okienko dotyczące rysika. To wyskakujące okienko zwykle powoduje niepowodzenie testów, które wchodzą w interakcję z polami tekstowymi. W takim przypadku zamknij wyskakujące okienko i ponownie uruchom ścieżkę.
• Artefakty narzędzia do indeksowania aplikacji mogą czasami pojawiać się w uzasadnieniu agenta.
• Wykonanie ścieżki czasem kończy się niepowodzeniem z błędem IllegalStateException. W takiej sytuacji możesz kliknąć Wyniki testu, aby zobaczyć pełny błąd.

• Jeśli wtyczka Androida do obsługi Gradle (com.android.application) nie jest zdefiniowana w pliku build.gradle najwyższego poziomu, podczas uruchamiania ścieżki możesz zobaczyć ten błąd:

  Failed to apply plugin class 'com.android.tools.journeys.JourneysGradlePlugin'
  

  Aby rozwiązać ten problem, upewnij się, że wtyczka jest zdefiniowana w pliku najwyższego poziomu build.gradle. Więcej informacji znajdziesz w artykule Konfigurowanie systemu kompilacji Androida.