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 kontroli jakości za pomocą CI/CD i szybkiego pasa.
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ć funkcję App Distribution, wykonaj te czynności:
- Otwórz stronę App Distribution w konsoli Firebase.
- Wybierz aplikację na Androida.
- Kliknij Rozpocznij.
Biorąc pod uwagę, że pakiety Android App Bundle stają się najpopularniejszą wersją Androida w określonym formacie, 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ć tworzenie i publikowanie aplikacji dla testerów i za pomocą CI/CD, zalecamy korzystanie z 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 przy użyciu fastlane – open source narzędzie, które automatyzuje tworzenie i publikowanie aplikacji na iOS i Androida. Tworząc i automatyczne rozpowszechnianie najnowszych wersji testerom, testerzy zawsze mają do dyspozycji najbardziej aktualną wersję testową aplikacji.
Aby dowiedzieć się, jak zintegrować aplikację App Distribution z Fastlane, przeczytaj artykuł Rozpowszechnianie aplikacji na Androida testerom przy użyciu fastlane.
Używanie Gradle
Użyj Gradle, aby zintegrować aplikację App Distribution z procesem kompilacji Androida za pomocą
Wtyczka do obsługi Gradle App Distribution. Wtyczka umożliwia określenie testerów
informacji o wersji w pliku build.gradle
, który umożliwia skonfigurowanie
na różne typy kompilacji i warianty aplikacji.
Aby dowiedzieć się, jak zintegrować App Distribution z Gradle, zobacz Rozpowszechnianie aplikacji na Androida testerom przy użyciu 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 swoją najnowszą kompilację Androida, podając jej identyfikator w Firebase. Opcjonalnie możesz dodać informacje o wersji i plik z adresami e-mail testerów:
firebase appdistribution:distribute test.aab \
--app 1:1234567890:android:0a1b2c3d4e5f67890 \
--release-notes "Bug fixes and improvements" --testers-file testers.txt
Aby dowiedzieć się więcej o używaniu interfejsu wiersza poleceń Firebase do automatyzacji kompilacji, Więcej informacji znajdziesz w artykule Udostępnianie aplikacji na Androida testerom przy użyciu interfejsu wiersza poleceń Firebase.
Uwierzytelnianie przy użyciu danych logowania do usługi
Użyj wtyczki fastlane App Distribution, wtyczkę Gradle, lub wiersza poleceń Firebase z kontami usługi. konta usługi, to typ konta Google, który służy do logowania się w aplikacjach (a nie użytkowników). Twój system CI może używać kont usługi do uruchamiania zadań App Distribution. Więcej informacji znajdziesz w sekcji 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, zobacz Jak długo dostępne są wersje aplikacji?
Dodaj tę samą grupę 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, utracą dostęp do wszystkich wersji rozpowszechnianych w tej grupie. Aby się uczyć Więcej informacji znajdziesz w artykule Dodawanie testerów do grupy i usuwanie ich z niej.
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 funkcji interfejs wiersza poleceń Firebase, fastlane, Gradle lub publiczny interfejs API Firebase App Distribution.
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: i rozpowszechniać aplikację dodatkowym testerom. Aby dowiedzieć się więcej o limitach testerów, Więcej informacji znajdziesz w artykule Czy są jakieś limity dodawania testerów do aplikacji?
Pozwól potencjalnym testerom na samodzielną rejestrację 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.
Przypadki użycia linków z zaproszeniem obejmują firmowe programy testów wewnętrznych, organizacje z dużych zespołów ds. kontroli jakości i grup programistów, którym zależy na tym, aby klienci indywidualni 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 Tworzenie linków z zaproszeniem. oraz Dodawanie testerów do grupy i ich usuwanie.
Upewnij się, że testerzy testują wersję, na której Ci zależy
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, gdy chcesz udostępnić określony plik i udostępnienie jej testerom. 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.
- Alerty w aplikacji: skorzystaj z tych alertów, aby mieć pewność, że Twoje testerzy testują najnowszą wersję Twojej aplikacji. Dzięki integracji pakietu SDK Firebase App Distribution na Androida, możesz wyświetlać alerty bezpośrednio w pakiecie SDK. udostępniać aplikację testerom, gdy pojawią się jej nowe kompilacje. 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ę
Po uruchomieniu wewnętrznego procesu testów CI/CD musisz sprawdzić, czy że osoby, które odchodzą z firmy, nie mają już dostępu do danych do tworzenia kampanii. Aby ułatwić Ci zarządzanie dostępem testerów do kompilacji, App Distribution udostępnia następujące opcje:
- fastlane (szybkość): użyj pliku Fastfile lub bezpośrednio uruchom działania szybkich pasów. Do Więcej informacji znajdziesz w artykule Udostępnianie aplikacji na Androida testerom przy użyciu fastlane.
- Interfejs wiersza poleceń Firebase: użyj
firebase appdistribution:testers:remove
działania. Więcej informacji znajdziesz w artykule Udostępnianie aplikacji na Androida testerom przy użyciu interfejsu wiersza poleceń Firebase. - Gradle: jeśli używasz Gradle do usuwania testerów,
appDistributionRemoveTesters
z argumentami
i--PROJECT_NUMBER
w pliku--EMAILS build.gradle
. Więcej informacji: Udostępnianie aplikacji na Androida testerom za pomocą Gradle - Publiczny interfejs Firebase App Distribution API:
Użyj punktu końcowego
testers.batchRemove
.