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

W tym dokumencie opisujemy sprawdzone metody korzystania z usługi Firebase App Distribution które pozwolą Ci utrzymać i powtarzać procesy testowania przedpremierowych wersji aplikacji na Androida w środowisku CI/CD. Obejmują one Gradle i fastlane, ale aby zapewnić Ci jeszcze większą elastyczność, uwzględniliśmy też rozwiązania dostępne w Firebase konsoli, w Firebase wierszu poleceń i w publicznym Firebase App Distribution interfejsie API. Opisujemy też limity wersji i testerów, aby umożliwić Ci wcześniejsze zaplanowanie optymalnego działania.

Jeśli używasz też platform Apple, przeczytaj Sprawdzone metody rozpowszechniania aplikacji na platformy Apple wśród 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 w przypadku każdej aplikacji. Jeśli nie włączysz App Distribution, pojawi się błąd 404.

Aby włączyć App Distribution:

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

Pakiety Android App Bundle (AAB) stają się najpopularniejszym formatem pakietów na Androida, dlatego zalecamy skonfigurowanie możliwości rozpowszechniania pakietów AAB wśród testerów przez połączenie z Google Play.

Automatyzacja procesu testowania przedpremierowych wersji aplikacji za pomocą potoku CI/CD

Jeśli chcesz zautomatyzować tworzenie i udostępnianie aplikacji testerom oraz korzystasz z CI/CD, zalecamy używanie fastlane lub Gradle. Możesz też użyć wiersza poleceń Firebase CLI, który umożliwia dostęp do wielu usług Firebase.

Używanie fastlane

Zintegruj App Distribution z potokiem CI/CD za pomocą fastlane, narzędzia open source, które automatyzuje tworzenie i udostępnianie aplikacji na iOS i Androida. Automatyczne tworzenie i rozpowszechnianie najnowszych wersji wśród testerów sprawia, że zawsze mają oni najbardziej aktualną wersję testową Twojej aplikacji.

Jak zintegrować App Distribution z fastlane, dowiesz się z artykułu Rozpowszechnianie aplikacji na Androida wśród testerów za pomocą fastlane.

Używanie Gradle

Użyj Gradle, aby zintegrować App Distribution z procesem kompilacji aplikacji na Androida za pomocą wtyczki Gradle do App Distribution. Wtyczka umożliwia określenie testerów i informacji o wersji w pliku build.gradle aplikacji, co pozwala skonfigurować rozpowszechnianie w przypadku różnych typów i wariantów aplikacji.

Jak zintegrować App Distribution z Gradle, dowiesz się z artykułu Rozpowszechnianie aplikacji na Androida wśród testerów za pomocą Gradle.

Używanie interfejsu wiersza poleceń Firebase

Użyj narzędzi interfejsu wiersza poleceń Firebase, które udostępnia App Distribution, aby programowo rozpowszechniać kompilacje wśród testerów. Możesz określić testerów i informacje o wersji.

Aby rozpowszechnić najnowszą kompilację na Androida, podaj identyfikator aplikacji Firebase, opcjonalnie dodaj informacje o wersji i 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.

Uwierzytelnianie za pomocą danych logowania do usługi

Używaj wtyczki App Distribution fastlane, wtyczki Gradle, lub interfejsu wiersza poleceń Firebase z kontami usługi. Konto usługi to typ konta Google, który reprezentuje aplikacje (a nie użytkowników). System CI może używać kont usługi do uruchamiania App Distribution zadań. Więcej informacji znajdziesz w artykule Uwierzytelnianie za pomocą konta usługi.

Jeśli używasz federacji Workload Identity, zamiast klucza konta usługi możesz wygenerować i użyć pliku konfiguracji danych logowania.

Limity wersji

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

Dodawanie tego samego zestawu testerów do wielu wersji

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

Zalecamy używanie grup, aby dodawać tych samych testerów do wielu wersji. Grupa działa jak lista kontroli dostępu. Gdy usuniesz testera z grupy, utraci on dostęp do wszystkich wersji rozpowszechnionych w tej grupie. Więcej informacji znajdziesz w artykule Dodawanie i usuwanie testerów z grupy.

Jeśli masz wielu testerów, którymi musisz zarządzać, możesz zbiorczo dodawać i usuwać testerów za pomocą konsoli Firebase. Aby zautomatyzować dodawanie i usuwanie testerów, użyj Firebase interfejsu wiersza poleceń, fastlane, Gradle, lub publicznego Firebase App Distribution interfejsu API.

Limity testerów

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

Umożliwianie potencjalnym testerom samodzielnego rejestrowania się do testów

Aby ułatwić rozpowszechnianie aplikacji wśród większej liczby testerów, zalecamy używanie linków z zaproszeniem. Link z zaproszeniem to unikalny adres URL, który umożliwia testerom wpisanie adresu e-mail, aby zarejestrować się do testowania aplikacji. Umożliwienie użytkownikom dodawania się do listy testerów aplikacji to prosty sposób na zwiększenie liczby testerów wewnętrznych.

Przykłady zastosowań linków z zaproszeniem to programy testowania wewnętrznego w firmach, organizacje z dużymi zespołami QA i grupy 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 zarejestruje się za pomocą linku z zaproszeniem, zostanie automatycznie dodany do kolejnych wersji.

Więcej informacji znajdziesz w artykułach Tworzenie linków z zaproszeniem oraz Dodawanie i usuwanie testerów z grupy.

Upewnianie się, że testerzy testują wersję, na której Ci zależy

Gdy prześlesz nową wersję, testerzy otrzymają powiadomienie e-mail. Aby uzupełnić to powiadomienie, możesz użyć tych funkcji: linków do wersji i alertów w aplikacji. Dzięki temu będziesz mieć pewność, że testerzy testują konkretną wersję aplikacji, na której Ci zależy:

Automatyczne usuwanie dostępu testerom, którzy opuszczają firmę

Gdy wewnętrzny proces testowania CI/CD jest już skonfigurowany i działa, musisz mieć pewność, że osoby, które opuszczają firmę, nie mają już dostępu do kompilacji wewnętrznych. Aby ułatwić zarządzanie dostępem testerów do kompilacji, App Distribution udostępnia te opcje: