Udostępnianie aplikacji na Androida testerom za pomocą interfejsu wiersza poleceń Firebase

.

Z tego przewodnika dowiesz się, jak udostępniać testerom pakiety Android App Bundle za pomocą interfejsu wiersza poleceń Firebase. Narzędzie wiersza poleceń pozwala wskazać testerów informacji o wersji dotyczących kompilacji, a następnie odpowiednio ją rozpowszechnia.

Rozpowszechnianie aplikacji integruje się z wewnętrzną usługą udostępniania aplikacji Google Play, przetwarzania przesłanych pakietów aplikacji na Androida i udostępniania plików APK zoptymalizowanych pod kątem konfiguracji urządzeń. Dystrybucja pakietów aplikacji na Androida umożliwia:

  • Uruchamiaj zoptymalizowane pliki APK (udostępniane przez Google Play), które są zoptymalizowane pod kątem dla testerów urządzenia.

  • Wykrywanie i debugowanie problemów związanych z urządzeniami.

  • Przetestuj funkcje pakietu aplikacji, takie jak Play Feature Delivery i Play Asset Delivery.

  • Zmniejsz rozmiar pobieranych plików przeznaczonych dla testerów.

Wymagane uprawnienia

Aby przesyłać pakiety aplikacji na Androida do usługi Rozpowszechnianie aplikacji, musisz połączyć z nią swoją aplikację Firebase w Google Play. Musisz mieć wymagany poziom dostępu do wykonania tych czynności.

Jeśli nie masz odpowiedniego dostępu do Firebase, możesz poprosić o projekt Firebase. właściciela, aby przypisać Ci odpowiednią rolę w Ustawienia uprawnień konsoli Firebase. Jeśli masz pytania dotyczące dostępu do projektu Firebase, w tym znaleźć lub przypisać właściciela, zapoznaj się z „Uprawnienia i dostęp do projektów Firebase” Najczęstsze pytania.

Poniższa tabela dotyczy łączenia aplikacji Firebase z aplikacją w Google Play oraz przesyłanie aplikacji na Androida.

Działanie w konsoli Firebase Wymagane uprawnienia Role, które obejmują wymagane uprawnienia przyznane przez domyślny Dodatkowe wymagane role
Łączenie aplikacji Firebase z aplikacją w Google Play firebase.playLinks.update Jedna z tych ról: dostępu do konta dewelopera w Google Play jako Administracja
Przesyłanie pakietów aplikacji na Androida do Rozpowszechniania aplikacji firebaseappdistro.releases.update Jedna z tych ról: ––

Zanim zaczniesz

  1. Dodaj Firebase do swojego urządzenia z Androidem, chyba że masz to już za sobą projekt. Na koniec tego procesu mieć aplikację Firebase na Androida w swoim projekcie Firebase.

    Jeśli nie korzystasz z żadnych innych usług Firebase, musisz tylko utworzyć projekt i zarejestrować aplikację. Jeśli zdecydujesz się na korzystanie z dodatkowych usług, wykonaj wszystkie czynności Dodaj Firebase do swojego projektu na Androida.

  2. Aby utworzyć połączenie Firebase z Google Play i przesyłać pakiety aplikacji na Androida, sprawdź, czy aplikacja spełnia te wymagania:

    • Aplikacja w Google Play i aplikacja Firebase na Androida są zarejestrowane. o tej samej nazwie pakietu.

    • aplikacja w Google Play została skonfigurowana w aplikacji, panel i jest rozpowszechniana na jednej ze ścieżek Google Play (testy wewnętrzne, (test zamknięty, otwarty lub wersja produkcyjna).

    • Zakończono sprawdzanie aplikacji w Google Play i aplikacja została opublikowana. Aplikacja jest opublikowana, jeśli w kolumnie Stan aplikacji wyświetla się jeden z te stany: Test wewnętrzny (nie Test wewnętrzny wersji roboczej), Test zamknięty, otwarty lub wersja produkcyjna.

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

    1. W konsoli Firebase otwórz Ustawienia projektu, a następnie wybierz kartę Integracje.

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

    3. Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby włączyć Rozpowszechnianie aplikacji. i wybierz aplikacje Firebase na Androida, które chcesz połączyć z Google Graj.

    Więcej informacji o łączeniu konta z Google Play.

Krok 1. Utwórz aplikację

Gdy zechcesz udostępnić testerom przedpremierową wersję aplikacji, utwórz pakiet aplikacji na Androida (zapoznaj się z Dokumentacja Android Studio ).

Krok 2. Udostępnianie aplikacji testerom

Aby udostępnić aplikację testerom, prześlij jej plik za pomocą Interfejs wiersza poleceń Firebase:

  1. Zainstaluj lub zaktualizuj interfejs wiersza poleceń Firebase do najnowszej wersji. (zalecamy pobranie samodzielnego pliku binarnego interfejsu wiersza poleceń dostosowanego do Twojego systemu operacyjnego). Zaloguj się i sprawdź, czy masz dostęp do w projektach AI.
  2. Na stronie Rozpowszechnianie aplikacji w konsoli Firebase wybierz aplikację, którą chcesz udostępnić, i kliknij Rozpocznij.

  3. Uruchom polecenie appdistribution:distribute, aby przesłać aplikację i i rozpowszechniać go wśród testerów. Użyj poniższych parametrów, aby skonfigurować rozkład:

    appdistribution:opcja dystrybuowania
    --app

    Wymagany: identyfikator aplikacji Firebase. Znajdziesz ją w konsoli Firebase, na stronie Ogólne Strona ustawień.

    --app 1:1234567890:android:0a1b2c3d4e5f67890
    --token

    Token odświeżania, który jest drukowany podczas uwierzytelniania CI za pomocą interfejsu wiersza poleceń Firebase (przeczytaj Używanie interfejsu wiersza poleceń razem z CI systemy ). 

    --token "$FIREBASE_TOKEN"
    --release-notes
    --release-notes-file

    Informacje o wersji tej kompilacji.

    Informacje o wersji możesz podać bezpośrednio:

    --release-notes "Text of release notes"

    Możesz też podać ś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 podać testerów jako listę adresów e-mail rozdzielonych przecinkami adresy:

    --testers "ali@example.com, bri@example.com, cal@example.com"

    Możesz też określić ścieżkę do pliku tekstowego zawierającego rozdzielana przecinkami lista adresów e-mail:

    --testers-file "/path/to/testers.txt"
    --groups
    --groups-file

    Grupy testerów, które chcesz zaprosić (patrz: Zarządzaj testerami). Grupy określa się przy użyciu aliasów grup, których możesz używać możesz znaleźć w konsoli Firebase.

    Grupy możesz podać w postaci listy rozdzielanej przecinkami:

    --groups "qa-team, trusted-testers"

    Możesz też określić ścieżkę do pliku tekstowego zawierającego rozdzielana przecinkami lista nazw grup:

    --groups-file "/path/to/groups.txt"
    --debug

    Flaga, którą możesz dołączyć, aby wyświetlić szczegółowe dane wyjściowe dziennika.
    --test-devices
    --test-devices-file

    Poniższe typy dystrybucji są częścią funkcji automatycznych testerów w wersji beta.

    Urządzenia testowe, na które chcesz rozpowszechniać kompilacje (patrz Testy automatyczne).

    Możesz podać testerów jako listę adresów e-mail rozdzielonych przecinkami adresy:

    --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 pliku tekstowego zawierającego lista urządzeń testowych rozdzielana średnikami:

    --test-devices-file: "/path/to/test-devices.txt"
    --test-username

    Nazwa użytkownika do automatycznego logowania się podczas testów automatycznych.
    --test-password
    --test-password-file

    Hasło do automatycznego logowania używane podczas testów automatycznych.

    Możesz też podać ścieżkę do zwykłego pliku tekstowego zawierającego hasło:

    --test-password-file: "/path/to/test-password.txt"
    --test-username-resource

    Nazwa zasobu w polu nazwy użytkownika na potrzeby automatycznego logowania, które jest używane podczas testów automatycznych.
    --test-password-resource

    Nazwa zasobu w polu hasła na potrzeby automatycznego logowania się podczas testów automatycznych.
    --test-non-blocking

    asynchronicznie uruchamiać testy automatyczne, Otwórz konsolę Firebase, aby wyświetlić wyniki automatycznych testów.

    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 wiersza poleceń Firebase wyświetla poniższe linki. Te linki pomogą Ci zarządzać plikami binarnymi i sprawdzić, czy testerzy i inni którzy mają właściwą wersję:

    • firebase_console_uri – link do funkcji Konsola Firebase z wyświetloną pojedynczą wersją. Możesz to udostępnić .
    • testing_uri – link do wersji w testerze doświadczenie (aplikacja natywna na Androida) który umożliwia testerom wyświetlenie wersji notatki i zainstalować aplikację na urządzeniu. Tester potrzebuje dostęp do wydania, aby użyć 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ądzanie testerami i grupami

    Oprócz rozpowszechniania wersji, możesz też używać appdistribution:testers:add i appdistribution:testers:remove, aby zaprosić lub usunąć testerów dotychczasowych testerów z projektu Firebase.

    Po dodaniu testera do projektu Firebase, możesz dodać je do poszczególnych wersji. Gdy usuniesz testera, utraci on dostęp do: w Twoim projekcie. Pamiętaj, że niedawno usunięci testerzy mogą zachowają dostęp do swoich 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ć rozdzielone spacją. Możesz też określić testerów za pomocą funkcji --file /path/to/testers.txt.

    Jeśli masz dużą liczbę testerów, możesz użyć grup: Możesz użyć tych usług: appdistribution:group:create i appdistribution:group:delete, aby utworzyć lub usunąć grupy w Firebase w projektach AI.

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

Gdy rozpowszechnisz kompilację, staje się ona dostępna w Panel Rozpowszechniania aplikacji w konsoli Firebase przez 150 dni (5 miesięcy). Jeśli upłynie 30 dni od wygaśnięcia kompilacji, w obu konsolę i listę kompilacji na urządzeniu testowym.

Testerzy, którzy nie zostali zaproszeni do testowania aplikacji, otrzymają e-maile z zaproszeniami a dotychczasowi testerzy otrzymają e-maile z powiadomieniami o nowej kompilacji. jest gotowy do testowania (przeczytaj przewodnik po konfiguracji dla testerów , aby dowiedzieć się, jak zainstalować test ). Możesz sprawdzać stan każdego testera – czy zaakceptował on oraz czy pobrał aplikację w konsoli Firebase.

Testerzy mają 30 dni na zaakceptowanie zaproszenia do testowania aplikacji, zanim wygaśnie. Jeśli zaproszenie wygasa po 5 dniach, w sekcji Konsola Firebase obok testera przy wersji. Zaproszenie można została odnowiona, wysyłając ją ponownie za pomocą menu w wierszu testera.

Dalsze kroki