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
Jeśli nie korzystasz jeszcze z Firebase w projekcie aplikacji na Androida, dodaj tę usługę do projektu.
Krok 1. Włącz App Distribution interfejs Tester API
Otwórz Google Cloudkonsolę i wybierz projekt 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 (opcjonalnie);
Biblioteka tylko interfejsu API umożliwia wywoływanie pakietu SDK przez Twój kod. Wywołania nie mają żadnego wpływu, jeśli nie ma pełnej implementacji pakietu SDK.
Zadeklaruj zależność z App Distributionpakietem SDK na Androida 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-ktx:16.0.0-beta15") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta16") }
Java
dependencies { // ADD the API-only library to all variants implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta16") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta16") }
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 SDK Androida może wyświetlać ciągłe powiadomienie, które tester może kliknąć w dowolnym miejscu 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żywasz jednego z tych wyzwalaczy, a tester przesyła opinię, pakiet SDK na Androida wykonuje te czynności:
Robi zrzut ekranu przedstawiający bieżącą aktywność w aplikacji.
Przeprowadza sprawdzenia, aby upewnić się, że tester włączył funkcje testowania pakietu SDK. Jeśli funkcje testowania nie są włączone, pakiet SDK na Androida wyświetli testerowi prośbę o zalogowanie się na 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żna 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 tle, powiadomienie jest ukrywane. Jeśli chcesz jawnie 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 wywołać opinię, możesz dodać do menu działań aplikacji element „Prześlij opinię” lub umożliwić testerom potrząsanie urządzeniem lub wykonywanie zrzutów ekranu.
Gdy wywołasz opinię, podaj tekst, który będzie wyświetlany testerowi przed przesłaniem opinii. Jeśli chcesz poinformować testerów o zbieraniu i przetwarzaniu danych z 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
Utwórz 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 opinie w aplikacji. Opinie nie są przesyłane w trybie dewelopera.
Po zakończeniu testowania 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 internetowej App Distribution lub aplikacji testowej 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 rozpowszechniasz wersję aplikacji, i prześlij opinię.
Swoją opinię możesz sprawdzić na karcie nowej wersji w Firebase konsoli.
Aby dowiedzieć się, jak rozwiązywać typowe problemy, np. gdy testerzy nie mogą rozpocząć przekazywania 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 działań na ich podstawie:
Wyświetlanie i usuwanie opinii w konsoli Firebase
Możesz przeglądać i usuwać opinie użytkowników, w tym zrzuty ekranu. Aby to zrobić, otwórz 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 sprawdzeniu opinii użytkowników możesz ją usunąć, klikając przycisk Usuń opinię. Usunięta opinia zostanie usunięta 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ć uprawnienia 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 otrzymywania 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.