Ścieżki w Android Studio

Funkcja Journeys w Android Studio wykorzystuje możliwości AI w zakresie widzenia i rozumowania, aby poruszać się po aplikacji i testować ją na podstawie instrukcji w języku naturalnym. Zestaw instrukcji, zwany ścieżką, jest przekształcany w działania, które AI wykonuje w aplikacji. Możesz też pisać i opisywać bardziej złożone asercje, które AI ocenia na podstawie tego, co widzi na urządzeniu.

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 na różnych wersjach aplikacji i różnych konfiguracjach urządzeń.

Możesz pisać i uruchamiać ścieżki bezpośrednio w Android Studio lub w wierszu poleceń 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 śledzić rozumowanie i wykonanie ścieżki przez Gemini.

Napisz podróż

Android Studio udostępnia szablon pliku i nowy edytor, które ułatwiają tworzenie i edytowanie ścieżek. Serie czynności są zapisywane w składni XML, aby uporządkować opis serii czynności i jej poszczególne 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 ścieżki.

3. W wyświetlonym oknie podaj nazwę i opis ścieżki.

   

4. Kliknij Zakończ. Android Studio utworzy plik XML z wybraną przez Ciebie nazwą. Możesz użyć widoku Kod, aby bezpośrednio edytować kod XML, lub widoku Projekt, aby uprościć edycję.

5. Gdy wyświetlasz ścieżkę w widoku Projekt, użyj pola tekstowego, aby opisać każdy krok ścieżki. Każdy krok może zawierać opisowe działania, które ma wykonać Gemini, lub stwierdzenia, które ma ocenić.

6. Naciśnij Enter na klawiaturze, aby rozpocząć nowy krok w tej samej ścieżce. W razie potrzeby możesz powtórzyć tę czynność dla każdego kroku ścieżki, który chcesz zdefiniować.

Konfigurowanie wariantów kompilacji

Ścieżki są uruchamiane w odniesieniu do konkretnych wariantów kompilacji aplikacji. Gdy po raz pierwszy utworzysz ścieżkę za pomocą kreatora, wygenerowany zestaw testów zostanie skonfigurowany tak, aby był uruchamiany w odniesieniu do wariantu kompilacji, który jest aktywny w Android Studio.

Jeśli jednak później zmienisz aktywny wariant kompilacji w Android Studio (np. na inny wariant produktu, taki jak demoDebug) bez aktualizowania konfiguracji, uruchomienie ścieżki się nie powiedzie. Aby rozwiązać ten problem, musisz dodać nowy wariant do właściwości targetVariants w bloku testSuites pliku build.gradle.kts (lub build.gradle) na poziomie modułu.

Aby na przykład skonfigurować pakiet journeysTest dla wariantu demoDebug:

android {
    // ...
    testSuites {
        create("journeysTest") {
            // ...
            targetVariants += listOf("demoDebug")
        }
    }
}

Wskazówki dotyczące pisania ścieżek

Chociaż AI rozumie większość kroków napisanych w obsługiwanych językach, stosowanie tych wskazówek dotyczących pisania ścieżek może prowadzić do dokładniejszych i bardziej oczekiwanych wyników:

• Załóż, że aplikacja jest już na pierwszym planie: uruchomienie podróży automatycznie uruchamia aplikację. Kroki podróży powinny się rozpocząć po pełnym uruchomieniu aplikacji. Nie musisz więc uwzględniać kroku „uruchom aplikację”.
• Używaj jednoznacznego języka: precyzyjność minimalizuje ryzyko błędnej interpretacji i zwiększa wiarygodność.

• Uwzględnij kryteria sukcesu w ramach kroku: pomoże to Gemini lepiej zrozumieć Twoje intencje i wyjaśni, kiedy działanie zostanie zakończone i można rozpocząć następne.

• Ulepszanie ścieżki: jeśli ścieżka nie działa zgodnie z oczekiwaniami, możesz wyświetlić wyniki i sprawdzić sekcje „Podjęte działanie” oraz „Uzasadnienie”, aby dowiedzieć się, dlaczego Gemini nie wykonał kroków zgodnie z Twoimi oczekiwaniami. Wykorzystaj te informacje, aby doprecyzować instrukcje.
• Podziel ścieżkę na bardziej szczegółowe kroki: chociaż AI potrafi interpretować kroki obejmujące wiele działań, czasami bardziej szczegółowe, odrębne kroki mogą zwiększyć dokładność i powtarzalność ścieżki.
  • „Błąd: nie udało się wykonać działania w maksymalnej liczbie dozwolonych prób”: jeśli wystąpi ten błąd, spróbuj podzielić nieudane kroki na 2 lub więcej mniejszych kroków. Ten błąd występuje, gdy AI nie może wykonać działania po maksymalnej liczbie interakcji z aplikacją.

Funkcje obsługiwane i nieobsługiwane

Poniżej znajdziesz przegląd funkcji obsługiwanych i nie w pełni obsługiwanych podczas tworzenia ścieżek. Poniższe listy nie są wyczerpujące.

W przypadku ścieżek obsługiwane są te działania:

• Klikaj elementy interfejsu.
• Wpisz tekst w polach tekstowych.
• Przesuń palcem lub przewiń w określonym kierunku, aby poruszać się po interfejsie.

Te funkcje nie są obecnie w pełni obsługiwane lub mogą działać w sposób niejednolity:

• Gesty z użyciem wielu palców (np. uszczypnięcie w celu powiększenia) – interakcje wymagające jednoczesnego dotykania ekranu w co najmniej 2 miejscach, np. uszczypnięcie w celu powiększenia lub pomniejszenia albo przesunięcie dwoma palcami.
• Przytrzymanie – naciśnięcie i przytrzymanie palca przez czas dłuższy niż standardowe kliknięcie.
• Dwukrotne dotknięcie – szybkie dwukrotne dotknięcie tego samego miejsca na ekranie.
• Obracanie/składanie ekranu – obsługa zmian orientacji urządzenia (np. z orientacji pionowej na orientację poziomą) lub stanu fizycznego urządzeń składanych (np. otwieranie lub zamykanie).
• Pamięć – przechowywanie i przywoływanie konkretnych informacji, kontekstu lub danych wejściowych użytkownika z poprzednich interakcji lub kroków.
• Liczenie – dokładne śledzenie ilości, częstotliwości lub postępów.
• Instrukcje warunkowe – wykonywanie działań w zależności od tego, czy inne określone warunki są spełnione.

Funkcje i możliwości są stale ulepszane. Zachęcamy do ponownego odwiedzenia tej strony w późniejszym terminie, aby dowiedzieć się więcej o dodatkowych funkcjach i możliwościach. Aby pomóc nam ulepszać sekcję Podróże, podziel się swoją opinią.

Uruchamianie ścieżki

Możesz uruchomić test ścieżki 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. Wybierz urządzenie docelowe na głównym pasku narzędzi, 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 „test” w marginesie obok miejsca, w którym w XML-u zdefiniowana jest nazwa ścieżki.

Android Studio utworzy konfigurację Testy ścieżek 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.

Uruchamiaj ścieżki w dowolnej wstępnie zainstalowanej aplikacji

Możesz uruchomić ścieżkę na fabrycznie zainstalowanej aplikacji na urządzeniu testowym. Jest to przydatne, jeśli chcesz przetestować wersję produkcyjną aplikacji lub jeśli nie masz jeszcze zaktualizowanej aplikacji do wtyczki Androida do obsługi Gradle w wersji 9.0.0 lub nowszej.

1. Otwórz lub utwórz nowy projekt, który jest zaktualizowany do wtyczki Androida do obsługi Gradle w wersji 9.0.0 lub nowszej.
2. Tworzenie ścieżki
3. Edytuj konfigurację uruchomienia ścieżki i dodaj te zmienne środowiskowe: Konfiguracja uruchomienia jest tworzona automatycznie, gdy próbujesz uruchomić ścieżkę w Android Studio.
   • Ustaw JOURNEYS_CUSTOM_APP_ID na identyfikator pakietu docelowej aplikacji.
4. Uruchom zmodyfikowaną podróż. Android Studio powinno wykonać kroki ścieżki w określonej aplikacji docelowej.

Uruchamianie ścieżki z wiersza poleceń

Aby uruchamiać ścieżki z poziomu wiersza poleceń, użyj interfejsu wiersza poleceń Androida.

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 przeprowadzać w Android Studio, sposób wyświetlania wyników testów ścieżek jest nieco inny.

• Panel Testy dzieli ścieżkę na poszczególne etapy. 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.
  • Każde podjęte działanie i uzasadnienie Gemini, dlaczego podjęło to działanie, są opisane obok każdego zrzutu ekranu.
  • 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 testowej na urządzeniu z Androidem 15 (poziom interfejsu 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ć na urządzeniu opcje programisty i wyłączyć opcję Weryfikuj aplikacje przez USB.