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.

Informacje o dystrybucji pakietów aplikacji na Androida

Dystrybucja aplikacji integruje się z wewnętrzną usługą udostępniania aplikacji w Google Play, aby przetwarzać przesłane pliki AAB i udostępniać pakiety APK zoptymalizowane pod kątem konfiguracji urządzeń testerów. Dystrybuując AAB, możesz:

  • Uruchamiaj zoptymalizowane pakiety APK (serwowane przez Google Play), które są zoptymalizowane pod kątem urządzeń Twoich testerów.
  • Odkrywaj i debuguj problemy specyficzne dla urządzenia.
  • Testuj funkcje pakietu aplikacji, takie jak dostawa funkcji Play i dostawa zasobów Play
  • Zmniejsz rozmiar plików do pobrania dla testerów.

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 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.