1. Omówienie
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
- Zaloguj się w Firebase.
- 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.
- (Opcjonalnie) Gdy pojawi się odpowiedni komunikat, włącz Google Analytics.
- Wykonaj pozostałe kroki i kliknij Utwórz projekt.
Dodaj pakiet aplikacji do projektu
- W konsoli Firebase kliknij Dodaj aplikację.
- 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ę.
- 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. - Kliknij Przejdź do konsoli.
Połącz z Google Play
- W konsoli Firebase otwórz Ustawienia projektu.
- Na karcie Integracje kliknij Połącz na karcie Google Play.
- 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.
- W pliku Gradle na poziomie projektu (
android/build.gradle.kts) dodaj wtyczkę do Gradle dystrybucji aplikacji do blokuplugins.plugins { //... // Add the App Distribution Gradle plugin id("com.google.firebase.appdistribution") version "4.0.0" apply false } - W pliku Gradle ustawień na poziomie projektu (
android/settings.gradle.kts) dodaj repozytorium Google Maven do blokupluginManagement.pluginManagement { // Check that you have Google's Maven repository (if not, add it). repositories { google() mavenCentral() } } - W pliku Gradle na poziomie aplikacji (
android/app/build.gradle.kts) dodaj wtyczkę Rozpowszechniania aplikacji do blokuplugins.plugins { //... // Add the App Distribution plugin id("com.google.firebase.appdistribution") } - 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
- Uruchom zadanie Gradle
bundleVariant, aby utworzyć plik pakietów aplikacji:$ ./gradlew :base:bundleRelease - Znajdź pakiet w katalogu kompilacji aplikacji (domyślna lokalizacja to
app/build/outputs/bundle/release). - Aby rozpowszechniać wersję, utwórz środowiska docelowe
bundleReleaseiappDistributionUploadReleaseza 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.
- Na urządzeniu testowym zaloguj się na konto e-mail testera i otwórz zaproszenie z Firebase.
- 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
Downloadsna urządzeniu. Zawiera również dodatkowe informacje o wersjach, takie jak postęp pobierania i wersja.
- Kliknij Pobierz w danej wersji, aby zainstalować ją ze Sklepu Play.
- 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
- Więcej informacji o zarządzaniu testerami wersji znajdziesz w dokumentacji Rozpowszechniania aplikacji.
- Informacje o innych narzędziach, których możesz używać do wdrażania aplikacji, znajdziesz w artykule Tworzenie i testowanie pakietu Android App Bundle.