Sprawdzone metody udostępniania aplikacji na Androida testerom kontroli jakości za pomocą CI/CD

W tym dokumencie opisujemy sprawdzone metody korzystania z Firebase App Distribution w celu: aby procesy testowania przedpremierowych aplikacji na Androida były zrównoważone i powtarzalne CI/CD. Rozwiązania to Gradle i Fastlane, ale dajemy w ten sposób większą elastyczność. Udostępniamy też rozwiązania dostępne w ramach konsola Firebase, interfejs wiersza poleceń Firebase i publiczne konto Firebase Interfejs API App Distribution. Opisujemy też limity dotyczące wersji i testerów, aby ułatwić Ci planowanie aby zapewnić optymalną jakość usługi.

Jeśli korzystasz też z platform Apple, zapoznaj się z artykułem Sprawdzone metody dystrybucji aplikacji Apple do testerów QA za pomocą CI/CD i fastlane.

Zanim zaczniesz

Zanim wdrożysz sprawdzone metody opisane w tym dokumencie, włącz App Distribution w konsoli Firebase dla każdej aplikacji. Jeśli nie masz jeszcze włączony App Distribution, pojawi się błąd 404.

Aby włączyć App Distribution, wykonaj te czynności:

  1. Otwórz stronę App Distribution w konsoli Firebase.
  2. Wybierz aplikację na Androida.
  3. Kliknij Rozpocznij.

Biorąc pod uwagę, że pakiety Android App Bundle stają się najpopularniejszą wersją Androida pakietu, zalecamy skonfigurowanie możliwości rozpowszechniania pakietów aplikacji na Androida w dla testerów, łącząc konto Google Play.

Automatyzowanie przedpremierowego przepływu pracy przy użyciu potoku CI/CD

Jeśli chcesz zautomatyzować kompilowanie i publikowanie aplikacji dla testerów i korzystasz z CI/CD, zalecamy użycie fastlane lub Gradle. Możesz też użyć interfejsu wiersza poleceń Firebase, , który daje dostęp do szerokiej gamy usług Firebase.

Użyj szybkiego pasa

Zintegruj App Distribution z potokiem CI/CD za pomocą fastlane, czyli narzędzia open source, które automatyzuje kompilowanie i publikowanie aplikacji na iOS i Androida. Tworząc i automatyczne rozpowszechnianie najnowszych wersji testerom, testerzy zawsze mają najnowszą wersję testową Twojej aplikacji.

Aby dowiedzieć się, jak zintegrować App Distribution z fastlane, przeczytaj artykuł Rozpowszechnianie aplikacji na Androida za pomocą fastlane.

Używanie Gradle

Aby zintegrować App Distribution z procesem kompilacji Androida, użyj Gradle i wtyczki Gradle App Distribution. W pluginie możesz określić testerów i notatki o wersji w pliku build.gradle aplikacji, co umożliwia konfigurowanie dystrybucji dla różnych typów kompilacji i wariantów aplikacji.

Aby dowiedzieć się, jak zintegrować App Distribution z Gradle, przeczytaj artykuł Rozpowszechnianie aplikacji na Androida wśród testerów za pomocą Gradle.

Użyj interfejsu wiersza poleceń Firebase

Do rozpowszechniania użyj narzędzi interfejsu wiersza poleceń Firebase udostępnianych przez App Distribution w sposób zautomatyzowany. Możesz podać testerów i informacje o wersji dla kompilacji.

Udostępnij najnowszą wersję na Androida, podając identyfikator aplikacji Firebase i opcjonalnie dodając informacje o wersji oraz plik zawierający adresy e-mail testerów:

firebase appdistribution:distribute test.aab  \
    --app 1:1234567890:android:0a1b2c3d4e5f67890  \
    --release-notes "Bug fixes and improvements" --testers-file testers.txt

Więcej informacji o automatyzacji kompilacji za pomocą interfejsu wiersza poleceń Firebase znajdziesz w artykule Rozpowszechnianie aplikacji na Androida wśród testerów za pomocą interfejsu wiersza poleceń Firebase.

Używanie danych uwierzytelniających usługi

Użyj wtyczki fastlane App Distribution, wtyczkę Gradle, lub wiersza poleceń Firebase z kontami usługi. Konto usługi to rodzaj konta Google, które reprezentuje aplikacje (a nie użytkowników). Twój system CI może używać kont usług do wykonywania zadań App Distribution. Więcej informacji znajdziesz w artykule Uwierzytelnianie za pomocą konta usługi.

Jeśli korzystasz z federacji tożsamości zadań, możesz wygenerować plik konfiguracji danych logowania zamiast klucza konta usługi.

Pamiętaj o limitach wydań

App Distribution obsługuje maksymalnie 1000 wersji na aplikację. Oznacza to, że po przekroczeniu limitu wersji App Distribution automatycznie usunie najstarsze wersje powyżej limitu. Aby dowiedzieć się, jak zarządzać limitami wersji, przeczytaj artykuł Jak długo wersje aplikacji są dostępne?.

Dodawanie tego samego zestawu testerów do wielu wersji

Jeśli chcesz dodać do wersji dużą liczbę testerów, użyj funkcji Funkcja zarządzania testerami zbiorczymi w usłudze App Distribution.

Zalecamy dodanie tych samych testerów do wielu wersji za pomocą grup. Grupa działa jak lista kontroli dostępu. Gdy usuniesz testera z grupy, straci on dostęp do wszystkich wersji rozpowszechnianych w tej grupie. Więcej informacji znajdziesz w artykule Dodawanie i usuwanie testerów z grupy.

Jeśli masz wielu testerów, możesz dodawać i usuwać ich zbiorczo za pomocą konsoli Firebase. Aby zautomatyzować dodawanie i usuwanie testerów, użyj FirebaseCLI, fastlane, Gradle lub publicznego interfejsu API App DistributionFirebase.

Pamiętaj o limitach testerów

App Distribution ogranicza liczbę testerów, których możesz dodać do projektu Firebase lub grupa App Distribution. Po przekroczeniu tych limitów nie będzie można rozpowszechniać aplikacji wśród dodatkowych testerów. Aby dowiedzieć się więcej o limitach testerów, Więcej informacji znajdziesz w artykule Czy są jakieś limity dodawania testerów do aplikacji?

Umożliwienie potencjalnym testerom samodzielnego rejestrowania się na testy

Aby ułatwić udostępnianie aplikacji większej liczbie testerów, zalecamy wykonanie tych czynności: za pomocą linków z zaproszeniami. Link z zaproszeniem to unikalny URL, pod którym testerzy mogą wpisać adresy e-mail do rejestracji w celu przetestowania aplikacji. Umożliwianie użytkownikom dodawania do listy testerów aplikacji to wygodny sposób na zwiększenie do wewnętrznej bazy testów.

Linki do zaproszenia można stosować w przypadku programów testowania wewnątrz firmy, organizacji z dużymi zespołami ds. jakości oraz grup programistów, które chcą, aby poszczególni klienci mogli kontrolować dostęp testerów.

Zalecamy utworzenie linku z zaproszeniem do grupy. Każdy tester, który podpisuje aplikację za pomocą linku z zaproszeniem jest automatycznie dodawana do kolejnych wersji.

Więcej informacji znajdziesz w artykule o tworzeniu linków z zaproszeniem i dodawaniu i usuwaniu testerów z grupy.

Upewnij się, że testerzy testują wersję, która Cię interesuje

Po przesłaniu nowej wersji testerzy otrzymają e-maila z powiadomieniem. Do aby uzupełnić to powiadomienie, możesz skorzystać z następujących funkcji – o linkach i alertach w aplikacji – aby mieć pewność, że testerzy testują wersja aplikacji, na której Ci zależy:

  • Linki do wersji: użyj tej funkcji, aby udostępnić testerom konkretną wersję. Aby dowiedzieć się, jak korzystać z linków do wersji, zobacz Rozpowszechniaj aplikacje na Androida testerom za pomocą konsoli Firebase. Te linki są też dostępne w Firebase, fastlane oraz Gradle narzędzi wiersza poleceń (CLI) do użytku z narzędziami do automatyzacji kompilacji.
  • Ostrzeżenia w aplikacji: używaj tych ostrzeżeń, gdy chcesz mieć pewność, że testerzy sprawdzają najnowszą wersję aplikacji. Dzięki zintegrowaniu pakietu SDK App Distribution Firebase na Androida możesz wyświetlać ostrzeżenia bezpośrednio w aplikacji testerom, gdy dostępne są nowe wersje aplikacji. Aby się uczyć jak dodać alerty w aplikacji, zobacz Powiadamianie testerów o nowych kompilacji

Automatycznie usuwaj dostęp testerów, którzy opuszczają firmę

Gdy proces testowania wewnętrznego CI/CD jest uruchomiony, musisz zadbać o to, aby osoby, które opuszczają firmę, nie miały już dostępu do wewnętrznych kompilacji. Aby ułatwić zarządzanie dostępem testerów do wersji, App Distribution udostępnia te opcje: