Dystrybuuj wersje pakietów aplikacji wśród testerów — Codelab

1. Przegląd

obraz10.png

Podczas tych zajęć z programowania dowiesz się, jak rozpowszechniać wersje pakietu Android App Bundle wśród testerów za pomocą Firebase App Distribution i wtyczki Gradle. App Distribution zapewnia centralne centrum zarządzania przedpremierowymi wersjami aplikacji i testerami zapraszanymi do poszczególnych wersji.

Czego się dowiesz

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

Co będziesz potrzebował

  • Najnowsza wersja Androida 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 rozpowszechniana w 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.
  • Adres e-mail, którego możesz używać jako testera, aby otrzymywać zaproszenia do nowych 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.

    image8.png
  3. (Opcjonalnie) Po wyświetleniu monitu włącz Google Analytics.
  4. Wykonaj pozostałe kroki, a następnie kliknij Utwórz projekt .

Dodaj pakiet aplikacji do projektu

  1. W konsoli Firebase kliknij Dodaj aplikację .

    obraz5.png
  2. Rejestrując aplikację, pamiętaj, aby użyć tej samej nazwy pakietu , co nazwa aplikacji przesłanej na Twoje konto programisty w Google Play. Na koniec kliknij Zarejestruj aplikację .
  3. Wykonaj pozostałe kroki, aby dodać do aplikacji plik konfiguracyjny Firebase ( google-services.json ). Pamiętaj, że w przypadku systemu Android usługa App Distribution nie oferuje pakietu SDK Firebase, który można dodać do aplikacji.
  4. Kliknij Kontynuuj, aby skorzystać z 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 kroków Twoja aplikacja Firebase zostanie połączona z aplikacją na Twoim koncie programisty Google Play, o ile nazwy pakietów aplikacji będą zgodne.

3. Dodaj dystrybucję aplikacji do swojego projektu

Dodaj wtyczkę Gradle dystrybucji aplikacji

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

  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 Gradle ustawień 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 korporacyjnego serwera proxy lub zapory sieciowej, dodaj następującą właściwość systemu Java, która umożliwia App Distribution przesyłanie Twoich 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ł korzystać z wtyczki Gradle, musisz uwierzytelnić swój projekt Firebase. Na potrzeby tych zajęć z programowania zalogujesz się na swoje konto Google przy użyciu interfejsu wiersza polecenia Firebase .

Uruchom następujące polecenie w katalogu głównym 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 otrzymają powiadomienia e-mail z Firebase zapraszające ich 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. Znajdziesz go w zakładce Ogólne w ustawieniach projektu .
  • artifactType : typ pliku aplikacji ( AAB ).
  • testers : adresy e-mail Twoich testerów. Na potrzeby tych zajęć z programowania dodaj własny adres e-mail, aby móc przetestować kompilację po jej dystrybucji.

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 także 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 Gradle bundle Variant , aby utworzyć 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 rozpowszechnić wydanie, zbuduj pakiety docelowe bundleRelease i appDistributionUploadRelease za pomocą opakowania Gradle swojego 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 w panelu dystrybucji aplikacji.

6. Pobierz i przetestuj swoją wersję

W tej sekcji zostaniesz skonfigurowany jako tester, aby pobrać rozpowszechnianą przez siebie 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.

    obraz6.png
  2. Zaloguj się na swoje konto Google i zaakceptuj zaproszenie do testowania wersji rozproszonej. Opcjonalnie możesz także pobrać Firebase App Tester , który zapobiega dodawaniu pobranych wydań do folderu Downloads na Twoim urządzeniu. Wyświetla także dodatkowe informacje o wydaniach, takie jak postęp pobierania i wersja wydania.

    obraz9.png
  3. Stuknij opcję 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 zostaną wyświetlone na urządzeniu testowym i wystarczy je wykonać tylko raz).

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

7. Gratulacje!

Właśnie użyłeś Firebase App Distribution, aby przesłać pakiet aplikacji i udostępnić wersję testerom.

Następne kroki