Możesz zintegrować dystrybucję aplikacji z procesem kompilacji systemu Android za pomocą wtyczki App Distribution Gradle. Wtyczka umożliwia określenie testerów i informacji o wersji w pliku Gradle aplikacji, co pozwala skonfigurować dystrybucje dla różnych typów kompilacji i wariantów aplikacji.
W tym przewodniku opisano, jak dystrybuować pliki APK wśród testerów za pomocą wtyczki App Distribution Gradle.
Zanim zaczniesz
Jeśli jeszcze tego nie zrobiłeś, dodaj Firebase do swojego projektu na Androida .
Jeśli nie korzystasz z innych produktów Firebase, wystarczy, że utworzysz projekt i zarejestrujesz swoją aplikację. Jeśli jednak w przyszłości zdecydujesz się skorzystać z dodatkowych produktów, pamiętaj o wykonaniu wszystkich kroków opisanych na stronie, do której link znajduje się powyżej.
Krok 1. Skonfiguruj swój projekt na Androida
W pliku Gradle na poziomie głównym (na poziomie projektu) (
<project>/build.gradle.kts
lub<project>/build.gradle
) dodaj wtyczkę App Distribution Gradle jako zależność:Kotlin
plugins { // ... id("com.android.application") version "7.3.0" apply false // Make sure that you have the Google services Gradle plugin dependency id("com.google.gms.google-services") version "4.4.0" apply false // Add the dependency for the App Distribution Gradle plugin id("com.google.firebase.appdistribution") version "4.0.1" apply false }
Groovy
plugins { // ... id 'com.android.application' version '7.3.0' apply false // Make sure that you have the Google services Gradle plugin dependency id 'com.google.gms.google-services' version '4.4.0' apply false // Add the dependency for the App Distribution Gradle plugin id 'com.google.firebase.appdistribution' version '4.0.1' apply false }
W pliku Gradle modułu (na poziomie aplikacji) (zwykle
<project>/<app-module>/build.gradle.kts
lub<project>/<app-module>/build.gradle
) dodaj wtyczkę App Distribution Gradle:Kotlin
plugins { id("com.android.application") // Make sure that you have the Google services Gradle plugin id("com.google.gms.google-services") // Add the App Distribution Gradle plugin id("com.google.firebase.appdistribution") }
Groovy
plugins { id 'com.android.application' // Make sure that you have the Google services Gradle plugin id 'com.google.gms.google-services' // Add the App Distribution Gradle 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
Krok 2. Uwierzytelnij się w Firebase
Zanim będziesz mógł korzystać z wtyczki Gradle, musisz najpierw uwierzytelnić się w projekcie Firebase na jeden z poniższych sposobów. Domyślnie wtyczka Gradle szuka poświadczeń w interfejsie CLI Firebase, jeśli nie jest używana żadna inna metoda uwierzytelniania.
Uwierzytelnienie za pomocą konta usługi pozwala na elastyczne korzystanie z wtyczki z systemem ciągłej integracji (CI). Dane uwierzytelniające konto usługi można podać na dwa sposoby:
- Przekaż plik klucza konta usługi do
build.gradle
. Ta metoda może okazać się wygodna, jeśli masz już plik klucza konta usługi w środowisku kompilacji. - Ustaw zmienną środowiskową
GOOGLE_APPLICATION_CREDENTIALS
tak, aby wskazywała plik kluczy konta usługi. Możesz preferować tę metodę, jeśli masz już skonfigurowane domyślne poświadczenia aplikacji (ADC) dla innej usługi Google (np. Google Cloud).
Aby uwierzytelnić się przy użyciu poświadczeń konta usługi:
- W Google Cloud Console wybierz swój projekt i utwórz nowe konto usługi.
- Dodaj rolę administratora dystrybucji aplikacji Firebase .
- Utwórz prywatny klucz JSON i przenieś klucz do lokalizacji dostępnej dla Twojego środowiska kompilacji. Pamiętaj, aby przechowywać ten plik w bezpiecznym miejscu , ponieważ zapewnia on administratorowi dostęp do dystrybucji aplikacji w Twoim projekcie Firebase.
- Pomiń ten krok, jeśli aplikację utworzyłeś po 20 września 2019 r.: W konsoli Google API włącz interfejs Firebase App Distribution API. Po wyświetleniu monitu wybierz projekt o tej samej nazwie, co projekt Firebase.
Podaj lub znajdź dane logowania do swojego konta usługi:
- Aby przekazać Gradle klucz konta usługi, w pliku
build.gradle
ustaw właściwośćserviceCredentialsFile
na plik JSON klucza prywatnego. Aby zlokalizować swoje dane uwierzytelniające w ADC, ustaw zmienną środowiskową
GOOGLE_APPLICATION_CREDENTIALS
na ścieżkę do pliku JSON klucza prywatnego. Na przykład:export GOOGLE_APPLICATION_CREDENTIALS=/absolute/path/to/credentials/file.json
Aby uzyskać więcej informacji na temat uwierzytelniania za pomocą usługi ADC, zobacz Podawanie poświadczeń do aplikacji.
- Aby przekazać Gradle klucz konta usługi, w pliku
Aby uzyskać instrukcje dotyczące uwierzytelniania projektu, zobacz Logowanie przy użyciu interfejsu wiersza polecenia Firebase .
Krok 3. Skonfiguruj właściwości dystrybucji
W pliku Gradle modułu (na poziomie aplikacji) (zwykle <project>/<app-module>/build.gradle.kts
lub <project>/<app-module>/build.gradle
) skonfiguruj dystrybucję aplikacji, dodając co najmniej jedna sekcja firebaseAppDistribution
.
Na przykład, aby udostępnić release
testerom, postępuj zgodnie z poniższymi instrukcjami:
Kotlin
import com.google.firebase.appdistribution.gradle.firebaseAppDistribution android { // ... buildTypes { getByName("release") { firebaseAppDistribution { artifactType = "APK" releaseNotesFile = "/path/to/releasenotes.txt" testers = "ali@example.com, bri@example.com, cal@example.com" } } } // ... }
Groovy
android { // ... buildTypes { release { firebaseAppDistribution { artifactType="APK" releaseNotesFile="/path/to/releasenotes.txt" testers="ali@example.com, bri@example.com, cal@example.com" } } } // ... }
Możesz skonfigurować dystrybucję aplikacji pod kątem typów kompilacji i wersji produktów .
Na przykład, aby dystrybuować kompilacje debug
i release
w wersji „demo” i „pełnej”, postępuj zgodnie z poniższymi instrukcjami:
Kotlin
import com.google.firebase.appdistribution.gradle.firebaseAppDistribution android { // ... buildTypes { getByName("debug") {...} getByName("release") {...} } flavorDimensions += "version" productFlavors { create("demo") { dimension = "version" firebaseAppDistribution { releaseNotes = "Release notes for demo version" testers = "demo@testers.com" } } create("full") { dimension = "version" firebaseAppDistribution { releaseNotes = "Release notes for full version" testers = "full@testers.com" } } } // ... }
Groovy
android { // ... buildTypes { debug {...} release {...} } flavorDimensions "version" productFlavors { demo { dimension "version" firebaseAppDistribution { releaseNotes="Release notes for demo version" testers="demo@testers.com" } } full { dimension "version" firebaseAppDistribution { releaseNotes="Release notes for full version" testers="full@testers.com" } } } // ... }
Aby skonfigurować dystrybucję, użyj następujących parametrów:
Parametry kompilacji dystrybucji aplikacji | |
---|---|
appId | Identyfikator aplikacji Firebase Twojej aplikacji. Wymagane tylko wtedy, gdy nie masz zainstalowanej wtyczki Google Services Gradle. Identyfikator aplikacji znajdziesz w pliku appId="1:1234567890:android:321abc456def7890" |
serviceCredentialsFile | Ścieżka do pliku JSON klucza prywatnego konta usługi. Wymagane tylko w przypadku korzystania z uwierzytelniania konta usługi. |
artifactType | Określa typ pliku aplikacji. Można ustawić na |
artifactPath | Ścieżka bezwzględna do pliku APK lub AAB, który chcesz przesłać. |
releaseNotes lub releaseNotesFile | Informacje o wersji dla tej kompilacji. Możesz bezpośrednio określić informacje o wydaniu lub ścieżkę do zwykłego pliku tekstowego. |
testers lub testersFile | Adresy e-mail testerów, którym chcesz dystrybuować kompilacje. Możesz określić testerów jako listę adresów e-mail rozdzielonych przecinkami: testers="ali@example.com, bri@example.com, cal@example.com" Możesz też określić ścieżkę do pliku zawierającego listę adresów e-mail rozdzielonych przecinkami: testersFile="/path/to/testers.txt" |
groups lub groupsFile | Grupy testerów, do których chcesz dystrybuować kompilacje (zobacz Zarządzanie testerami ). Grupy są określane przy użyciu Grupy można określić w formie listy aliasów grup oddzielonych przecinkami: groups="qa-team, android-testers" Możesz też określić ścieżkę do pliku zawierającego listę aliasów grup rozdzielanych przecinkami: groupsFile="/path/to/tester-groups.txt" |
stacktrace | Drukuje ślad stosu dla wyjątków użytkownika. Jest to pomocne podczas debugowania problemów. |
Krok 4. Udostępnij swoją aplikację testerom
Na koniec, aby spakować aplikację testową i zaprosić testerów, zbuduj elementy docelowe
BUILD-VARIANT
iappDistributionUpload BUILD-VARIANT
za pomocą opakowania Gradle projektu, gdzie BUILD-VARIANT to opcjonalny smak produktu i typ kompilacji skonfigurowany w poprzednim kroku. Aby uzyskać więcej informacji na temat wersji produktów, zobacz Konfigurowanie wariantów kompilacji .Na przykład, aby dystrybuować aplikację przy użyciu wersji kompilacji
release
, uruchom następujące polecenie:./gradlew assembleRelease appDistributionUploadRelease
Lub, jeśli uwierzytelniłeś się za pomocą konta Google i nie podałeś danych uwierzytelniających w pliku kompilacji Gradle, dołącz zmienną
FIREBASE_TOKEN
:export FIREBASE_TOKEN=1/a1b2c3d4e5f67890 ./gradlew --stop // Only needed for environment variable changes ./gradlew assembleRelease appDistributionUploadRelease
Możesz także zastąpić wartości ustawione w pliku
build.gradle
, przekazując argumenty wiersza poleceń w postaci--<property-name>=<property-value>
. Na przykład:Aby przesłać kompilację debugowania do App Distribution:
./gradlew bundleDebug appDistributionUploadDebug --artifactType="APK"
Aby zaprosić dodatkowych testerów lub usunąć istniejących testerów z projektu Firebase:
./gradlew appDistributionAddTesters --projectNumber=<project_number> --emails="anothertester@email.com, moretesters@email.com"
./gradlew appDistributionRemoveTesters --projectNumber=<project_number> --emails="anothertester@email.com, moretesters@email.com"
Po dodaniu testera do projektu Firebase możesz dodać go do poszczególnych wersji. Usunięci testerzy nie będą już mieli dostępu do wydań w Twoim projekcie, ale nadal będą mogli zachować do nich dostęp przez pewien czas.
Możesz także określić testerów, używając
--file="/path/to/testers.txt"
zamiast--emails
.Zadania
appDistributionAddTesters
iappDistributionRemoveTesters
akceptują również następujące argumenty:projectNumber
: numer Twojego projektu Firebase.serviceCredentialsFile
: Ścieżka do pliku danych uwierzytelniających usługi Google. Jest to ten sam argument, którego używa akcja przesyłania.
Wtyczka Gradle wyświetla następujące linki po przesłaniu wersji. Te linki pomogą Ci zarządzać plikami binarnymi i zapewnić testerom i innym programistom właściwą wersję:
-
firebase_console_uri
— łącze do konsoli Firebase wyświetlające pojedynczą wersję. Możesz udostępnić ten link innym programistom w swojej organizacji. -
testing_uri
— link do wersji w środowisku testera (natywna aplikacja na Androida), który umożliwia testerom przeglądanie informacji o wersji i instalowanie aplikacji na swoim urządzeniu. Tester musi mieć dostęp do wydania, aby móc skorzystać z linku. -
binary_download_uri
— podpisany link, który bezpośrednio pobiera i instaluje plik binarny aplikacji (plik APK lub AAB). Link wygasa po godzinie.
Po rozpowszechnieniu kompilacji staje się ona dostępna w panelu dystrybucji aplikacji w konsoli Firebase przez 150 dni (pięć miesięcy). Gdy do wygaśnięcia kompilacji zostanie 30 dni, powiadomienie o wygaśnięciu pojawi się zarówno w konsoli, jak i na liście kompilacji testera na jego urządzeniu testowym.
Testerzy, którzy nie zostali zaproszeni do testowania aplikacji, otrzymują e-mail z zaproszeniami do rozpoczęcia, a obecni testerzy otrzymują powiadomienia e-mailem, że nowa kompilacja jest gotowa do testowania (przeczytaj przewodnik konfiguracji testera , aby uzyskać instrukcje dotyczące instalowania aplikacji testowej). Możesz monitorować status każdego testera – czy przyjął zaproszenie i czy pobrał aplikację – w konsoli Firebase.
Testerzy mają 30 dni na przyjęcie zaproszenia do przetestowania aplikacji, zanim wygaśnie. Gdy do wygaśnięcia zaproszenia pozostało 5 dni, w konsoli Firebase obok testera w wersji pojawi się powiadomienie o wygaśnięciu. Zaproszenie można odnowić, wysyłając je ponownie za pomocą menu rozwijanego w wierszu testera.
Następne kroki
Zaimplementuj opinie w aplikacji , aby ułatwić testerom przesyłanie opinii na temat Twojej aplikacji (w tym zrzutów ekranu).
Dowiedz się, jak wyświetlać testerom alerty w aplikacji , gdy będą dostępne do zainstalowania nowe wersje Twojej aplikacji.
Odwiedź zajęcia z kodowania pakietu aplikacji na Androida , aby dowiedzieć się, jak krok po kroku rozpowszechniać wersje pakietów aplikacji.
Poznaj najlepsze praktyki dystrybucji aplikacji na Androida wśród testerów kontroli jakości przy użyciu CI/CD .
Możesz zintegrować dystrybucję aplikacji z procesem kompilacji systemu Android za pomocą wtyczki App Distribution Gradle. Wtyczka umożliwia określenie testerów i informacji o wersji w pliku Gradle aplikacji, co pozwala skonfigurować dystrybucje dla różnych typów kompilacji i wariantów aplikacji.
W tym przewodniku opisano, jak dystrybuować pliki APK wśród testerów za pomocą wtyczki App Distribution Gradle.
Zanim zaczniesz
Jeśli jeszcze tego nie zrobiłeś, dodaj Firebase do swojego projektu na Androida .
Jeśli nie korzystasz z innych produktów Firebase, wystarczy, że utworzysz projekt i zarejestrujesz swoją aplikację. Jeśli jednak w przyszłości zdecydujesz się skorzystać z dodatkowych produktów, pamiętaj o wykonaniu wszystkich kroków opisanych na stronie, do której link znajduje się powyżej.
Krok 1. Skonfiguruj swój projekt na Androida
W pliku Gradle na poziomie głównym (na poziomie projektu) (
<project>/build.gradle.kts
lub<project>/build.gradle
) dodaj wtyczkę App Distribution Gradle jako zależność:Kotlin
plugins { // ... id("com.android.application") version "7.3.0" apply false // Make sure that you have the Google services Gradle plugin dependency id("com.google.gms.google-services") version "4.4.0" apply false // Add the dependency for the App Distribution Gradle plugin id("com.google.firebase.appdistribution") version "4.0.1" apply false }
Groovy
plugins { // ... id 'com.android.application' version '7.3.0' apply false // Make sure that you have the Google services Gradle plugin dependency id 'com.google.gms.google-services' version '4.4.0' apply false // Add the dependency for the App Distribution Gradle plugin id 'com.google.firebase.appdistribution' version '4.0.1' apply false }
W pliku Gradle modułu (na poziomie aplikacji) (zwykle
<project>/<app-module>/build.gradle.kts
lub<project>/<app-module>/build.gradle
) dodaj wtyczkę App Distribution Gradle:Kotlin
plugins { id("com.android.application") // Make sure that you have the Google services Gradle plugin id("com.google.gms.google-services") // Add the App Distribution Gradle plugin id("com.google.firebase.appdistribution") }
Groovy
plugins { id 'com.android.application' // Make sure that you have the Google services Gradle plugin id 'com.google.gms.google-services' // Add the App Distribution Gradle 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
Krok 2. Uwierzytelnij się w Firebase
Zanim będziesz mógł korzystać z wtyczki Gradle, musisz najpierw uwierzytelnić się w projekcie Firebase na jeden z poniższych sposobów. Domyślnie wtyczka Gradle szuka poświadczeń w interfejsie CLI Firebase, jeśli nie jest używana żadna inna metoda uwierzytelniania.
Uwierzytelnienie za pomocą konta usługi pozwala na elastyczne korzystanie z wtyczki z systemem ciągłej integracji (CI). Dane uwierzytelniające konto usługi można podać na dwa sposoby:
- Przekaż plik klucza konta usługi do
build.gradle
. Ta metoda może okazać się wygodna, jeśli masz już plik klucza konta usługi w środowisku kompilacji. - Ustaw zmienną środowiskową
GOOGLE_APPLICATION_CREDENTIALS
tak, aby wskazywała plik kluczy konta usługi. Możesz preferować tę metodę, jeśli masz już skonfigurowane domyślne poświadczenia aplikacji (ADC) dla innej usługi Google (np. Google Cloud).
Aby uwierzytelnić się przy użyciu poświadczeń konta usługi:
- W Google Cloud Console wybierz swój projekt i utwórz nowe konto usługi.
- Dodaj rolę administratora dystrybucji aplikacji Firebase .
- Utwórz prywatny klucz JSON i przenieś klucz do lokalizacji dostępnej dla Twojego środowiska kompilacji. Pamiętaj, aby przechowywać ten plik w bezpiecznym miejscu , ponieważ zapewnia on administratorowi dostęp do dystrybucji aplikacji w Twoim projekcie Firebase.
- Pomiń ten krok, jeśli aplikację utworzyłeś po 20 września 2019 r.: W konsoli Google API włącz interfejs Firebase App Distribution API. Po wyświetleniu monitu wybierz projekt o tej samej nazwie, co projekt Firebase.
Podaj lub znajdź dane logowania do swojego konta usługi:
- Aby przekazać Gradle klucz konta usługi, w pliku
build.gradle
ustaw właściwośćserviceCredentialsFile
na plik JSON klucza prywatnego. Aby zlokalizować swoje dane uwierzytelniające w ADC, ustaw zmienną środowiskową
GOOGLE_APPLICATION_CREDENTIALS
na ścieżkę do pliku JSON klucza prywatnego. Na przykład:export GOOGLE_APPLICATION_CREDENTIALS=/absolute/path/to/credentials/file.json
Aby uzyskać więcej informacji na temat uwierzytelniania za pomocą usługi ADC, zobacz Podawanie poświadczeń do aplikacji.
- Aby przekazać Gradle klucz konta usługi, w pliku
Aby uzyskać instrukcje dotyczące uwierzytelniania projektu, zobacz Logowanie przy użyciu interfejsu wiersza polecenia Firebase .
Krok 3. Skonfiguruj właściwości dystrybucji
W pliku Gradle modułu (na poziomie aplikacji) (zwykle <project>/<app-module>/build.gradle.kts
lub <project>/<app-module>/build.gradle
) skonfiguruj dystrybucję aplikacji, dodając co najmniej jedna sekcja firebaseAppDistribution
.
Na przykład, aby udostępnić release
testerom, postępuj zgodnie z poniższymi instrukcjami:
Kotlin
import com.google.firebase.appdistribution.gradle.firebaseAppDistribution android { // ... buildTypes { getByName("release") { firebaseAppDistribution { artifactType = "APK" releaseNotesFile = "/path/to/releasenotes.txt" testers = "ali@example.com, bri@example.com, cal@example.com" } } } // ... }
Groovy
android { // ... buildTypes { release { firebaseAppDistribution { artifactType="APK" releaseNotesFile="/path/to/releasenotes.txt" testers="ali@example.com, bri@example.com, cal@example.com" } } } // ... }
Możesz skonfigurować dystrybucję aplikacji pod kątem typów kompilacji i wersji produktów .
Na przykład, aby dystrybuować kompilacje debug
i release
w wersji „demo” i „pełnej”, postępuj zgodnie z poniższymi instrukcjami:
Kotlin
import com.google.firebase.appdistribution.gradle.firebaseAppDistribution android { // ... buildTypes { getByName("debug") {...} getByName("release") {...} } flavorDimensions += "version" productFlavors { create("demo") { dimension = "version" firebaseAppDistribution { releaseNotes = "Release notes for demo version" testers = "demo@testers.com" } } create("full") { dimension = "version" firebaseAppDistribution { releaseNotes = "Release notes for full version" testers = "full@testers.com" } } } // ... }
Groovy
android { // ... buildTypes { debug {...} release {...} } flavorDimensions "version" productFlavors { demo { dimension "version" firebaseAppDistribution { releaseNotes="Release notes for demo version" testers="demo@testers.com" } } full { dimension "version" firebaseAppDistribution { releaseNotes="Release notes for full version" testers="full@testers.com" } } } // ... }
Aby skonfigurować dystrybucję, użyj następujących parametrów:
Parametry kompilacji dystrybucji aplikacji | |
---|---|
appId | Identyfikator aplikacji Firebase Twojej aplikacji. Wymagane tylko wtedy, gdy nie masz zainstalowanej wtyczki Google Services Gradle. Identyfikator aplikacji znajdziesz w pliku appId="1:1234567890:android:321abc456def7890" |
serviceCredentialsFile | Ścieżka do pliku JSON klucza prywatnego konta usługi. Wymagane tylko w przypadku korzystania z uwierzytelniania konta usługi. |
artifactType | Określa typ pliku aplikacji. Można ustawić na |
artifactPath | Ścieżka bezwzględna do pliku APK lub AAB, który chcesz przesłać. |
releaseNotes lub releaseNotesFile | Informacje o wersji dla tej kompilacji. Możesz bezpośrednio określić informacje o wydaniu lub ścieżkę do zwykłego pliku tekstowego. |
testers lub testersFile | Adresy e-mail testerów, którym chcesz dystrybuować kompilacje. Możesz określić testerów jako listę adresów e-mail rozdzielonych przecinkami: testers="ali@example.com, bri@example.com, cal@example.com" Możesz też określić ścieżkę do pliku zawierającego listę adresów e-mail rozdzielonych przecinkami: testersFile="/path/to/testers.txt" |
groups lub groupsFile | Grupy testerów, do których chcesz dystrybuować kompilacje (zobacz Zarządzanie testerami ). Grupy są określane przy użyciu Grupy można określić w formie listy aliasów grup oddzielonych przecinkami: groups="qa-team, android-testers" Możesz też określić ścieżkę do pliku zawierającego listę aliasów grup rozdzielanych przecinkami: groupsFile="/path/to/tester-groups.txt" |
stacktrace | Drukuje ślad stosu dla wyjątków użytkownika. Jest to pomocne podczas debugowania problemów. |
Krok 4. Udostępnij swoją aplikację testerom
Wreszcie, aby spakować aplikację testową i zaproś testerów, zbuduj cele
BUILD-VARIANT
iappDistributionUpload BUILD-VARIANT
z opakowaniem gradle projektu, gdzie BUILD-VARIANT jest opcjonalnym smakiem produktu i typu kompilacji skonfigurowanego w poprzednim kroku. Aby uzyskać więcej informacji o smakach produktów, zobacz Warianty konfiguracji kompilacji .Na przykład, aby rozpowszechniać aplikację za pomocą wariantu
release
wersji, uruchom następujące polecenie:./gradlew assembleRelease appDistributionUploadRelease
Lub, jeśli uwierzytelniłeś się z konto Google i nie podałeś poświadczeń w pliku Gradle Build, dołącz zmienną
FIREBASE_TOKEN
:export FIREBASE_TOKEN=1/a1b2c3d4e5f67890 ./gradlew --stop // Only needed for environment variable changes ./gradlew assembleRelease appDistributionUploadRelease
Możesz także zastąpić wartości
--<property-name>=<property-value>
w plikubuild.gradle
Na przykład:Aby przesłać kompilację debugowania na dystrybucję aplikacji:
./gradlew bundleDebug appDistributionUploadDebug --artifactType="APK"
Aby zaprosić dodatkowych testerów lub usunąć istniejących testerów z projektu Firebase:
./gradlew appDistributionAddTesters --projectNumber=<project_number> --emails="anothertester@email.com, moretesters@email.com"
./gradlew appDistributionRemoveTesters --projectNumber=<project_number> --emails="anothertester@email.com, moretesters@email.com"
Po dodaniu testera do projektu Firebase możesz dodać je do poszczególnych wydań. Testerzy, którzy zostali usunięci, nie będą już mieć dostępu do wydań w twoim projekcie, ale nadal mogą zachować dostęp do wydawnictw przez okno czasu.
Możesz także określić testery za pomocą
--file="/path/to/testers.txt"
zamiast--emails
.Zadania
appDistributionAddTesters
iappDistributionRemoveTesters
również akceptują następujące argumenty:projectNumber
: Twój numer projektu Firebase.serviceCredentialsFile
: Ścieżka do pliku poświadczeń usług Google. Jest to ten sam argument używany przez działanie przesyłania.
Wtyczka Gradle wyświetla następujące linki po przesłaniu zwolnienia. Te linki pomagają zarządzać binarami i upewnić się, że testerzy i inni programiści mają odpowiednią wersję:
-
firebase_console_uri
- Link do konsoli Firebase wyświetlającej pojedyncze wydanie. Możesz udostępnić ten link innym programistom w swoim org. -
testing_uri
- Link do wydania w Experience Tester (Android Native App), która pozwala testerom wyświetlić notatki i instaluj aplikację na ich urządzeniu. Tester wymaga dostępu do wersji, aby użyć linku. -
binary_download_uri
- podpisany link, który bezpośrednio pobiera i instaluje aplikację binarną (plik APK lub AAB). Link wygasa po godzinie.
Po rozpowszechnianiu kompilacji staje się ona dostępna w pulpicie pulpitowej dystrybucji aplikacji w konsoli Firebase przez 150 dni (pięć miesięcy). Gdy kompilacja wynosi 30 dni od wygaśnięcia, zawiadomienie o wygaśnięciu pojawia się zarówno w konsoli, jak i liście kompilacji testera na ich urządzeniu testowym.
Testerzy, którzy nie zostali zaproszeni do przetestowania aplikacji, otrzymują zaproszenia e -mail na początek, a istniejące testerzy otrzymują powiadomienia e -mail, że nowa kompilacja jest gotowa do przetestowania (przeczytaj instrukcje skonfigurowania testera , aby zainstalować aplikację testową). Możesz monitorować status każdego testera-czy zaakceptowali zaproszenie i czy pobrali aplikację w konsoli Firebase.
Testerzy mają 30 dni na przyjęcie zaproszenia do przetestowania aplikacji przed jej wygaśnięciem. Gdy zaproszenie wynosi 5 dni od wygaśnięcia, w konsoli Firebase pojawia się powiadomienie o wygaśnięciu obok testera. Zaproszenie można odnowić, rezygnując z niego za pomocą menu rozwijanego w wierszu testera.
Następne kroki
Zaimplementuj informacje zwrotne w aplikacji , aby ułatwić testerom wysyłanie informacji zwrotnej na temat aplikacji (w tym zrzutów ekranu).
Dowiedz się, jak wyświetlać powiadomienia w aplikacji dla testerów, gdy do zainstalowania są dostępne nowe kompilacje Twojej aplikacji.
Odwiedź pakiet Android App Pakieleb, aby dowiedzieć się, jak dystrybuować pakiety aplikacji krok po kroku.
Poznaj najlepsze praktyki dystrybucji aplikacji na Androida do testerów QA za pomocą CI/CD .