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

1. Przegląd

obraz10.png

W tym laboratorium kodowania dowiesz się, jak dystrybuować wersje Android App Bundle do testerów za pomocą Firebase App Distribution i wtyczki Gradle. Dystrybucja aplikacji zapewnia centralne centrum do zarządzania przedpremierowymi wersjami aplikacji i testerami, których zapraszasz do każdej wersji.

Czego się nauczysz

  • Jak połączyć swoją aplikację Firebase z Google Play
  • Jak spakować i zbudować aplikację jako pakiet aplikacji
  • Jak utworzyć wersję i udostępnić ją testerom na żywo
  • Jak pobierać i testować nowe wersje jako tester

Co będziesz potrzebował

  • Najnowsza wersja Android Studio
  • Podpisany plik pakietu wygenerowany w 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 do jednej ze ścieżek Google Play (testy wewnętrzne, testy zamknięte, testy otwarte lub produkcja).
    • Recenzja aplikacji w Google Play została zakończona i aplikacja została opublikowana. Twoja aplikacja jest 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.
  • Adres e-mail, którego możesz użyć jako tester do otrzymywania zaproszeń do nowej kompilacji z Firebase

2. Utwórz projekt Firebase

  1. Zaloguj się do Firebase .
  2. W konsoli Firebase kliknij Dodaj projekt , a następnie nazwij swój projekt „AppBundlesCodelab”. Zapamiętaj identyfikator projektu dla swojego projektu Firebase. Jeśli nie edytujesz identyfikatora projektu, Firebase automatycznie przypisze unikalny identyfikator do Twojego projektu.

    obraz8.png
  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ę .

    obraz5.png
  2. Podczas rejestracji aplikacji upewnij się, że używasz tej samej nazwy pakietu co aplikacja przesłana na Twoje konto programisty Google Play. Na koniec kliknij Zarejestruj aplikację .
  3. Wykonaj pozostałe kroki, aby dodać plik konfiguracyjny Firebase aplikacji ( google-services.json ) do swojej aplikacji. Pamiętaj, że w przypadku Androida aplikacja App Distribution nie ma pakietu Firebase SDK, który można dodać do aplikacji.
  4. Kliknij Kontynuuj, aby przejść do konsoli .
  1. W konsoli Firebase przejdź do ustawień projektu .

    obraz2.png
  2. W zakładce Integracje kliknij Link na karcie Google Play .
  3. Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby włączyć integrację z dystrybucją aplikacji, a następnie wybierz nowo utworzoną aplikację Firebase, aby połączyć ją z Google Play.

Po wykonaniu tych czynności Twoja aplikacja Firebase zostanie połączona z Twoją aplikacją na koncie programisty Google Play, o ile nazwy pakietów aplikacji będą zgodne.

3. Dodaj dystrybucję aplikacji do swojego projektu

Dodaj wtyczkę App Distribution Gradle

Teraz użyjesz Android Studio, aby dodać do swojej aplikacji aplikację App Distribution i jej wtyczkę Gradle.

  1. W pliku Gradle na poziomie projektu ( android/build.gradle.kts ) dodaj wtyczkę App Distribution Gradle do bloku plugins .
    plugins {
     //...

     // Add the App Distribution Gradle plugin
     id("com.google.firebase.appdistribution") version "4.0.0" apply false
}
  2. W pliku Settings Gradle na poziomie projektu ( android/settings.gradle.kts ) dodaj repozytorium Google Maven do bloku pluginManagement .
     pluginManagement {
     // Check that you have Google's Maven repository (if not, add it).
     repositories {
         google()
         mavenCentral()
     }
 }
  3. W pliku Gradle na poziomie aplikacji ( android/app/build.gradle.kts ) dodaj wtyczkę App Distribution do bloku plugins .
    plugins {
     //...

     // Add the App Distribution plugin
     id("com.google.firebase.appdistribution")
}
  4. Jeśli korzystasz z firmowego serwera proxy lub zapory sieciowej, dodaj następującą właściwość systemu Java, która umożliwia usłudze 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 będziesz mógł użyć wtyczki Gradle, musisz uwierzytelnić swój projekt Firebase. W tym laboratorium kodowania zalogujesz się na swoje konto Google za pomocą Firebase CLI .

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

~/your-android-project$ firebase login

Dokumentacja referencyjna zawiera więcej szczegółów.

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

W tym kroku dodasz siebie jako testera kompilacji, którą będziesz dystrybuować później. Po rozpowszechnieniu kompilacji testerzy otrzymują powiadomienia e-mail z Firebase z zaproszeniem do przetestowania nowej kompilacji.

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

  • appID : Identyfikator aplikacji Firebase Twojej aplikacji. Możesz go znaleźć na karcie Ogólne w ustawieniach projektu .
  • artifactType : Typ pliku Twojej aplikacji ( AAB ).
  • testers : adresy e-mail Twoich testerów. Na potrzeby tego laboratorium kodowania dodaj własny adres e-mail, aby móc przetestować swoją kompilację po jej rozpowszechnieniu.

Na przykład:

    android {

       // ...

       buildTypes {
            getByName("release") {
                firebaseAppDistribution {
                  appId = "yourAppId"
                  artifactType = "AAB"
                  testers = "ali@example.com, bri@example.com, cal@example.com"
                }
            }
        }

        // ...
    }

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

5. Zbuduj i rozpowszechnij wydanie

  1. Uruchom zadanie bundle Variant Gradle, aby utworzyć plik pakunków aplikacji:
    $ ./gradlew :base:bundleRelease
  2. Zlokalizuj pakiet w katalogu kompilacji aplikacji (domyślna lokalizacja to app/build/outputs/bundle/release ).
  3. Aby rozpowszechnić wydanie, zbuduj cele bundleRelease i appDistributionUploadRelease za pomocą opakowania Gradle projektu. Dołącz token Firebase (ten, który otrzymałeś 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ć e-maile z zaproszeniami do pobrania i przetestowania kompilacji. Jako programista możesz teraz monitorować kompilację na karcie Wersje pulpitu nawigacyjnego Dystrybucja aplikacji.

6. Pobierz i przetestuj swoją wersję

W tej sekcji zostaniesz skonfigurowany jako tester w celu pobrania dystrybuowanej wersji. 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.

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

    obraz9.png
  3. Stuknij Pobierz w wydaniu, aby zainstalować je 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 wystarczy je wykonać tylko raz).

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

7. Gratulacje!

Właśnie użyłeś Dystrybucji aplikacji Firebase, aby przesłać pakiet aplikacji i rozesłać wersję do testerów.

Następne kroki