Rozpowszechnianie wersji pakietów aplikacji testerom – ćwiczenia z programowania

1. Omówienie

obraz10.png

Z tego ćwiczenia w Codelabs dowiesz się, jak rozpowszechniać wersje pakietu Android App Bundle testerom za pomocą usługi Rozpowszechniania aplikacji przez Firebase i wtyczki do Gradle. Rozpowszechnianie aplikacji to centralne miejsce, w którym możesz zarządzać przedpremierowymi wersjami aplikacji i testerami zaproszonymi do korzystania z każdej wersji.

Czego się nauczysz

  • Jak połączyć aplikację Firebase z Google Play
  • Jak spakować i utworzyć aplikację w formie pakietu aplikacji
  • Jak utworzyć wersję i udostępnić ją testerom wersji opublikowanej
  • Jak pobierać i testować nowe wersje jako tester

Czego potrzebujesz

  • Najnowsza wersja Android Studio
  • podpisany plik pakietu wygenerowany w Android Studio.
  • konto dewelopera w Google Play, którego jesteś właścicielem lub administratorem;
  • Aplikacja w Google Play jest skonfigurowana w panelu aplikacji Google Play i ma ten stan:
    • Aplikacja jest rozpowszechniana na jednej ze ścieżek Google Play (test wewnętrzny, test zamknięty, test otwarty lub produkcja).
    • 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 tych stanów: Test wewnętrzny (nie wersja robocza testu wewnętrznego), Test zamknięty, Test otwarty lub Produkcyjna.
  • Adres e-mail, którego możesz używać jako testera do otrzymywania z Firebase nowych zaproszeń do tworzenia kompilacji

2. Tworzenie projektu Firebase

  1. Zaloguj się w Firebase.
  2. W konsoli Firebase kliknij Dodaj projekt i nazwij projekt „AppBundlesCodelab”. Zapamiętaj identyfikator projektu Firebase. Jeśli nie zmienisz identyfikatora projektu, Firebase automatycznie przypisze Twojemu projektowi unikalny identyfikator.

    obraz8.png
  3. (Opcjonalnie) Gdy pojawi się odpowiedni komunikat, włącz Google Analytics.
  4. Wykonaj pozostałe kroki i kliknij Utwórz projekt.

Dodaj pakiet aplikacji do projektu

  1. W konsoli Firebase kliknij Dodaj aplikację.

    obraz5.png
  2. Podczas rejestracji aplikacji użyj tej samej nazwy pakietu co w przypadku aplikacji przesłanej na konto dewelopera w Google Play.. Na koniec kliknij Zarejestruj aplikację.
  3. Wykonaj pozostałe kroki, aby dodać do aplikacji plik konfiguracji Firebase (google-services.json). Pamiętaj, że w przypadku aplikacji na Androida usługa App Distribution nie ma pakietu SDK Firebase, który można dodać do aplikacji.
  4. Kliknij Przejdź do konsoli.
  1. W konsoli Firebase otwórz Ustawienia projektu.

    obraz2.png
  2. Na karcie Integracje kliknij Połącz na karcie Google Play.
  3. Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby włączyć integrację z Rozpowszechnianiem aplikacji, a następnie wybierz nowo utworzoną aplikację Firebase, którą chcesz połączyć z Google Play.

Po wykonaniu tych czynności Twoja aplikacja Firebase będzie połączona z Twoją aplikacją na koncie dewelopera w Google Play, dopóki aplikacje jednakowe nazwy pakietów.

3. Dodaj Rozpowszechnianie aplikacji do swojego projektu

Dodaj wtyczkę do Gradle w App Distribution

Teraz musisz użyć Android Studio, aby dodać do swojej aplikacji Rozpowszechnianie aplikacji i jej wtyczkę do Gradle.

  1. W pliku Gradle na poziomie projektu (android/build.gradle.kts) dodaj wtyczkę do Gradle dystrybucji aplikacji 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ę Rozpowszechniania aplikacji 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 poniższą właściwość systemową w Javie, która umożliwia Rozpowszechnianiu aplikacji do przesyłania dystrybucji do Firebase:
    -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password

Uwierzytelnij swój projekt Firebase

Zanim użyjesz wtyczki do Gradle, musisz uwierzytelnić swój projekt Firebase. W tym ćwiczeniu w Codelabs zalogujesz się na konto Google za pomocą interfejsu wiersza poleceń Firebase.

Uruchom to polecenie w katalogu głównym projektu na Androida:

~/your-android-project$ firebase login

Więcej informacji znajdziesz w dokumentacji referencyjnej.

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

W tym kroku dodasz siebie jako testera kompilacji, którą będziesz później rozpowszechniać. Gdy rozpowszechnisz kompilację, testerzy otrzymają e-maile z powiadomieniami od Firebase z zaproszeniem do przetestowania nowej kompilacji.

W narzędziu app/build.gradle.kts dodaj sekcję firebaseAppDistribution i podaj te parametry:

  • appID: identyfikator aplikacji Firebase. Znajdziesz go na karcie Ogólne w ustawieniach projektu.
  • artifactType: typ pliku aplikacji (AAB).
  • testers: testerzy adresy e-mail. Na potrzeby tego ćwiczenia w programowaniu dodaj własny adres e-mail, aby móc przetestować kompilację po jej opublikowaniu.

Przykład:

    android {

       // ...

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

        // ...
    }

Możesz też zastąpić wartości ustawione w narzędziu build.gradle.kts, przekazując argumenty wiersza poleceń w formacie -PappDistribution-property-name=property-value.

5. Tworzenie i rozpowszechnianie wersji

  1. Uruchom zadanie Gradle bundleVariant, 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 rozpowszechniać wersję, utwórz środowiska docelowe bundleRelease i appDistributionUploadRelease za pomocą otoki Gradle swojego projektu. Dołącz token Firebase (ten otrzymany w kroku 3. Dodaj do swojej aplikacji Rozpowszechnianie aplikacji).
    export FIREBASE_TOKEN=your_firebase_token

./gradlew --stop // Only needed for environment variable changes

./gradlew bundleRelease appDistributionUploadRelease

Testerzy otrzymają e-maile z zaproszeniami do pobrania i przetestowania kompilacji. Jako deweloper możesz teraz monitorować kompilację na karcie Wersje w panelu Rozpowszechniania aplikacji.

6. Pobieranie i testowanie wersji

W tej sekcji skonfigurujesz się jako tester, aby pobrać dystrybuowaną wersję. Jako tester musisz uwierzytelnić 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
  2. Zaloguj się na konto Google i zaakceptuj zaproszenie do przetestowania dystrybuowanej wersji. Możesz też pobrać aplikację Firebase App Tester, która uniemożliwia dodawanie pobranych wersji do folderu Downloads na urządzeniu. Zawiera również dodatkowe informacje o wersjach, takie jak postęp pobierania i wersja.

    obraz9.png
  3. Kliknij Pobierz w danej wersji, aby zainstalować ją ze Sklepu Play.
  4. Gdy pojawi się prośba, wykonaj pozostałe czynności, aby włączyć wewnętrzne udostępnianie aplikacji (instrukcje są wyświetlane na urządzeniu testowym i trzeba je wykonać tylko raz).

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

7. Gratulacje!

Udało Ci się właśnie użyć Rozpowszechniania aplikacji przez Firebase, aby przesłać pakiet aplikacji i rozpowszechnić wersję testerom.

Dalsze kroki