Z tego przewodnika dowiesz się, jak włączyć przesyłanie opinii w aplikacji za pomocą opcjonalnego Firebase App Distributionpakietu SDK na Androida, aby testerzy mogli przesyłać opinie (w tym zrzuty ekranu) bezpośrednio w aplikacji.
Zanim zaczniesz
Dodaj Firebase do projektu aplikacji na Androida, jeśli nie korzystasz w nim jeszcze z tej usługi.
Krok 1. Włącz App Distribution interfejs Tester API
Otwórz konsolę Google Cloud i wybierz projekt w Firebase.
W sekcji Firebase App Testers API kliknij Włącz.
Krok 2. Dodaj App Distribution do aplikacji
Pakiet App Distribution Android SDK składa się z 2 bibliotek:
firebase-appdistribution-api: biblioteka tylko do interfejsu API, którą możesz uwzględnić we wszystkich wariantach kompilacji.firebase-appdistribution: pełna implementacja pakietu SDK (opcjonalna).
Biblioteka tylko z interfejsem API umożliwia kodowi wywoływanie pakietu SDK. Wywołania nie mają wpływu, jeśli nie ma pełnej implementacji pakietu SDK.
Zadeklaruj zależność z App Distributionpakietem Android SDK w pliku Gradle na poziomie modułu (aplikacji) (zwykle
<project>/<app-module>/build.gradle.ktslub<project>/<app-module>/build.gradle).Aby uniknąć uwzględniania w kompilacjach Google Play funkcji automatycznej aktualizacji pełnej implementacji pakietu SDK, określ warianty kompilacji, w tym typy kompilacji i wersje produktu, które będziesz rozpowszechniać za pomocą App Distribution.
Zadeklaruj zależność z App Distributionpakietem SDK na Androida w pliku Gradle na poziomie modułu (aplikacji) (zwykle
app/build.gradle). Dodaj pełną implementację pakietu SDK tylko do wariantów przeznaczonych wyłącznie do testów przedpremierowych:Kotlin
dependencies { // ADD the API-only library to all variants implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta19") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta19") }
Java
dependencies { // ADD the API-only library to all variants implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta19") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta19") }
Szukasz modułu biblioteki przeznaczonego specjalnie dla języka Kotlin? Począwszy od października 2023 r. deweloperzy korzystający z języków Kotlin i Java mogą używać głównego modułu biblioteki (więcej informacji znajdziesz w tym artykule).
Krok 3. Skonfiguruj opinie w aplikacji
Aby zbierać opinie od testerów, użyj jednego z tych wyzwalaczy, aby umożliwić testerom przesyłanie opinii:
Wbudowany wyzwalacz powiadomień: pakiet Android SDK może wyświetlać powiadomienie o trwającej aktywności, które tester może kliknąć z dowolnego miejsca w aplikacji. Użyj tego wyzwalacza, jeśli chcesz szybciej rozpocząć testy i nie musisz dostosowywać sposobu, w jaki testerzy przekazują opinie.App Distribution
Aktywator niestandardowy: możesz podać własny mechanizm aktywatora, np. kliknięcie przycisku lub elementu menu w aplikacji albo potrząśnięcie urządzeniem.
Gdy użyjesz jednego z tych wyzwalaczy, a tester prześle opinię, pakiet SDK na Androida wykona te działania:
Robi zrzut ekranu przedstawiający bieżącą aktywność w aplikacji.
Przeprowadza testy, aby sprawdzić, czy tester włączył funkcje testowania Android SDK. Jeśli funkcje testowania nie są włączone, Android SDK wyświetla prośbę o zalogowanie się w usłudze App Distribution za pomocą konta Google.
Uruchamia aktywność na pełnym ekranie, która umożliwia testerowi napisanie i przesłanie opinii.
Opcja 1. Wywołanie powiadomienia
Użyj showFeedbackNotification(), aby wyświetlić na urządzeniu testera trwałe lub ciągłe powiadomienie, które może on kliknąć, aby rozpocząć przesyłanie opinii.
Podczas konfigurowania powiadomienia musisz podać tekst, który będzie wyświetlany testerowi przed przesłaniem opinii, oraz poziom przerwania powiadomienia (odpowiadający ważności kanału powiadomień). Jeśli chcesz poinformować testerów o zbieraniu i przetwarzaniu danych z ich opinii, możesz użyć tego tekstu.
Gdy używasz showFeedbackNotification() i aplikacja przechodzi w tło, powiadomienie jest ukrywane. Jeśli chcesz jawnie ukryć powiadomienie, użyj cancelFeedbackNotification(). Zalecamy umieszczenie showFeedbackNotification() w metodzie onCreate() głównej aktywności.
Kotlin
class MainActivity : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
Firebase.appDistribution.showFeedbackNotification(
// Text providing notice to your testers about collection and
// processing of their feedback data
R.string.additionalFormText,
// The level of interruption for the notification
InterruptionLevel.HIGH)
}
}
Java
public class MainActivity extends AppCompatActivity {
FirebaseAppDistribution firebaseAppDistribution =
FirebaseAppDistribution.getInstance();
@Override
public void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
firebaseAppDistribution.showFeedbackNotification(
// Text providing notice to your testers about collection and
// processing of their feedback data
R.string.additionalFormText,
// The level of interruption for the notification
InterruptionLevel.HIGH);
}
}
Opcja 2. Aktywator niestandardowy
Użyj metody startFeedback(), aby zainicjować przesyłanie opinii za pomocą wybranego mechanizmu. Aby na przykład wywołać przesyłanie opinii, możesz dodać do menu czynności aplikacji element „Prześlij opinię” lub umożliwić testerom potrząśnięcie urządzeniem lub zrobienie zrzutu ekranu. Gdy wywołasz przesyłanie opinii, podaj tekst, który będzie wyświetlany testerowi przed przesłaniem opinii. Jeśli chcesz poinformować testerów o zbieraniu i przetwarzaniu danych dotyczących ich opinii, możesz użyć tego tekstu.
Kotlin
Firebase.appDistribution.startFeedback(R.string.feedbackMessage)
Java
FirebaseAppDistribution.getInstance().startFeedback(R.string.feedbackMessage);
Krok 4. Tworzenie i testowanie implementacji
Testowanie lokalne
Aby przetestować implementację bez konieczności wcześniejszego rozpowszechniania aplikacji, wykonaj te czynności:
Włącz tryb dewelopera na urządzeniu lokalnym:
adb shell setprop debug.firebase.appdistro.devmode true
Zbuduj aplikację jako wersję przedpremierową, która zawiera pełne App Distributionbiblioteki, i sprawdź, czy możesz wywołać opinię za pomocą mechanizmu zaimplementowanego w kroku 3: skonfiguruj opinię w aplikacji. W trybie deweloperskim opinia nie jest przesyłana.
Po zakończeniu testów możesz wyłączyć tryb programisty na urządzeniu:
adb shell setprop debug.firebase.appdistro.devmode false
Testowanie kompleksowe
Aby sprawdzić, czy aplikacja może wysyłać opinie, utwórz jej wersję przedpremierową, która zawiera pełne biblioteki App Distribution, i przetestuj implementację, wykonując te czynności:
Prześlij nową wersję aplikacji do App Distribution.
Rozpowszechnij wersję aplikacji na koncie, do którego masz dostęp.
Pobierz aplikację za pomocą strony App Distribution lub aplikacji testera na Androida.
Wywołaj opinię za pomocą mechanizmu zaimplementowanego w kroku 3: skonfiguruj opinię w aplikacji.
Zaloguj się na to samo konto, na które rozpowszechniono wersję aplikacji, i prześlij opinię.
Swoje opinie możesz wyświetlić na karcie nowej wersji w Firebase konsoli.
Aby dowiedzieć się, jak rozwiązywać typowe problemy, np. gdy testerzy nie mogą rozpocząć przesyłania opinii w aplikacji, przeczytaj artykuł Włączanie funkcji testowania za pomocą pakietu SDK.
Krok 5. Zarządzaj opiniami testerów
Gdy umożliwisz testerom przesyłanie opinii, możesz użyć tych narzędzi do ich przeglądania i podejmowania odpowiednich działań:
Wyświetlanie i usuwanie opinii w konsoli Firebase
Opinie użytkowników, w tym zrzuty ekranu, możesz przeglądać i usuwać, otwierając kartę Opinie testerów w sekcji konkretnej wersji w konsoli Firebase. Opinie użytkowników są uporządkowane według wersji, dzięki czemu możesz sprawdzić, do której wersji się odnoszą.
Po zapoznaniu się z opiniami użytkowników możesz je usunąć, klikając przycisk Usuń opinię. Usunięte opinie zostaną usunięte z Twojej wersji.
Otrzymywanie alertów e-mail o nowych opiniach
Aby na bieżąco otrzymywać informacje o nowych opiniach testerów, możesz otrzymywać e-maile z powiadomieniami, gdy tester prześle opinię. E-mail z powiadomieniem zawiera pisemną opinię testera i link do przesłanych przez niego zrzutów ekranu.
Aby otrzymywać alerty e-mailowe App Distribution za pomocą tego domyślnego mechanizmu, musisz mieć uprawnienie firebase.projects.update. To wymagane uprawnienie jest domyślnie zawarte w tych rolach: Administrator Firebase oraz Właściciel lub Edytujący projektu.
Domyślnie każdy użytkownik projektu, który ma uprawnienia do otrzymywania e-maili z alertami, będzie otrzymywać e-maila po przesłaniu nowego raportu z opinią. Uczestnicy projektu mogą indywidualnie zrezygnować z tych alertów.
Aby wyłączyć alerty e-mail, przeczytaj artykuł Otrzymywanie alertów Firebase.
Przesyłanie nowych opinii do narzędzi innych firm
Możesz też wysyłać App Distribution alerty do preferowanego kanału powiadomień zespołu za pomocą Cloud Functions for Firebase. Możesz na przykład napisać funkcję, która rejestruje zdarzenie alertu dotyczące nowych opinii w aplikacji i publikuje informacje o alercie w usłudze innej firmy, takiej jak Discord, Slack lub Jira.
Aby skonfigurować zaawansowane funkcje alertów za pomocą Cloud Functions for Firebase, wykonaj te czynności:
Skonfiguruj Cloud Functions for Firebase, wykonując te czynności:
Pobierz Node.js i npm.
Zainstaluj interfejs wiersza poleceń Firebase i zaloguj się w nim.
Zainicjuj Cloud Functions for Firebase za pomocą interfejsu wiersza poleceń Firebase.
Napisz i wdroż funkcję, która przechwytuje zdarzenie alertu opinii w aplikacji z App Distribution i obsługuje ładunek zdarzenia (np. publikuje informacje o alercie w wiadomości na Discordzie).
Przykładową funkcję, która pokazuje, jak wysyłać nowe opinie do Jira, znajdziesz tutaj.
Więcej informacji o wszystkich zdarzeniach alertów, które możesz rejestrować, znajdziesz w dokumentacji referencyjnej dotyczącej App Distribution alertów.