Z tego przewodnika dowiesz się, jak rozpowszechniać pakiety aplikacji na Androida (AAB) wśród testerów za pomocą interfejsu wiersza poleceń Firebase. Narzędzie w wersji CLI umożliwia określenie testerów i notatek dotyczących kompilacji, a następnie rozprowadzanie kompilacji.
App Distribution integruje się z usługą wewnętrznego udostępniania aplikacji w Google Play, aby przetwarzać przesyłane przez Ciebie pakiety aplikacji i przekazywać pliki APK zoptymalizowane pod kątem konfiguracji urządzeń testerów. Rozpowszechnianie aplikacji z uwzględnieniem AAB umożliwia:
Uruchom zoptymalizowane pliki APK (dostarczane przez Google Play), które są zoptymalizowane pod kątem urządzeń testerów.
Wykrywanie i debugowanie problemów związanych z konkretnymi urządzeniami.
Testowanie funkcji pakietów aplikacji, takich jak Play Feature Delivery i Play Asset Delivery.
Zmniejsz rozmiar plików do pobrania dla testerów.
Wymagane uprawnienia
Aby przesyłać pakiety aplikacji na Androida 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 wymaganego dostępu do Firebase, możesz poprosić właściciela projektu Firebase o przypisanie Ci odpowiedniej roli w ustawieniach uprawnień konsoli Firebase. Jeśli masz pytania dotyczące dostępu do projektu Firebase, w tym znajdowania lub przypisywania właściciela, zapoznaj się z artykułem „Uprawnienia i dostęp do projektów Firebase”.
Poniższa tabela dotyczy łączenia aplikacji Firebase z aplikacją w Google Play oraz przesyłania pakietów aplikacji na Androida.
Działanie w konsoli Firebase | Wymagane uprawnienie IAM | Role uprawnień, które domyślnie zawierają wymagane uprawnienia | Dodatkowe wymagane role |
---|---|---|---|
Połącz aplikację Firebase z aplikacją w Google Play | firebase.playLinks.update
|
jedną z tych ról: | dostęp do konta dewelopera Google Play w roli administratora, |
Przesyłanie pakietów AAB do App Distribution | firebaseappdistro.releases.update
|
jedną z tych ról: | –– |
Zanim zaczniesz
Jeśli nie zostało to jeszcze zrobione, dodaj Firebase do projektu na Androida. Po zakończeniu tego procesu w Twoim projekcie Firebase będzie dostępna aplikacja Firebase na Androida.
Jeśli nie używasz innych usług Firebase, musisz tylko utworzyć projekt i zarejestrować aplikację. Jeśli zdecydujesz się używać dodatkowych usług, wykonaj wszystkie czynności opisane w artykule Dodawanie Firebase do projektu na Androida.
Aby utworzyć połączenie Firebase z Google Play i przesyłać pakiety aplikacji na Androida, sprawdź, czy Twoja aplikacja spełnia te wymagania:
Zarówno aplikacja w Google Play, jak i aplikacja Firebase na Androida zostały zarejestrowane przy użyciu tej samej nazwy pakietu.
Aplikacja w Google Play jest skonfigurowana w panelu aplikacji i rozpowszechniana na jednej ze ścieżek Google Play (test wewnętrzny, test zamknięty, test otwarty i produkcja).
Zakończono sprawdzanie aplikacji w Google Play i aplikacja została opublikowana. Aplikacja jest opublikowana, jeśli w kolumnie Stan aplikacji widoczny jest jeden z tych stanów: test wewnętrzny (nie wersja robocza testu wewnętrznego), test zamknięty, test otwarty lub produkcja.
Aby połączyć aplikację Firebase na Androida z kontem dewelopera w Google Play:
W konsoli Firebase otwórz
, a następnie kliknij kartę Integracje. Ustawienia projektu Na karcie Google Play kliknij Połącz.
Jeśli masz już połączenia z Google Play, kliknij Zarządzaj.Postępuj zgodnie z instrukcjami na ekranie, aby włączyć integrację App Distribution 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. Tworzenie aplikacji
Gdy będziesz gotowy do rozpowszechniania przedpremierowej wersji aplikacji wśród testerów, utwórz pakiet aplikacji na Androida (aby dowiedzieć się, jak to zrobić, zapoznaj się z dokumentacją Android Studio).
Krok 2. Udostępnianie aplikacji testerom
Aby rozpowszechnić aplikację wśród testerów, prześlij plik aplikacji za pomocą interfejsu wiersza poleceń Firebase:
- Zainstaluj najnowszą wersję interfejsu wiersza poleceń Firebase lub zaktualizuj go do tej wersji (zalecamy pobranie samodzielnego pliku binarnego dla interfejsu wiersza poleceń odpowiedniego dla Twojego systemu operacyjnego). Zaloguj się i sprawdź, czy masz dostęp do swoich projektów. .
- Na stronie App Distribution konsoli Firebase wybierz aplikację, którą chcesz rozpowszechniać, a potem kliknij Rozpocznij.
-
Uruchom polecenie
appdistribution:distribute
, aby przesłać aplikację i rozpowszechnić ją wśród testerów. Aby skonfigurować dystrybucję, użyj tych parametrów:appdistribution:distribute options --app
Wymagane: identyfikator aplikacji Firebase Twojej aplikacji. Identyfikator aplikacji znajdziesz w konsoli Firebase na stronie Ogólne ustawienia.
--app 1:1234567890:android:0a1b2c3d4e5f67890
--token
token odświeżania wydrukowany podczas uwierzytelniania środowiska CI za pomocą wiersza poleceń Firebase (więcej informacji znajdziesz w artykule Używanie wiersza poleceń w systemach CI ).
--token "$FIREBASE_TOKEN"
--release-notes
--release-notes-file
Informacje o tej kompilacji.
Możesz podać informacje o wersji bezpośrednio:
--release-notes "Text of release notes"
Możesz też podać ścieżkę do pliku tekstowego:
--release-notes-file "/path/to/release-notes.txt"
--testers
--testers-file
adresy e-mail testerów, których chcesz zaprosić.
Testerów możesz wskazać jako listę adresów e-mail rozdzielonych przecinkami:
--testers "ali@example.com, bri@example.com, cal@example.com"
Możesz też podać ścieżkę do 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ć (patrz Zarządzanie testerami). Grupy są określane za pomocą
aliasów grup , które możesz sprawdzić w konsoli Firebase.Grupy możesz określić jako listę oddzieloną przecinkami:
--groups "qa-team, trusted-testers"
Możesz też podać ścieżkę do pliku tekstowego zawierającego rozdzieloną przecinkami listę nazw grup:
--groups-file "/path/to/groups.txt"
--debug
Flaga, którą możesz dołączyć, aby wydrukować szczegółowy dziennik.
--test-devices
--test-devices-file
Te typy dystrybucji są częścią funkcji testowania automatycznego w wersji beta.
Urządzenia testowe, na które chcesz rozpowszechnić kompilacje (patrz Automatyczne testy).
Testerów możesz wskazać 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ż 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 ma być używana podczas testów zautomatyzowanych.
--test-password
--test-password-file
Hasło do automatycznego logowania, które będzie używane podczas testów zautomatyzowanych.
Możesz też określić ścieżkę do pliku tekstowego zawierającego hasło:
--test-password-file: "/path/to/test-password.txt"
--test-username-resource
Nazwa zasobu dla pola nazwy użytkownika do automatycznego logowania, które ma być używane podczas testów zautomatyzowanych.
--test-password-resource
Nazwa zasobu dla pola hasła do automatycznego logowania, które ma być używane podczas testów zautomatyzowanych.
--test-non-blocking
asynchronicznie przeprowadzać testy automatyczne; Wyniki automatycznego testu znajdziesz w konsoli Firebase.
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 wiersz poleceń Firebase wyświetla te linki: Te linki pomogą Ci zarządzać plikami binarnymi i zadbać o to, aby testerzy i inni deweloperzy mieli odpowiednią wersję:
firebase_console_uri
– link do konsoli Firebase, na której wyświetla się pojedynczy film. Możesz udostępnić ten link innym programistom w organizacji.testing_uri
– link do wersji w interfejsie testów (natywnej aplikacji na Androida), która umożliwia testerom wyświetlanie informacji o wersji i instalowanie aplikacji na urządzeniu. Aby użyć linku, tester musi mieć dostęp do wersji.binary_download_uri
– podpisany link, który bezpośrednio pobiera i instaluje binarną aplikację (plik APK lub AAB). Link wygasa po 1 godzinie.
Zarządzanie testerami i grupami
Oprócz rozpowszechniania wersji możesz też używać opcji
appdistribution:testers:add
iappdistribution:testers:remove
, aby zapraszać nowych testerów lub usuwać dotychczasowych testerów z projektu Firebase.Po dodaniu testera do projektu Firebase możesz go dodawać do poszczególnych wersji. Po usunięciu testera nie będzie on już mieć dostępu do wersji w Twoim projekcie. Pamiętaj, że testerzy, którzy zostali niedawno usunięci, mogą nadal mieć dostęp do Twoich wersji przez pewien czas.
Przykład:
firebase appdistribution:testers:add anothertester@email.com moretesters@email.com
firebase appdistribution:testers:remove anothertester@email.com moretesters@email.com
Adresy e-mail testerów muszą być oddzielone spacjami. Testerów możesz też określić za pomocą parametru
--file /path/to/testers.txt
.Jeśli masz dużą liczbę testerów, rozważ użycie grup: możesz użyć poleceń
appdistribution:group:create
iappdistribution:group:delete
, aby utworzyć lub usunąć grupy w projekcie Firebase.Użyj parametru
--group-alias
, aby określić grupę dla poleceńappdistribution:testers:add
iappdistribution:testers:remove
.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 wersji kompilacji będzie ona dostępna w panelu App Distribution konsoli Firebase przez 150 dni (5 miesięcy). Gdy do wygaśnięcia wersji pozostało 30 dni, w konsoli i na liście wersji na urządzeniu testowym testera pojawi się powiadomienie o wygaśnięciu.
Testerzy, którzy nie zostali zaproszeni do testowania aplikacji, otrzymują e-maile z zaproszeniem do rozpoczęcia testów, a obecni testerzy otrzymują e-maile z powiadomieniem, że nowa wersja jest gotowa do testowania (instrukcje instalacji testowej wersji aplikacji znajdziesz w przewodniku po konfiguracji testów). Stan każdego testującego (czy zaakceptował zaproszenie i czy pobrał aplikację) możesz sprawdzać w konsoli Firebase.
Testerzy mają 30 dni na zaakceptowanie zaproszenia do przetestowania aplikacji, zanim utraci ono ważność. Gdy do wygaśnięcia zaproszenia pozostaną 5 dni, w konsoli Firebase obok testera w ramach danej wersji pojawi się powiadomienie o wygaśnięciu. Zaproszenie można odnowić, wysyłając je ponownie za pomocą menu w wierszu testującego.
Dalsze kroki
Wprowadź opinie w aplikacji, aby ułatwić testerom przesyłanie opinii na temat aplikacji (w tym zrzutów ekranu).
Dowiedz się, jak wyświetlać alerty w aplikacji testerom, gdy nowe kompilacje aplikacji są dostępne do zainstalowania.
Poznaj sprawdzone metody rozpowszechniania aplikacji na Androida wśród testerów kontroli jakości za pomocą CI/CD.