1. Przegląd
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
- Zaloguj się do Firebase .
- 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.
- (Opcjonalnie) Po wyświetleniu monitu włącz Google Analytics.
- Wykonaj pozostałe kroki, a następnie kliknij Utwórz projekt .
Dodaj pakiet aplikacji do projektu
- W konsoli Firebase kliknij Dodaj aplikację .
- 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ę .
- 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. - Kliknij Kontynuuj, aby skorzystać z konsoli .
Link do Google Play
- W konsoli Firebase przejdź do ustawień projektu .
- W zakładce Integracje kliknij Link na karcie Google Play .
- 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.
- W pliku Gradle na poziomie projektu (
android/build.gradle.kts
) dodaj wtyczkę App Distribution Gradle 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ę App Distribution do blokuplugins
.plugins { //... // Add the App Distribution plugin id("com.google.firebase.appdistribution") }
- 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
- Uruchom zadanie Gradle
bundle Variant
, 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 rozpowszechnić wydanie, zbuduj pakiety docelowe
bundleRelease
iappDistributionUploadRelease
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.
- Na urządzeniu testowym zaloguj się na konto e-mail testera i otwórz zaproszenie z Firebase.
- 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. - Stuknij opcję Pobierz w wersji, aby zainstalować ją ze Sklepu Play.
- 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
- Przejdź do dokumentacji aplikacji App Distribution, aby dowiedzieć się więcej o zarządzaniu 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.