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.
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.
Pod interfejsem 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 tylko dla interfejsu API, którą możesz uwzględnić we wszystkich wariantach kompilacji.firebase-appdistribution: pełna implementacja pakietu SDK (opcjonalnie).
Biblioteka wyłącznie z interfejsem API umożliwia kodowi wywoływanie pakietu SDK. 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 pakietem SDK Androida (App Distribution) w swoim plik Gradle (na poziomie modułu) (zwykle
app/build.gradle). Dodaj tylko pełną implementację pakietu SDK w wersjach przeznaczonych wyłącznie dla: testy przedpremierowe: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
Jeśli chcesz zebrać opinie od testerów, użyj jednego z tych wyzwalaczy pozwól testerom wysyłać opinie:
Wbudowany wyzwalacz powiadomień: App Distribution SDK dla Androida może wyświetlać bieżące powiadomienie, że może kliknąć w dowolnym miejscu w aplikacji. Użyj tego wyzwalacza, jeśli chcesz: możesz rozpocząć pracę szybciej i nie musisz dostosowywać sposobu, w jaki testerzy przesłać opinię.
Aktywator niestandardowy: możesz podać własny mechanizm aktywacji, np. dotknięcie przycisku lub elementu menu w aplikacji lub potrząsnięcie urządzeniem.
Jeśli użyjesz jednego z tych aktywatorów, a tester prześle opinię, Android SDK wykonuje te działania:
Robi zrzut ekranu bieżącej aktywności w aplikacji.
Przeprowadza testy, aby sprawdzić, czy tester włączył funkcje testowania pakietu SDK. Jeśli funkcje testowania nie są włączone, pakiet Android SDK prosi testera o podpisanie umowy w App Distribution za pomocą swojego konta Google.
Rozpoczyna aktywność na pełnym ekranie, dzięki której tester może napisać i przesłać opinie.
Opcja 1. Wyzwalacz powiadomienia
Użyj showFeedbackNotification(), aby wyświetlić na urządzeniu testera trwałe lub ciągłe powiadomienie, które można kliknąć, aby przekazać opinię.
Podczas konfigurowania powiadomienia musisz podać tekst, który będzie
zostaną wyświetlone testerowi przed przesłaniem opinii, a także poziom
przerwa w wysyłaniu powiadomienia (odpowiadająca 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 funkcji 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. Reguła niestandardowa
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 wyślesz opinię, podaj tekst, który będzie wyświetlany testerowi
przed przesłaniem opinii. Jeśli chcesz przesłać powiadomienie testerom
o gromadzeniu i przetwarzaniu ich danych zwrotnych, możesz użyć tego tekstu,
nie powinien tego robić.
Kotlin+KTX
Firebase.appDistribution.startFeedback(R.string.feedbackMessage)
Java
FirebaseAppDistribution.getInstance().startFeedback(R.string.feedbackMessage);
Krok 4. Utwórz i przetestuj implementację
Testy lokalne
Aby przetestować implementację bez konieczności uprzedniego rozpowszechniania aplikacji, wykonaj te czynności:
Włącz tryb programisty na urządzeniu lokalnym:
adb shell setprop debug.firebase.appdistro.devmode true
Utwórz aplikację jako wersję przedpremierową, która obejmuje pełne App Distribution i testowanie możliwości wywołania opinii za pomocą tego mechanizmu zaimplementowano w: Krok 3. Skonfiguruj opinie w aplikacji. Opinia to nie został przesłany w trybie deweloperskim.
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 na App Distribution.
Udostępnij wersję aplikacji na koncie, na które masz uprawnienia dostępu.
Pobierz aplikację za pomocą aplikacji internetowej App Distribution lub testera 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, przeczytaj artykuł Włączanie funkcji testowania za pomocą pakietu SDK.
Krok 5. Zarządzaj opiniami testerów
Gdy włączysz przesyłanie opinii przez testerów, możesz skorzystać z tych opcji: i narzędzia do analizowania tych opinii i podejmowania na ich podstawie 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ę Opinia testera w kontekście 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 odnoszą się opinie.
Po zapoznaniu się z opiniami użytkowników możesz je usunąć, klikając Przycisk Usuń opinię. Usunięta opinia zostanie usunięta z wersji.
Otrzymuj alerty e-mail o nowych opiniach
Aby aktywnie otrzymywać opinie nowych testerów, możesz otrzymywać e-maile z ostrzeżeniami, gdy tester prześle opinię. Alert e-mail zawiera opinii dostarczonej przez testera i linku do zrzutów ekranu, które przesłał.
Aby otrzymywać e-maile z powiadomieniami 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, przeczytaj artykuł Otrzymywanie alertów Firebase.
Prześlij nową opinię do narzędzi innych firm
Możesz też wysyłać App Distribution alerty zgodnie z preferencjami zespołu kanał 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ą usługi 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 w Discord).
Aby zobaczyć przykładową funkcję, która pokazuje, jak wysłać nową opinię do Jira, znajdziesz w tym przykładzie.
Więcej informacji o wszystkich zdarzeniach alertu, które możesz przechwytywać, znajdziesz w dokumentacji dokumentację alertów dotyczących App Distribution.