Dystrybucja wersji pakietów aplikacji do testerów — Codelab

1. Przegląd

W tym laboratorium z programowania dowiesz się, jak rozpowszechniać wersje pakietu Android App Bundle wśród testerów za pomocą Firebase App Distribution i jego wtyczki Gradle. Dystrybucja aplikacji zapewnia centralne centrum zarządzania przedpremierowymi wersjami aplikacji i testerami, których zapraszasz do każdego wydania.

Czego się nauczysz

• Jak połączyć aplikację Firebase z Google Play
• Jak spakować i zbudować swoją aplikację jako pakiet aplikacji
• Jak stworzyć wydanie i udostępnić je testerom na żywo
• Jak pobierać i testować nowe wydania jako tester

Co będziesz potrzebował

• Android Studio v4.0+
• Podpisany plik pakietu wygenerowany z Android Studio
• Konto programisty Google Play, którego jesteś właścicielem lub administratorem
• Twoja aplikacja w Google Play jest skonfigurowana w panelu aplikacji Google Play i ma następujący stan :
  • Aplikacja jest dystrybuowana na 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 kolumna Stan aplikacji wyświetla jeden z następujących stanów: Testy wewnętrzne (nie Wersja robocza testów wewnętrznych), Testy zamknięte, Testy otwarte lub Produkcja.
• Adres e-mail, którego możesz używać jako testera do otrzymywania nowych zaproszeń do kompilacji z Firebase

2. Utwórz projekt Firebase

1. Zaloguj się do Firebase .
2. W konsoli Firebase kliknij Dodaj projekt , a następnie nadaj projektowi nazwę „AppBundlesCodelab”. Zapamiętaj identyfikator projektu dla swojego projektu Firebase. Jeśli nie edytujesz identyfikatora projektu, Firebase automatycznie przypisze unikalny identyfikator do Twojego projektu.
   
   
3. (Opcjonalnie) Po wyświetleniu monitu włącz Google Analytics.
4. Wykonaj pozostałe kroki, a następnie kliknij Utwórz projekt .

Dodaj swój pakiet aplikacji do projektu

1. W konsoli Firebase kliknij Dodaj aplikację .
   
   
2. Podczas rejestrowania aplikacji upewnij się, że używasz tej samej nazwy pakietu , co aplikacja przesłana na Twoje konto programisty Google Play.

   Uwaga: ta sama nazwa pakietu jest wymagana do połączenia aplikacji Firebase z kontem programisty Google Play, co zrobisz w następnej sekcji.

   Na koniec kliknij Zarejestruj aplikację .
3. Wykonaj pozostałe kroki, aby dodać plik konfiguracyjny Firebase swojej aplikacji ( google-services.json ) do swojej aplikacji. Pamiętaj, że w przypadku Androida App Distribution nie ma pakietu SDK Firebase, który można by dodać do Twojej aplikacji.
4. Kliknij Kontynuuj do konsoli .

Link do Google Play

1. W konsoli Firebase przejdź do ustawień projektu .
   
   
2. Na karcie Integracje kliknij Link na karcie Google Play .
3. Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby włączyć integrację App Distribution, a następnie wybierz nowo utworzoną aplikację Firebase, aby połączyć ją z Google Play.

Teraz, gdy wykonasz te czynności, Twoja aplikacja Firebase zostanie połączona z Twoją aplikacją na Twoim koncie programisty Google Play, o ile nazwy pakietów aplikacji będą się zgadzać.

3. Dodaj dystrybucję aplikacji do swojego projektu

Dodaj wtyczkę App Distribution Gradle

Teraz użyjesz Android Studio, aby dodać App Distribution i jego wtyczkę Gradle jako zależności buildscript do swojej aplikacji.

1. W pliku Gradle na poziomie projektu ( android/build.gradle ) dodaj wtyczkę App Distribution Gradle i repozytorium Maven firmy Google.

   buildscript {
       repositories {
           // Check that you have Google's Maven repository (if not, add it).
           google()
           mavenCentral()
       }
       dependencies {
           // Add the App Distribution Gradle plugin
           classpath `com.google.firebase:firebase-appdistribution-gradle:2.1.2`
       }
   }
   

2. W pliku Gradle na poziomie aplikacji ( android/app/build.gradle ) dodaj wtyczkę App Distribution:

   apply plugin: `com.android.application`
   
   // ...
   
   // Apply the App Distribution Gradle plugin
   apply plugin: `com.google.firebase.appdistribution`
   
   // ...
   

3. Jeśli korzystasz z firmowego serwera proxy lub zapory sieciowej, dodaj następującą właściwość systemową Java, która umożliwia aplikacji App Distribution przesyłanie dystrybucji do Firebase:

   -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
   

Uwierzytelnij swój projekt Firebase

Zanim zaczniesz korzystać z wtyczki Gradle, musisz uwierzytelnić swój projekt Firebase. W przypadku tego ćwiczenia z programowania będziesz logować się na swoje konto Google za pomocą działania logowania wtyczki.

1. Uruchom następujące polecenie w katalogu głównym projektu Androida:

   ~/your-android-project$ ./gradlew appDistributionLogin
   

2. Gdy polecenie wydrukuje łącze uwierzytelniające, otwórz je w przeglądarce. Po wyświetleniu monitu zaloguj się na swoje konto Google i przyznaj uprawnienia dostępu do projektu Firebase. Polecenie Gradle drukuje token odświeżania, którego wtyczka App Distribution używa do uwierzytelniania w Firebase.
3. Ustaw zmienną środowiskową FIREBASE_TOKEN na token z poprzedniego kroku:

   ~/your-android-project$ export FIREBASE_TOKEN=your_firebase_token
   

4. Skonfiguruj właściwości swojego pakietu w Android Studio

W tym kroku dodasz siebie jako testera kompilacji, którą rozprowadzisz później. Gdy udostępnisz kompilację, testerzy otrzymają powiadomienia e-mail od Firebase z zaproszeniem do przetestowania nowej kompilacji.

W app/build.gradle dodaj sekcję firebaseAppDistribution i podaj następujące parametry:

• appID : identyfikator aplikacji Firebase w Twojej aplikacji. Możesz go znaleźć w zakładce Ogólne w ustawieniach projektu .
• artifactType : typ pliku Twojej aplikacji ( AAB ).
• testers : adresy e-mail Twoich testerów. Na potrzeby tego ćwiczenia z programowania dodaj własny adres e-mail, aby przetestować kompilację po jej rozpowszechnieniu.

Na przykład:

android {

   // ...

   buildTypes {
       release {
           firebaseAppDistribution {
               appId="yourAppId"
               artifactType="AAB"
               testers="[e-mail], [e-mail]"
           }
       }
   }

// ...
}

Opcjonalnie możesz również zastąpić wartości ustawione w twoim build.gradle , przekazując argumenty wiersza poleceń w postaci -PappDistribution- property-name = property-value .

5. Twórz i rozpowszechniaj wydanie

1. Uruchom zadanie Gradle bundle Variant , aby zbudować plik pakietów aplikacji:

   $ ./gradlew :base:bundleRelease
   

2. Znajdź pakiet w katalogu kompilacji aplikacji (domyślna lokalizacja to app/build/outputs/bundle/release ).
3. Aby rozpowszechniać wydanie, skompiluj docelowe bundleRelease i appDistributionUploadRelease za pomocą opakowania Gradle projektu. Dołącz token Firebase (otrzymany w kroku 3. Dodaj dystrybucję aplikacji do swojej aplikacji).

   export FIREBASE_TOKEN=your_firebase_token
   
   ./gradlew --stop // Only needed for environment variable changes
   
   ./gradlew bundleRelease appDistributionUploadRelease
   

Testerzy będą teraz otrzymywać zaproszenia e-mail do pobrania i przetestowania kompilacji. Jako programista możesz teraz monitorować kompilację na karcie Wydania pulpitu nawigacyjnego App Distribution.

6. Pobierz i przetestuj swoją wersję

W tej sekcji zostaniesz skonfigurowany jako tester, aby pobrać dystrybuowaną wersję. Jako tester musisz uwierzytelnić swoje urządzenie testowe i włączyć wewnętrzne udostępnianie aplikacji w aplikacji Sklep Google Play.

1. Na urządzeniu testowym zaloguj się na konto e-mail testera i otwórz zaproszenie z Firebase.
   
   
2. Zaloguj się na swoje konto Google i zaakceptuj zaproszenie do przetestowania wersji dystrybuowanej. Opcjonalnie możesz też pobrać Firebase App Tester , który zapobiega dodawaniu pobranych wersji do folderu Downloads na urządzeniu. Wyświetla również dodatkowe informacje o wydaniach, takie jak postęp pobierania i wersja wydania.
   
   
3. Stuknij Pobierz w wersji, aby zainstalować ją ze Sklepu Play.
4. Po wyświetleniu monitu wykonaj pozostałe kroki, aby włączyć wewnętrzne udostępnianie aplikacji (instrukcje są wyświetlane na urządzeniu testowym i należy je wykonać tylko raz).

Po zakończeniu pobierania Twoja wersja automatycznie pojawi się jako skrót na ekranie głównym urządzenia.

7. Gratulacje!

Właśnie użyłeś Firebase App Distribution do przesłania pakietu aplikacji i udostępnienia wersji testerom.

Następne kroki

• Przejdź do dokumentacji dystrybucji aplikacji, aby dowiedzieć się więcej o tym, jak zarządzać testerami swojej wersji.
• Zobacz Tworzenie i testowanie pakietu aplikacji na Androida, aby uzyskać informacje o innych narzędziach, których możesz użyć do wdrożenia aplikacji.