1. Przegląd
W tym laboratorium z programowania dowiesz się, jak rozpowszechniać wersje pakietu Android App Bundle wśród testerów za pomocą Firebase App Distribution i jego wtyczki Gradle. Dystrybucja aplikacji zapewnia centralne centrum zarządzania przedpremierowymi wersjami aplikacji i testerami, których zapraszasz do każdego wydania.
Czego się nauczysz
- Jak połączyć aplikację Firebase z Google Play
- Jak spakować i zbudować swoją aplikację jako pakiet aplikacji
- Jak stworzyć wydanie i udostępnić je testerom na żywo
- Jak pobierać i testować nowe wydania jako tester
Co będziesz potrzebował
- Android Studio v4.0+
- Podpisany plik pakietu wygenerowany z 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 na jednej ze ścieżek Google Play (testy wewnętrzne, testy zamknięte, testy otwarte lub produkcja).
- Przegląd aplikacji w Google Play został zakończony i aplikacja została opublikowana. Twoja aplikacja zostanie opublikowana, jeśli kolumna Stan aplikacji wyświetla 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 do otrzymywania nowych zaproszeń do kompilacji z Firebase
2. Utwórz projekt Firebase
- Zaloguj się do Firebase .
- W konsoli Firebase kliknij Dodaj projekt , a następnie nadaj projektowi nazwę „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 swój pakiet aplikacji do projektu
- W konsoli Firebase kliknij Dodaj aplikację .
- Podczas rejestrowania 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ę .
- Wykonaj pozostałe kroki, aby dodać plik konfiguracyjny Firebase swojej aplikacji (
google-services.json
) do swojej aplikacji. Pamiętaj, że w przypadku Androida App Distribution nie ma pakietu SDK Firebase, który można by dodać do Twojej aplikacji. - Kliknij Kontynuuj do konsoli .
Link do Google Play
- W konsoli Firebase przejdź do ustawień projektu .
- Na karcie Integracje kliknij Link na karcie Google Play .
- Postępuj zgodnie z instrukcjami wyświetlanymi na ekranie, aby włączyć integrację App Distribution, a następnie wybierz nowo utworzoną aplikację Firebase, aby połączyć ją z Google Play.
Teraz, gdy wykonasz te czynności, Twoja aplikacja Firebase zostanie połączona z Twoją aplikacją na Twoim koncie programisty Google Play, o ile nazwy pakietów aplikacji będą się zgadzać.
3. Dodaj dystrybucję aplikacji do swojego projektu
Dodaj wtyczkę App Distribution Gradle
Teraz użyjesz Android Studio, aby dodać App Distribution i jego wtyczkę Gradle jako zależności buildscript do swojej aplikacji.
- W pliku Gradle na poziomie projektu (
android/build.gradle
) dodaj wtyczkę App Distribution Gradle i repozytorium Maven firmy Google.buildscript { repositories { // Check that you have Google's Maven repository (if not, add it). google() mavenCentral() } dependencies { // Add the App Distribution Gradle plugin classpath `com.google.firebase:firebase-appdistribution-gradle:2.1.2` } }
- W pliku Gradle na poziomie aplikacji (
android/app/build.gradle
) dodaj wtyczkę App Distribution:apply plugin: `com.android.application` // ... // Apply the App Distribution Gradle plugin apply plugin: `com.google.firebase.appdistribution` // ...
- Jeśli korzystasz z firmowego serwera proxy lub zapory sieciowej, dodaj następującą właściwość systemową Java, która umożliwia aplikacji 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 zaczniesz korzystać z wtyczki Gradle, musisz uwierzytelnić swój projekt Firebase. W przypadku tego ćwiczenia z programowania będziesz logować się na swoje konto Google za pomocą działania logowania wtyczki.
- Uruchom następujące polecenie w katalogu głównym projektu Androida:
~/your-android-project$ ./gradlew appDistributionLogin
- Gdy polecenie wydrukuje łącze uwierzytelniające, otwórz je w przeglądarce. Po wyświetleniu monitu zaloguj się na swoje konto Google i przyznaj uprawnienia dostępu do projektu Firebase. Polecenie Gradle drukuje token odświeżania, którego wtyczka App Distribution używa do uwierzytelniania w Firebase.
- Ustaw zmienną środowiskową
FIREBASE_TOKEN
na token z poprzedniego kroku:~/your-android-project$ export FIREBASE_TOKEN=your_firebase_token
4. Skonfiguruj właściwości swojego pakietu w Android Studio
W tym kroku dodasz siebie jako testera kompilacji, którą rozprowadzisz później. Gdy udostępnisz kompilację, testerzy otrzymają powiadomienia e-mail od Firebase z zaproszeniem do przetestowania nowej kompilacji.
W app/build.gradle
dodaj sekcję firebaseAppDistribution
i podaj następujące parametry:
-
appID
: identyfikator aplikacji Firebase w Twojej aplikacji. Możesz go znaleźć w zakładce Ogólne w ustawieniach projektu . -
artifactType
: typ pliku Twojej aplikacji (AAB
). -
testers
: adresy e-mail Twoich testerów. Na potrzeby tego ćwiczenia z programowania dodaj własny adres e-mail, aby przetestować kompilację po jej rozpowszechnieniu.
Na przykład:
android {
// ...
buildTypes {
release {
firebaseAppDistribution {
appId="yourAppId"
artifactType="AAB"
testers="your@exampleemail.com, cerseimartell.772371@email.com"
}
}
}
// ...
}
Opcjonalnie możesz również zastąpić wartości ustawione w twoim build.gradle
, przekazując argumenty wiersza poleceń w postaci -PappDistribution- property-name = property-value
.
5. Twórz i rozpowszechniaj wydanie
- Uruchom zadanie Gradle
bundle Variant
, aby zbudować plik pakietów aplikacji:$ ./gradlew :base:bundleRelease
- Znajdź pakiet w katalogu kompilacji aplikacji (domyślna lokalizacja to
app/build/outputs/bundle/release
). - Aby rozpowszechniać wydanie, skompiluj docelowe
bundleRelease
iappDistributionUploadRelease
za pomocą opakowania Gradle projektu. Dołącz token Firebase (otrzymany 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ć zaproszenia e-mail do pobrania i przetestowania kompilacji. Jako programista możesz teraz monitorować kompilację na karcie Wydania pulpitu nawigacyjnego App Distribution.
6. Pobierz i przetestuj swoją wersję
W tej sekcji zostaniesz skonfigurowany jako tester, aby pobrać dystrybuowaną 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 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. - Stuknij 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 są wyświetlane na urządzeniu testowym i należy je wykonać tylko raz).
Po zakończeniu pobierania Twoja wersja automatycznie pojawi się jako skrót na ekranie głównym urządzenia.
7. Gratulacje!
Właśnie użyłeś Firebase App Distribution do przesłania pakietu aplikacji i udostępnienia wersji testerom.
Następne kroki
- Przejdź do dokumentacji dystrybucji aplikacji, aby dowiedzieć się więcej o tym, jak zarządzać 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.