W tym przewodniku opisano, jak dystrybuować pakiety aplikacji na Androida (AAB) wśród testerów za pomocą interfejsu wiersza polecenia Firebase. Narzędzie CLI umożliwia określenie testerów i informacji o wersji dla kompilacji, a następnie odpowiednią dystrybucję kompilacji.
App Distribution integruje się z wewnętrzną usługą udostępniania aplikacji w Google Play, aby przetwarzać przesłane pliki AAB i wyświetlać pliki APK zoptymalizowane pod kątem konfiguracji urządzeń Twoich testerów. Dystrybucja pakietów AAB umożliwia wykonanie następujących czynności:
Uruchom zoptymalizowane pliki APK (obsługiwane przez Google Play), które są zoptymalizowane pod kątem urządzeń Twoich testerów.
Odkrywaj i debuguj problemy specyficzne dla urządzenia.
Przetestuj funkcje pakietu aplikacji, takie jak dostarczanie funkcji Play i dostarczanie zasobów Play .
Zmniejsz rozmiar plików do pobrania dla testerów.
Wymagane uprawnienia
Aby przesłać pliki AAB do App Distribution, musisz połączyć aplikację Firebase z aplikacją w Google Play . Aby wykonać te czynności, musisz mieć wymagany poziom dostępu.
Jeśli nie masz niezbędnego dostępu do Firebase, możesz poprosić właściciela projektu Firebase o przypisanie Ci odpowiedniej roli za pomocą ustawień uprawnień w konsoli Firebase . Jeśli masz pytania dotyczące dostępu do projektu Firebase, w tym znalezienia lub przypisania właściciela, przejrzyj często zadawane pytania „Uprawnienia i dostęp do projektów Firebase” .
Poniższa tabela dotyczy łączenia aplikacji Firebase z aplikacją w Google Play, a także przesyłania plików AAB.
Akcja w konsoli Firebase | Wymagane uprawnienia IAM | Role uprawnień, które domyślnie obejmują wymagane uprawnienia | Dodatkowe wymagane role |
---|---|---|---|
Połącz aplikację Firebase z aplikacją w Google Play | firebase.playLinks.update | Jedna z następujących ról: | Dostęp do konta programisty Google Play jako administrator |
Prześlij pliki AAB do dystrybucji aplikacji | firebaseappdistro.releases.update | Jedna z następujących ról: | –– |
Zanim zaczniesz
Jeśli jeszcze tego nie zrobiłeś, dodaj Firebase do swojego projektu na Androida . Po zakończeniu tej procedury będziesz mieć aplikację Firebase na Androida w swoim projekcie Firebase.
Jeśli nie korzystasz z innych produktów Firebase, wystarczy, że utworzysz projekt i zarejestrujesz swoją aplikację. Jeśli zdecydujesz się skorzystać z dodatkowych produktów, pamiętaj o wykonaniu wszystkich kroków z rozdziału Dodaj Firebase do swojego projektu na Androida .
Aby utworzyć połączenie Firebase z Google Play i przesłać pliki AAB, upewnij się, że Twoja aplikacja spełnia następujące wymagania:
Zarówno aplikacja w Google Play, jak i aplikacja Firebase na Androida są zarejestrowane przy użyciu tej samej nazwy pakietu.
Aplikację w Google Play konfiguruje się na panelu aplikacji i dystrybuuje do jednej ze ścieżek Google Play (testy wewnętrzne, testy zamknięte, testy otwarte lub produkcja).
Zakończono sprawdzanie aplikacji w Google Play i opublikowano ją. Twoja aplikacja została opublikowana, jeśli w kolumnie Stan aplikacji wyświetlany jest jeden z następujących stanów: Testy wewnętrzne (nie wersja robocza testów wewnętrznych), Testy zamknięte, Testy otwarte lub Produkcja.
Połącz swoją aplikację Firebase na Androida z kontem programisty Google Play:
W konsoli Firebase przejdź do pliku
Na karcie Google Play kliknij Link .
Jeśli masz już linki do Google Play, kliknij Zarządzaj .Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby włączyć integrację dystrybucji aplikacji i wybrać aplikacje Firebase na Androida, które chcesz połączyć z Google Play.
Dowiedz się więcej o łączeniu z Google Play .
Krok 1. Zbuduj swoją aplikację
Gdy wszystko będzie gotowe do udostępnienia testerom wersji wstępnej aplikacji, zbuduj AAB (instrukcje znajdziesz w dokumentacji Android Studio ).
Krok 2. Udostępnij swoją aplikację testerom
Aby udostępnić aplikację testerom, prześlij plik aplikacji za pomocą interfejsu wiersza polecenia Firebase:
- Zainstaluj lub zaktualizuj do najnowszej wersji Firebase CLI (zalecamy pobranie samodzielnego pliku binarnego dla interfejsu CLI specyficznego dla Twojego systemu operacyjnego). Zaloguj się i sprawdź, czy masz dostęp do swoich projektów.
- Na stronie Dystrybucja aplikacji w konsoli Firebase wybierz aplikację, którą chcesz rozpowszechniać, a następnie kliknij Rozpocznij .
Uruchom polecenie
appdistribution:distribute
, aby przesłać aplikację i udostępnić ją testerom. Aby skonfigurować dystrybucję, użyj następujących parametrów:dystrybucja aplikacji:opcje dystrybucji --app
Wymagane : identyfikator aplikacji Firebase Twojej aplikacji. Identyfikator aplikacji znajdziesz w konsoli Firebase, na stronie Ustawienia ogólne .
--app 1:1234567890:android:0a1b2c3d4e5f67890
--token
Token odświeżania drukowany podczas uwierzytelniania środowiska CI za pomocą interfejsu CLI Firebase (więcej informacji można znaleźć w artykule Używanie interfejsu CLI w systemach CI ).
--token "$FIREBASE_TOKEN"
--release-notes
--release-notes-file
Informacje o wersji dla tej kompilacji.
Możesz bezpośrednio określić informacje o wersji:
--release-notes "Text of release notes"
Lub określ ścieżkę do zwykłego pliku tekstowego:
--release-notes-file "/path/to/release-notes.txt"
--testers
--testers-file
Adresy e-mail testerów, których chcesz zaprosić.
Możesz określić testerów jako listę adresów e-mail rozdzielonych przecinkami:
--testers "ali@example.com, bri@example.com, cal@example.com"
Możesz też określić ścieżkę do zwykłego pliku tekstowego zawierającego listę adresów e-mail rozdzielonych przecinkami:
--testers-file "/path/to/testers.txt"
--groups
--groups-file
Grupy testerów, które chcesz zaprosić (więcej informacji znajdziesz w Zarządzaj testerami ). Grupy są określane przy użyciu
aliasy grupowe , które możesz sprawdzić w konsoli Firebase.Grupy można określić w formie listy rozdzielanej przecinkami:
--groups "qa-team, trusted-testers"
Możesz też określić ścieżkę do zwykłego pliku tekstowego zawierającego listę nazw grup rozdzielonych przecinkami:
--groups-file "/path/to/groups.txt"
--debug
Flaga, którą możesz dołączyć, aby wydrukować szczegółowe dane wyjściowe dziennika.
--test-devices
--test-devices-file
Następujące typy dystrybucji są częścią funkcji beta automatycznego testera .
Urządzenia testowe, do których chcesz dystrybuować kompilacje (zobacz Testy automatyczne ).
Możesz określić testerów jako listę adresów e-mail rozdzielonych przecinkami:
--test-devices: "model=shiba,version=34,locale=en,orientation=portrait;model=b0q,version=33,locale=en,orientation=portrait"
Możesz też określić ścieżkę do zwykłego 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 automatycznych .
--test-password
--test-password-file
Hasło do automatycznego logowania, które będzie wykorzystywane podczas testów automatycznych .
Możesz też określić ścieżkę do zwykłego pliku tekstowego zawierającego hasło:
--test-password-file: "/path/to/test-password.txt"
--test-username-resource
Nazwa zasobu pola nazwy użytkownika do automatycznego logowania, które będzie używane podczas testów automatycznych .
--test-password-resource
Nazwa zasobu pola hasła do automatycznego logowania, które będzie używane podczas testów automatycznych .
--test-non-blocking
Uruchamiaj testy automatyczne asynchronicznie. Odwiedź konsolę Firebase, aby zobaczyć wyniki testów automatycznych.
Na przykład:
firebase appdistribution:distribute test.aab \ --app 1:1234567890:android:0a1b2c3d4e5f67890 \ --release-notes "Bug fixes and improvements" --testers-file testers.txt
Po przesłaniu wersji interfejs Firebase CLI wyświetla następujące linki. Te linki pomogą Ci zarządzać plikami binarnymi i zapewnić testerom i innym programistom właściwą wersję:
-
firebase_console_uri
— łącze do konsoli Firebase wyświetlające pojedynczą wersję. Możesz udostępnić ten link innym programistom w swojej organizacji. -
testing_uri
— link do wersji w środowisku testera (natywna aplikacja na Androida), który umożliwia testerom przeglądanie informacji o wersji i instalowanie aplikacji na swoim urządzeniu. Tester musi mieć dostęp do wydania, aby móc skorzystać z linku. -
binary_download_uri
— podpisany link, który bezpośrednio pobiera i instaluje plik binarny aplikacji (plik APK lub AAB). Link wygasa po godzinie.
Zarządzaj testerami i grupami
Oprócz dystrybucji wydań możesz także użyć
appdistribution:testers:add
iappdistribution:testers:remove
aby zaprosić nowych testerów lub usunąć istniejących testerów z projektu Firebase.Po dodaniu testera do projektu Firebase możesz dodać go do poszczególnych wersji. Gdy usuniesz testera, nie będzie on już miał dostępu do wersji w Twoim projekcie. Pamiętaj, że niedawno usunięci testerzy mogą nadal zachować dostęp do Twoich wersji przez pewien czas.
Na przykład:
firebase appdistribution:testers:add anothertester@email.com moretesters@email.com
firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com
E-maile testerów muszą być oddzielone spacją. Możesz także określić testerów za pomocą
--file /path/to/testers.txt
.Jeśli masz dużą liczbę testerów, powinieneś rozważyć użycie grup: Możesz użyć
appdistribution:group:create
iappdistribution:group:delete
, aby utworzyć lub usunąć grupy w projekcie Firebase.Użyj opcji
--group-alias
, aby określić grupę dlaappdistribution:testers:add
iappdistribution:testers:remove
.Na przykład:
firebase appdistribution:group:create "QA team" qa-team
firebase appdistribution:testers:add --group-alias=qa-team anothertester@email.com moretesters@email.com
firebase appdistribution:testers:remove --group-alias=qa-team anothertester@email.com moretesters@email.com
firebase appdistribution:group:delete qa-team
-
Po rozpowszechnieniu kompilacji staje się ona dostępna w panelu dystrybucji aplikacji w konsoli Firebase przez 150 dni (pięć miesięcy). Gdy do wygaśnięcia kompilacji zostanie 30 dni, powiadomienie o wygaśnięciu pojawi się zarówno w konsoli, jak i na liście kompilacji testera na jego urządzeniu testowym.
Testerzy, którzy nie zostali zaproszeni do testowania aplikacji, otrzymują e-mail z zaproszeniami do rozpoczęcia, a obecni testerzy otrzymują powiadomienia e-mailem, że nowa kompilacja jest gotowa do testowania (przeczytaj przewodnik konfiguracji testera , aby uzyskać instrukcje dotyczące instalowania aplikacji testowej). Możesz monitorować status każdego testera – czy przyjął zaproszenie i czy pobrał aplikację – w konsoli Firebase.
Testerzy mają 30 dni na przyjęcie zaproszenia do testowania aplikacji, zanim wygaśnie. Gdy do wygaśnięcia zaproszenia pozostało 5 dni, w konsoli Firebase obok testera w wersji pojawi się powiadomienie o wygaśnięciu. Zaproszenie można odnowić, wysyłając je ponownie za pomocą menu rozwijanego w wierszu testera.
Następne kroki
Zaimplementuj opinie w aplikacji , aby ułatwić testerom przesyłanie opinii na temat Twojej aplikacji (w tym zrzutów ekranu).
Dowiedz się, jak wyświetlać testerom alerty w aplikacji , gdy będą dostępne do zainstalowania nowe wersje Twojej aplikacji.
Poznaj najlepsze praktyki dystrybucji aplikacji na Androida wśród testerów kontroli jakości przy użyciu CI/CD .