Z tego przewodnika dowiesz się, jak włączyć opinie w aplikacji za pomocą opcjonalnego pakietu SDK do Androida, aby testerzy mogli przesyłać opinie (w tym zrzuty ekranu) bezpośrednio w aplikacji.Firebase App Distribution
Zanim zaczniesz
Jeśli jeszcze tego nie zrobiono, dodaj Firebase do projektu na Androida.
Krok 1. Włącz interfejs App Distribution Tester API
Otwórz konsolę Google Cloud i wybierz projekt Firebase.
W sekcji Interfejs API Testerzy aplikacji Firebase 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 tylko dla interfejsu API, którą możesz uwzględnić we wszystkich wariantach kompilacji.firebase-appdistribution: pełna implementacja pakietu SDK (opcjonalnie).
Biblioteka tylko do interfejsu API umożliwia wywoływanie pakietu SDK przez kod. Jeśli nie ma pełnej implementacji pakietu SDK, wywołania nie mają żadnego wpływu.
Zadeklaruj zależność z pakietu SDK Androida App Distribution w pliku Gradle modułu (na poziomie aplikacji) (zwykle
<project>/<app-module>/build.gradle.ktslub<project>/<app-module>/build.gradle).Aby uniknąć uwzględniania w wersjach w Google Play funkcji automatycznej aktualizacji w ramach pełnej implementacji pakietu SDK, określ warianty wersji, w tym typy wersji lub wersje produktu, które będziesz rozpowszechniać za pomocą App Distribution.
Zadeklaruj zależność z pakietu Android SDK App Distribution w pliku Gradle modułu (na poziomie aplikacji) (zwykle
app/build.gradle). Dodaj pełną implementację pakietu SDK tylko do wariantów przeznaczonych wyłącznie do testowania przed wydaniem:Kotlin+KTX
dependencies { // ADD the API-only library to all variants implementation("com.google.firebase:firebase-appdistribution-api-ktx:16.0.0-beta14") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta14") }Java
dependencies { // ADD the API-only library to all variants implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta14") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta14") }
Krok 3. Skonfiguruj opinie w aplikacji
Aby zbierać opinie od testerów, użyj jednego z tych wyzwalaczy, aby umożliwić im rozpoczęcie procesu przesyłania opinii:
Wbudowany wyzwalacz powiadomienia: pakiet SDK Androida App Distribution może wyświetlać powiadomienie, które tester może kliknąć w dowolnym miejscu w aplikacji. Użyj tego wyzwalacza, jeśli chcesz zacząć szybciej i nie musisz dostosowywać sposobu przesyłania opinii przez testerów.
Aktywator niestandardowy: możesz podać własny mechanizm aktywacji, np. dotknięcie przycisku lub elementu menu w aplikacji lub potrząsnięcie urządzeniem.
Gdy użyjesz któregoś z tych wyzwalaczy, a tester prześle opinię, pakiet Android SDK wykona te czynności:
Robi zrzut ekranu bieżącej aktywności aplikacji.
Sprawdza, czy tester włączył funkcje testowania w SDK. Jeśli funkcje testowania nie są włączone, pakiet SDK Androida prosi testera o zalogowanie się na konto Google.App Distribution
Uruchamia aktywność pełnoekranową, która umożliwia testerowi napisanie i przesłanie opinii.
Opcja 1. Wyzwalacz powiadomienia
Użyj showFeedbackNotification(), aby wyświetlić na urządzeniu testera stałe lub ciągłe powiadomienie, które można kliknąć, aby przekazać opinię.
Podczas konfigurowania powiadomienia musisz podać tekst, który będzie wyświetlany testerom przed przesłaniem przez nich opinii, oraz poziom przerwania działania aplikacji (odpowiadający ważności kanału powiadomień). Jeśli chcesz poinformować testerów o zbieraniu i przetwarzaniu ich danych dotyczących opinii, możesz użyć tego tekstu.
Gdy używasz showFeedbackNotification(), a aplikacja przechodzi do trybu w tle, powiadomienie jest ukryte. Jeśli chcesz ukryć powiadomienie, użyj cancelFeedbackNotification(). Zalecamy umieszczenie showFeedbackNotification() w sekcji onCreate() głównej aktywności.
Kotlin+KTX
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
Aby rozpocząć proces przesyłania opinii, użyj metody startFeedback(). Aby na przykład wywołać opinię, możesz dodać do menu akcji aplikacji pozycję menu „Prześlij opinię” lub pozwolić testerom potrząsnąć urządzeniem lub zrobić zrzut 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 ich opinii, możesz użyć tego tekstu.
Kotlin+KTX
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 rozpowszechniania aplikacji, wykonaj te czynności:
Włącz tryb programisty na urządzeniu lokalnym:
adb shell setprop debug.firebase.appdistro.devmode true
Utwórz wersję przedpremierową aplikacji, która zawiera pełne biblioteki App Distribution. Następnie sprawdź, czy możesz wywołać opinię za pomocą mechanizmu zaimplementowanego w kroku 3. Skonfiguruj opinię w aplikacji. Opinie nie są przesyłane w trybie dewelopera.
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.
Udostępnij wersję aplikacji na koncie, na które masz uprawnienia dostępu.
Pobierz aplikację w witrynie App Distribution lub w aplikacji testowej na Androida.
Wywołaj opinię za pomocą mechanizmu zaimplementowanego w kroku 3: Konfigurowanie opinii w aplikacji.
Zaloguj się na konto, na które rozpowszechniono wersję aplikacji, i prześlij opinię.
Sprawdź swoją opinię 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, zapoznaj się z artykułem Włączanie funkcji testowania za pomocą pakietu SDK.
Krok 5. Zarządzaj opiniami testerów
Po włączeniu możliwości przesyłania opinii przez testerów możesz korzystać z tych narzędzi do ich przeglądania i reagowania na nie:
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ę Opinia testera w konsoli Firebase w ramach konkretnej wersji. Opinie użytkowników są uporządkowane według wersji, dzięki czemu możesz sprawdzić, do której wersji odnoszą się opinie.
Po sprawdzeniu opinii użytkownika możesz ją usunąć, klikając przycisk Usuń opinię. Usunięta opinia zostanie usunięta z Twojego wydania.
otrzymywać e-maile z powiadomieniami o nowych opiniach.
Aby aktywnie otrzymywać opinie nowych testerów, możesz otrzymywać e-maile z ostrzeżeniami, gdy tester prześle opinię. E-mail zawiera pisemną opinię testera oraz link do przesłanych przez niego zrzutów ekranu.
Aby otrzymywać e-maile z alertami App Distribution za pomocą tego domyślnego mechanizmu, musisz mieć uprawnienia firebase.projects.update. Te uprawnienia są domyślnie zawarte w roli Administrator Firebase lub Właściciel lub Edytujący.
Domyślnie każdy użytkownik projektu, który ma wymagane uprawnienia do otrzymywania alertów e-mail, otrzyma e-maila po przesłaniu nowego raportu z opinią. Uczestnicy projektu mogą indywidualnie zrezygnować z tych alertów.
Aby wyłączyć alerty e-mail, zapoznaj się z artykułem Otrzymywanie alertów Firebase.
Przesyłanie nowych opinii do narzędzi innych firm
Możesz też wysyłać alerty App Distribution do preferowanego kanału powiadomień Twojego 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 alertach w usłudze innej firmy, takiej jak Discord, Slack czy Jira.
Aby skonfigurować zaawansowane funkcje tworzenia 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 rejestruje zdarzenie alertu opinii w aplikacji z App Distribution i obsługuje ładunek zdarzenia (np. publikuje informacje o alercie w wiadomości na Discordzie).
Aby zobaczyć przykładową funkcję, która pokazuje, jak przesyłać nowe opinie do Jira, zapoznaj się z tym przykładem.
Więcej informacji o wszystkich zdarzeniach alertu, które możesz rejestrować, znajdziesz w dokumentacji na temat alertów App Distribution.