Ta strona została przetłumaczona przez Cloud Translation API.

Agent testowania aplikacji (Android)

Agent testowania aplikacji to agent generowania, zarządzania i wykonywania przypadków testowych oparty na Gemini w Firebase. Cele testów określasz w języku naturalnym, a agent wykorzystuje AI, aby zrozumieć Twoją aplikację i się po niej poruszać, symulować interakcje użytkowników i dostarczać szczegółowe wyniki testów.

Jak agent testowania aplikacji wykorzystuje Twoje dane

Agent do testowania aplikacji jest udostępniany przez Gemini w Firebase i podlega tym samym warunkom. Więcej informacji o tym, jak Gemini w Firebase wykorzystuje Twoje dane, znajdziesz w artykule Jak Gemini w Firebase korzysta z Twoich danych.

Zanim zaczniesz

Jeśli nie jest jeszcze zarejestrowana, zarejestruj aplikację w Firebase.

Jeśli nie korzystasz z innych usług Firebase, musisz tylko utworzyć projekt i zarejestrować aplikację. Nie musisz dodawać do niej żadnych pakietów SDK. Jeśli jednak w przyszłości zdecydujesz się używać dodatkowych usług, wykonaj wszystkie czynności opisane w artykule Dodawanie Firebase za pomocą Firebasekonsoli.

Gdy zechcesz udostępnić testerom wersję przedpremierową aplikacji, utwórz plik APK lub AAB w zwykły sposób i prześlij go do usługi App Distribution w Firebase konsoli. Plik APK musi być podpisany kluczem debugowania lub kluczem podpisywania aplikacji.

Tworzenie przypadku testowego

Aby przeprowadzać testy oparte na AI, agent testowania aplikacji używa przypadków testowych w języku naturalnym do wykonywania testów aplikacji.

Każdy przypadek testowy jest podzielony na kroki, które będą wykonywane po kolei. Kroki umożliwiają podzielenie przypadku testowego na fazy, z których każda ma własne kryteria sukcesu. Podczas jednego kroku agent może wykonać wiele działań.

Aby utworzyć przypadek testowy, otwórz stronę App Distribution w Firebasekonsoli i wykonaj te czynności:

Na karcie Test Cases (Przypadki testowe) kliknij New test case (Nowy przypadek testowy). Jeśli nie chcesz tworzyć własnego przypadku testowego, możesz zmodyfikować lub użyć podanego przykładowego przypadku testowego.
W oknie Dodaj element testowania nadaj elementowi testowania nazwę. Służy do identyfikacji testu, ale jest ignorowany przez agenta.
Rozważ podzielenie testu na kilka kroków, klikając przycisk Dodaj kolejny krok.
Każdemu krokowi przypisz cel, który opisuje, co agent testujący aplikację powinien zrobić na tym etapie.
(Opcjonalnie) Dodaj wskazówkę, aby przekazać dodatkowe informacje, które pomogą testerowi aplikacji zrozumieć i obsługiwać aplikację na tym etapie.
(Opcjonalnie) Dodaj kryteria sukcesu, aby pomóc testerowi aplikacji określić, kiedy krok został wykonany.
Gdy skończysz dostosowywać test, kliknij Zapisz.

Przykładowy element testowania

Poniżej znajdziesz przykład tworzenia przypadku testowego za pomocą agenta testowania aplikacji:

Testowanie strony głównej
Tytuł testowy	Wczytywanie strony głównej
Cel	Wczytywanie strony głównej
Podpowiedź	Przejdź przez ekrany wprowadzające. Zamknij wszystkie wyskakujące okienka. Nie loguj się.
Kryteria sukcesu	Główna strona aplikacji jest widoczna na ekranie, wszystkie obrazy są załadowane i nie wyświetlają się żadne błędy.

Uruchom test

Agent testowania aplikacji umożliwia przeprowadzanie w konsoli testów opartych na AI. Wystarczy kliknąć przycisk Uruchom testy na stronie wersji lub przypadków testowych. Otworzy się ekran dostosowywania agenta testowania aplikacji, na którym możesz wybrać co najmniej 1 z dotychczasowych przypadków testowych do wykonania przez agenta. Możesz też wybrać urządzenia, na których chcesz przeprowadzić testy, oraz określić, czy chcesz podać dane logowania.

Możesz też przeprowadzić test losowego indeksowania, zmieniając typ testu. Testy losowego indeksowania korzystają z funkcji Automated Tester.

Wyniki testów możesz wyświetlić na stronie Wersje na karcie Agent testowania aplikacji w przypadku danej wersji. Przycisk Wyświetl szczegóły otworzy okno dialogowe Wyniki testu, w którym zobaczysz problemy, zrzuty ekranu aplikacji i działania, które Gemini wykonał podczas testu.

Automatyczne testowanie kompilacji

Aby automatycznie uruchamiać testy agenta Testowania aplikacji na nowych kompilacjach, np. z potoków CI/CD, możesz rozpowszechniać kompilacje wśród agentów za pomocą wtyczek Gradle lub fastlane App Distribution albo interfejsu wiersza poleceń Firebase.

Automatyczne testowanie kompilacji za pomocą wiersza poleceń Firebase

Aby korzystać z funkcji agenta testowania aplikacji, musisz podać co najmniej 1 urządzenie testowe i 1 identyfikator przypadku testowego. Identyfikatory przypadków testowych można znaleźć i pobrać na stronie Przypadki testowe w Firebase konsoli. Więcej informacji o tym, jak zacząć korzystać z interfejsu wiersza poleceń Firebase i jak skonfigurować rozpowszechnianie, znajdziesz w artykule Rozpowszechnianie aplikacji na Androida wśród testerów za pomocą interfejsu wiersza poleceń Firebase.

Uruchom polecenie appdistribution:distribute, aby przesłać aplikację, i skonfiguruj dystrybucję za pomocą tych parametrów:

appdistribution:distribute options
`--test-devices` lub `--test-devices-file`	Urządzenia testowe, na które chcesz dystrybuować kompilacje, muszą mieć włączoną funkcję agenta testowania aplikacji. Urządzenia testowe możesz podać jako listę urządzeń testowych rozdzielonych średnikami: `--test-devices: "model=shiba, version=34, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"` Możesz też podać ścieżkę do pliku tekstowego zawierającego listę urządzeń testowych rozdzielonych średnikami: `--test-devices-file: "/path/to/test-devices.txt"`
`--test-username`	Nazwa użytkownika do automatycznego logowania, która będzie używana podczas testów.
`--test-password` lub `--test-password-file`	Hasło do automatycznego logowania, które będzie używane podczas testów. Możesz też podać ścieżkę do pliku tekstowego zawierającego hasło: `--test-password-file: "/path/to/test-password.txt"`
`--test-non-blocking`	Uruchamiaj testy asynchronicznie. Wyniki testów automatycznych znajdziesz w konsoli Firebase.
`--test-case-ids` lub `--test-case-ids-file`	Lista identyfikatorów przypadków testowych rozdzielonych przecinkami do uruchamiania zautomatyzowanych testów opartych na AI: `--test-case-ids: "load-app,play-the-first-level"` Możesz też podać ścieżkę do pliku tekstowego zawierającego listę identyfikatorów przypadków testowych rozdzielonych przecinkami lub znakami nowego wiersza: `--test-case-ids-file: "/path/to/test-case-ids.txt"`

Automatyczne testowanie kompilacji za pomocą Gradle

Aby korzystać z funkcji agenta testowania aplikacji, musisz podać co najmniej 1 urządzenie testowe i 1 identyfikator przypadku testowego. Identyfikatory przypadków testowych można znaleźć i pobrać na stronie Przypadki testowe w Firebase konsoli. Więcej informacji o rozpoczynaniu pracy z Gradle i różnych sposobach konfigurowania dystrybucji znajdziesz w artykule Rozpowszechnianie aplikacji na Androida wśród testerów za pomocą Gradle.

Możesz skonfigurować App Distribution, dodając co najmniej jedną sekcję firebaseAppDistribution, i użyć tych parametrów, aby skonfigurować dystrybucję do funkcji agenta testowania aplikacji:

App Distribution Parametry kompilacji
`testDevices` lub `testDevicesFile`	Urządzenia testowe, na które chcesz dystrybuować kompilacje, muszą mieć włączoną funkcję agenta testowania aplikacji. Urządzenia testowe możesz określić jako listę specyfikacji urządzeń rozdzielonych średnikami. `testDevices="model=shiba, version=34, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"` Możesz też określić ścieżkę do pliku zawierającego listę specyfikacji urządzeń rozdzielonych średnikami: `testDevicesFile="/path/to/testDevices.txt"`
`testUsername`	Nazwa użytkownika do automatycznego logowania, która będzie używana podczas testów.
`testPassword` lub `testPasswordFile`	Hasło do automatycznego logowania, które będzie używane podczas testów. Możesz też podać ścieżkę do pliku tekstowego zawierającego hasło: testPasswordFile="/path/to/testPassword.txt"
`testNonBlocking`	Uruchamiaj testy asynchronicznie. Wyniki testu automatycznego znajdziesz w konsoli Firebase.
`testCases`lub `testCasesFile`	Lista identyfikatorów przypadków testowych rozdzielonych przecinkami do uruchamiania zautomatyzowanych testów opartych na AI: `testCases: "load-app,play-the-first-level"` Możesz też podać ścieżkę do pliku tekstowego zawierającego listę identyfikatorów przypadków testowych rozdzielonych przecinkami lub znakami nowego wiersza: `testCasesFile: "/path/to/test-case-ids.txt"`

Automatyczne testowanie kompilacji za pomocą fastlane

Aby korzystać z funkcji agenta testowania aplikacji, musisz podać co najmniej 1 urządzenie testowe i 1 identyfikator przypadku testowego. Identyfikatory przypadków testowych można znaleźć i pobrać na stronie Przypadki testowe w Firebase konsoli. Więcej informacji o rozpoczynaniu pracy z fastlane i różnych sposobach konfigurowania dystrybucji znajdziesz w artykule Dystrybuowanie aplikacji na Androida do testerów za pomocą fastlane.

W ścieżce ./fastlane/Fastfile dodaj blok firebase_app_distribution. Aby skonfigurować dystrybucję do funkcji agenta testowania aplikacji, użyj tych parametrów:

Parametry firebase_app_distribution
`test_devices` lub `test_devices_file`	Urządzenia testowe, na które chcesz dystrybuować kompilacje, muszą mieć włączoną funkcję agenta testowania aplikacji. Urządzenia testowe możesz podać jako listę urządzeń testowych rozdzielonych średnikami: `test_devices: "model=shiba, version=34, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"` Możesz też podać ścieżkę do pliku tekstowego zawierającego listę urządzeń testowych rozdzielonych średnikami: `test_devices_file: "/path/to/test-devices.txt"`
`test_username`	Nazwa użytkownika do automatycznego logowania, która będzie używana podczas testów.
`test_password` lub `test_password_file`	Hasło do automatycznego logowania, które będzie używane podczas testów. Możesz też podać ścieżkę do pliku tekstowego zawierającego hasło: `test_password_file: "/path/to/test-password.txt"`
`test_non_blocking`	Uruchamiaj testy asynchronicznie. Wyniki testów automatycznych znajdziesz w konsoli Firebase.
`--test_case_ids` lub `--test_case_ids_file`	Lista identyfikatorów przypadków testowych rozdzielonych przecinkami do uruchamiania zautomatyzowanych testów opartych na AI: `--test_case_ids: "load-app,play-the-first-level"` Możesz też podać ścieżkę do pliku tekstowego zawierającego listę identyfikatorów przypadków testowych rozdzielonych przecinkami lub znakami nowego wiersza: `--test_case_ids_file: "/path/to/test-case-ids.txt"`

Debugowanie wyników testu

Jeśli wyniki testu różnią się od oczekiwanych, możesz debugować test, korzystając z przełącznika Pokaż widok agenta w sekcji Wyświetl szczegóły na stronie Wyniki testu. Widok agenta pokazuje elementy na ekranie, które agent testujący aplikację wykrył, korzystając z informacji o ułatwieniach dostępu w aplikacji. Jeśli chcesz dokładniej przyjrzeć się temu, co widział agent, możesz pobrać te informacje z menu działań.

Możesz też kliknąć przycisk Wyświetl artefakty na stronie Wyniki testu, aby wyświetlić wszystkie filmy, logi i inne artefakty w Cloud związane z wynikami testu.

Znane problemy i ograniczenia

Wersja podglądowa agenta do testowania aplikacji ma pewne znane ograniczenia:

Agent testowania aplikacji używa generatywnej AI do testowania aplikacji, dlatego czasami wykonuje różne działania, ale nadal postępuje zgodnie z tymi samymi instrukcjami.
Agent testowania aplikacji obsługuje tylko te działania: kliknięcie, wpisanie tekstu, przesunięcie w górę/dół/lewo/prawo i oczekiwanie.
Agent testowania aplikacji ma problemy z przeprowadzaniem testów zawierających tylko jeden krok, który wymaga wykonania wielu działań. Działa lepiej, gdy złożone zadania są podzielone na kilka krótszych etapów.
Agent testowania aplikacji czasami nie przewija ekranu, aby wyświetlić inne elementy. Dzieje się tak częściej, gdy nie ma wizualnego wskaźnika możliwości przewijania. Aby obejść ten problem, możesz użyć pola „hints” (wskazówki) do sugerowania przewijania.
Agent testowania aplikacji ma czasem problemy z liczeniem, np. z wykonaniem działania określoną liczbę razy.
Agent testowania aplikacji nie może poruszać się po aplikacji, jeśli włączona jest funkcja FLAG_SECURE. Zamiast zrzutów ekranu aplikacji zobaczy tylko pusty ekran.

Limity testowania

W wersji przedpremierowej testy oparte na AI będą oferowane bezpłatnie w ramach limitu. Domyślny limit to 200 testów miesięcznie na projekt Firebase.

Pamiętaj, że jeśli zdecydujesz się uruchomić kilka przypadków testowych lub ten sam przypadek testowy na kilku urządzeniach, będzie to traktowane jako kilka testów. Jeśli na przykład uruchomisz 2 przypadki testowe na 2 urządzeniach, będzie to łącznie 4 testy.

Aby zwiększyć limit powyżej wartości domyślnej, skontaktuj się z zespołem pomocy Firebase i opisz swój przypadek użycia.