Dystrybuuj aplikacje na Androida do testerów za pomocą interfejsu wiersza polecenia Firebase

W tym przewodniku opisano, jak rozpowszechniać pakiety aplikacji na Androida (AAB) testerom za pomocą interfejsu wiersza polecenia Firebase. Narzędzie CLI pozwala określić testerów i informacje o wersji dla kompilacji, a następnie odpowiednio ją dystrybuować.

Aby postępować zgodnie z tym przewodnikiem, musisz spełnić następujące wymagania wstępne: dostęp do projektu Firebase ( Właściciel lub Administrator Firebase ), dostęp do konta programisty Google Play ( Właściciel lub Administrator ) oraz aplikacja, która jest opublikowana w Google Play.

Zanim zaczniesz

1. Jeśli jeszcze tego nie zrobiłeś, dodaj Firebase do swojego projektu na Androida . Pod koniec tego przepływu pracy będziesz mieć aplikację Firebase na Androida w swoim projekcie Firebase.

   Jeśli nie używasz innych produktów Firebase, wystarczy, że utworzysz projekt i zarejestrujesz swoją aplikację. Jeśli zdecydujesz się na korzystanie z dodatkowych produktów, wykonaj wszystkie czynności opisane w sekcji Dodaj Firebase do swojego projektu na Androida .

2. Aby utworzyć link Firebase do Google Play i przesłać pliki AAB, upewnij się, że Twoja aplikacja spełnia następujące wymagania:

   • Aplikacja w Google Play i aplikacja Firebase na Androida są zarejestrowane przy użyciu tej samej nazwy pakietu.

   • Aplikacja w Google Play jest konfigurowana w panelu aplikacji i jest dystrybuowana do jednej ze ścieżek Google Play (testy wewnętrzne, testy zamknięte, testy otwarte lub produkcja).

   • Przegląd aplikacji w Google Play został zakończony i aplikacja została opublikowana. Twoja aplikacja zostanie opublikowana, jeśli w kolumnie Stan aplikacji widoczny jest jeden z następujących stanów: Testy wewnętrzne (nie Testy wewnętrzne w wersji roboczej), Testy zamknięte, Testy otwarte lub Produkcja.

3. Połącz aplikację Firebase na Androida z kontem programisty Google Play:

   1. W konsoli Firebase przejdź do settings projektu , a następnie wybierz kartę Integracje .

   2. Na karcie Google Play kliknij Połącz .
      Jeśli masz już linki do Google Play, kliknij Zarządzaj .

   3. Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby włączyć integrację aplikacji App Distribution i wybrać, które aplikacje Firebase na Androida mają być połączone z Google Play.

   Dowiedz się więcej o łączeniu z Google Play .

Krok 1. Zbuduj swoją aplikację

Gdy będziesz gotowy do dystrybucji przedpremierowej wersji aplikacji wśród testerów, utwórz AAB (instrukcje znajdziesz w dokumentacji Android Studio ).

Krok 2. Rozpowszechnij swoją aplikację wśród testerów

Aby rozpowszechniać aplikację wśród testerów, prześlij plik aplikacji za pomocą interfejsu wiersza polecenia Firebase:

1. Zainstaluj lub zaktualizuj do najnowszej wersji Firebase CLI (zalecamy pobranie samodzielnego pliku binarnego dla CLI specyficznego dla Twojego systemu operacyjnego). Zaloguj się i sprawdź, czy masz dostęp do swoich projektów.
2. Na stronie Dystrybucja aplikacji w konsoli Firebase wybierz aplikację, którą chcesz rozpowszechniać, a następnie kliknij Rozpocznij .

3. Uruchom polecenie appdistribution:distribute , aby przesłać swoją aplikację i rozpowszechnić ją wśród testerów. Użyj następujących parametrów, aby skonfigurować dystrybucję:

   appdistribution:opcje dystrybucji
   --app	Wymagane : identyfikator Firebase aplikacji Twojej aplikacji. Identyfikator aplikacji znajdziesz w konsoli Firebase na stronie Ustawienia ogólne . --app 1:1234567890:android:0a1b2c3d4e5f67890
   --token	Token odświeżania, który jest drukowany podczas uwierzytelniania środowiska CI za pomocą interfejsu Firebase CLI (więcej informacji można znaleźć w artykule Korzystanie z interfejsu wiersza polecenia z systemami CI ). --token "$FIREBASE_TOKEN"
   --release-notes --release-notes-file	Informacje o wersji dla tej kompilacji. Informacje o wersji można określić bezpośrednio: --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 oddzielonych 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ć (patrz Zarządzanie testerami ). Grupy są określone za pomocą aliasy grupowe , które możesz sprawdzić w konsoli Firebase. Możesz określić grupy jako listę rozdzielaną przecinkami: --groups "qa-team, trusted-testers" Możesz też określić ścieżkę do zwykłego pliku tekstowego zawierającego rozdzieloną przecinkami listę nazw grup: --groups-file "/path/to/groups.txt"
   --debug	Flaga, którą można dołączyć, aby wyświetlić szczegółowe dane wyjściowe dziennika.

   Na przykład:

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

   Oprócz rozpowszechniania wydań możesz również użyć appdistribution:testers:add i appdistribution: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 wydań w Twoim projekcie. Pamiętaj, że testerzy, którzy zostali niedawno usunięci, mogą nadal przez pewien czas zachować dostęp do Twoich wydań.

   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 również określić testerów za pomocą --file /path/to/testers.txt .

Po rozesłaniu kompilacji staje się ona dostępna w panelu dystrybucji aplikacji konsoli Firebase przez 150 dni (pięć miesięcy). Gdy kompilacja minie 30 dni od wygaśnięcia, powiadomienie o wygaśnięciu pojawi się zarówno w konsoli, jak i na liście kompilacji testera na urządzeniu testowym.

Testerzy, którzy nie zostali zaproszeni do testowania aplikacji, otrzymują zaproszenia e-mail, aby rozpocząć, a dotychczasowi testerzy otrzymują powiadomienia e-mail, że nowa kompilacja jest gotowa do testowania (przeczytaj przewodnik konfiguracji testera, aby uzyskać instrukcje dotyczące instalowania aplikacji testowej). Możesz monitorować stan każdego testera – czy przyjął zaproszenie i czy pobrał aplikację – w konsoli Firebase.

Testerzy mają 30 dni na zaakceptowanie zaproszenia do przetestowania aplikacji przed jej wygaśnięciem. Po upływie 5 dni od wygaśnięcia zaproszenia w konsoli Firebase obok testera wersji pojawia się informacja o wygaśnięciu. Zaproszenie można odnowić, wysyłając je ponownie za pomocą menu rozwijanego w wierszu testera.