Z tego przewodnika dowiesz się, jak włączyć opinie w aplikacji za pomocą opcjonalnego pakietu SDK Firebase App Distribution 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 interfejs App Distribution 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 Android SDK App Distribution składa się z 2 bibliotek:
firebase-appdistribution-api: biblioteka zawierająca tylko interfejs API, którą możesz uwzględnić we wszystkich wariantach kompilacji.firebase-appdistribution: pełna implementacja pakietu SDK (opcjonalnie).
Biblioteka zawierająca tylko interfejs API umożliwia kodowi wywoływanie pakietu SDK. Wywołania nie mają żadnego efektu, jeśli nie ma pełnej implementacji pakietu SDK.
Zadeklaruj zależność z pakietem Android SDK App Distribution w pliku Gradle na poziomie modułu (aplikacji) (zwykle
<project>/<app-module>/build.gradle.ktslub<project>/<app-module>/build.gradle).Aby uniknąć uwzględniania pełnej funkcji samodzielnej aktualizacji implementacji pakietu SDK w kompilacjach Google Play, określ warianty kompilacji, w tym typy kompilacji lub warianty usługi, które będziesz rozpowszechniać za pomocą App Distribution.
Zadeklaruj zależność z pakietem Android SDK App Distribution 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-beta21") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta21") }
Java
dependencies { // ADD the API-only library to all variants implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta21") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta21") }
Szukasz modułu biblioteki przeznaczonego dla języka Kotlin? Od października 2023 r. zarówno deweloperzy Kotlin, jak i Java mogą korzystać z głównego modułu biblioteki. Szczegółowe informacje znajdziesz w najczęstszych pytaniach na temat tej inicjatywy.
Krok 3. Skonfiguruj przesyłanie opinii w aplikacji
Aby zbierać opinie od testerów, użyj jednego z tych aktywatorów, aby umożliwić testerom przesyłanie opinii:
Wbudowany aktywator powiadomień: pakiet App Distribution Android SDK może wyświetlać powiadomienie o trwającej aktywności, które tester może kliknąć w dowolnym miejscu w aplikacji. Użyj tego aktywatora, jeśli chcesz szybciej rozpocząć pracę i nie musisz dostosowywać sposobu, w jaki testerzy przekazują opinie.
Niestandardowy aktywator: możesz udostępnić własny mechanizm aktywacji, np. kliknięcie przycisku lub elementu menu w aplikacji albo potrząśnięcie urządzeniem.
Gdy użyjesz jednego z tych aktywatorów, a tester prześle opinię, pakiet Android SDK wykona te działania:
Robi zrzut ekranu bieżącej aktywności aplikacji.
Sprawdza, czy tester włączył funkcje testowe pakietu SDK. Jeśli funkcje testowania nie są włączone, pakiet Android SDK prosi testera o zalogowanie się w aplikacji App Distribution za pomocą konta Google.
Uruchamia działanie na pełnym ekranie, które umożliwia testerowi napisanie i przesłanie opinii.
Opcja 1. Aktywowanie powiadomienia
Użyj showFeedbackNotification(), aby wyświetlić na urządzeniu testera stałe lub bieżące powiadomienie, które można kliknąć, aby przesłać opinię. Podczas konfigurowania powiadomienia musisz podać tekst, który będzie wyświetlany testerowi przed przesłaniem opinii, oraz poziom zakłóceń powiadomienia (odpowiadający ważności kanału powiadomień). Jeśli chcesz poinformować testerów o gromadzeniu i przetwarzaniu ich opinii, możesz użyć tego tekstu.
Gdy używasz aplikacji showFeedbackNotification() i przechodzi ona do działania w tle, powiadomienie jest ukrywane. Jeśli chcesz wyraźnie ukryć powiadomienie, użyj cancelFeedbackNotification(). Zalecamy umieszczenie showFeedbackNotification() w 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 umożliwić przesyłanie opinii, możesz dodać element menu „Prześlij opinię” do menu czynności w aplikacji lub pozwolić testerom potrząsnąć urządzeniem lub zrobić zrzut ekranu.
Gdy uruchomisz przesyłanie opinii, podaj tekst, który będzie wyświetlany testerowi, zanim prześle on opinię. Jeśli chcesz poinformować testerów o zbieraniu i przetwarzaniu ich opinii, możesz użyć tego tekstu.
Kotlin
Firebase.appDistribution.startFeedback(R.string.feedbackMessage)
Java
FirebaseAppDistribution.getInstance().startFeedback(R.string.feedbackMessage);
Krok 4. Utwórz i przetestuj implementację
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
Skompiluj aplikację jako wariant przedpremierowy, który zawiera pełne biblioteki App Distribution, i sprawdź, czy możesz wywołać przesyłanie opinii za pomocą mechanizmu zaimplementowanego w kroku 3. Skonfiguruj przesyłanie opinii w aplikacji. W trybie dewelopera opinie nie są przesyłane.
Po zakończeniu testów możesz wyłączyć tryb programisty na urządzeniu:
adb shell setprop debug.firebase.appdistro.devmode false
Kompleksowe testowanie
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 na ścieżkę App Distribution.
Rozpowszechnij wersję aplikacji na koncie, do którego masz uprawnienia dostępu.
Pobierz aplikację za pomocą aplikacji internetowej lub aplikacji testera na Androida firmy App Distribution.
Wywołaj opinię za pomocą mechanizmu wdrożonego w kroku 3. Skonfiguruj opinie w aplikacji.
Zaloguj się na konto, na którym została opublikowana wersja aplikacji, i prześlij opinię.
Wyświetl opinię na karcie nowej wersji w konsoli Firebase.
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żywać tych narzędzi, aby je przeglądać i podejmować odpowiednie działania:
Wyświetlanie i usuwanie opinii w konsoli Firebase
Możesz przeglądać i usuwać opinie użytkowników, w tym zrzuty ekranu, 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ć, której wersji dotyczy dana opinia.
Po sprawdzeniu opinii użytkownika możesz ją usunąć, klikając przycisk Usuń opinię. Usunięta opinia zostanie usunięta z Twojej wersji.
Otrzymuj alerty e-mail o nowych opiniach
Aby na bieżąco dowiadywać się o nowych opiniach testerów, możesz otrzymywać alerty e-mail, gdy tester prześle opinię. Alert e-mail zawiera pisemną opinię testera i link do przesłanych przez niego zrzutów ekranu.
Aby otrzymywać alerty e-mail dotyczące App Distribution za pomocą tego domyślnego mechanizmu, musisz mieć uprawnienie firebase.projects.update. To uprawnienie jest domyślnie uwzględnione w tych rolach: Administrator Firebase, Właściciel projektu i Edytujący projekt.
Domyślnie każdy użytkownik projektu, który ma wymagane uprawnienia do otrzymywania alertów e-mail, otrzyma e-maila, gdy zostanie przesłany nowy raport z opinią. Użytkownicy projektu mogą indywidualnie zrezygnować z tych alertów.
Aby wyłączyć alerty e-mail, zapoznaj się z artykułem Otrzymywanie alertów Firebase.
Wysyłanie nowych opinii do narzędzi innych firm
Możesz też wysyłać alerty App Distribution do preferowanego kanału powiadomień zespołu za pomocą Cloud Functions for Firebase. Możesz na przykład napisać funkcję, która przechwytuje zdarzenie alertu dotyczące nowych opinii w aplikacji i publikuje informacje o alercie w usłudze innej firmy, takiej jak Discord, Slack czy Jira.
Aby skonfigurować zaawansowane funkcje alertów za pomocą Cloud Functions for Firebase, wykonaj te czynności:
Skonfiguruj Cloud Functions for Firebase, co obejmuje te zadania:
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 wdróż funkcję, która przechwytuje zdarzenie alertu o 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 w tym przykładzie funkcji.
Aby dowiedzieć się więcej o wszystkich zdarzeniach alertów, które możesz przechwytywać, zapoznaj się z dokumentacją referencyjną dotyczącą alertów App Distribution.