Dystrybuuj aplikacje na Androida wśród testerów, korzystając z interfejsu wiersza polecenia Firebase

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

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

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

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

    1. W konsoli Firebase przejdź do pliku Ustawienia projektu , a następnie wybierz zakładkę Integracje .

    2. Na karcie Google Play kliknij Link .
      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ę 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:

  1. 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.
  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ć 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 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 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 i appdistribution:group:delete , aby utworzyć lub usunąć grupy w projekcie Firebase.

    Użyj opcji --group-alias , aby określić grupę dla appdistribution:testers:add i appdistribution: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