W tym przewodniku opisano, jak włączyć przesyłanie opinii w aplikacji za pomocą opcjonalnego pakietu Firebase App Distribution Android SDK, aby testerzy mogli przesyłać opinie (w tym zrzuty ekranu) bezpośrednio w aplikacji.
Zanim zaczniesz
Jeśli jeszcze tego nie zrobiłeś, dodaj Firebase do swojego projektu na Androida .
Krok 1: Włącz interfejs API testera dystrybucji aplikacji
Otwórz Google Cloud Console i wybierz swój projekt Firebase.
W interfejsie Firebase App Testers API kliknij Włącz .
Krok 2: Dodaj dystrybucję aplikacji do swojej aplikacji
Pakiet SDK dystrybucji aplikacji na Androida składa się z dwóch bibliotek:
-
firebase-appdistribution-api: biblioteka obsługująca tylko interfejs API, którą można uwzględnić we wszystkich wariantach kompilacji . -
firebase-appdistribution: Pełna implementacja SDK (opcjonalnie).
Biblioteka obsługująca tylko interfejs API umożliwia kodowi wykonywanie wywołań do zestawu SDK. Wywołania nie mają żadnego efektu, jeśli nie jest dostępna pełna implementacja zestawu SDK.
Zadeklaruj zależność dla pakietu App Distribution Android SDK w swoim module (na poziomie aplikacji) pliku Gradle (zwykle
<project>/<app-module>/build.gradle.ktslub<project>/<app-module>/build.gradle).Aby uniknąć włączania pełnej funkcji samoaktualizacji pakietu SDK do swoich kompilacji w Google Play, zidentyfikuj warianty kompilacji, w tym typy kompilacji lub smaki produktów , które będziesz rozpowszechniać w ramach dystrybucji aplikacji.
Zadeklaruj zależność dla zestawu Android SDK dystrybucji aplikacji w pliku Gradle modułu (na poziomie aplikacji) (zwykle jest
app/build.gradle). Dodawaj pełną implementację pakietu SDK tylko do wariantów przeznaczonych wyłącznie do testów przedpremierowych:Kotlin+KTX
dependencies { // ADD the API-only library to all variants implementation("com.google.firebase:firebase-appdistribution-api-ktx:16.0.0-beta10") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta10") }Java
dependencies { // ADD the API-only library to all variants implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta10") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta10") }
Krok 3: Skonfiguruj informacje zwrotne w aplikacji
Aby zebrać opinie od swoich testerów, użyj jednego z poniższych wyzwalaczy, aby umożliwić testerom zainicjowanie opinii:
Wbudowany wyzwalacz powiadomień : pakiet SDK dystrybucji aplikacji na Androida może wyświetlać bieżące powiadomienie, które tester może dotknąć z dowolnego miejsca w aplikacji. Użyj tego wyzwalacza, jeśli chcesz szybciej zacząć i nie musisz dostosowywać sposobu, w jaki testerzy przekazują informacje zwrotne.
Wyzwalacz niestandardowy : możesz zapewnić własny mechanizm wyzwalania, na przykład dotknię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ę, Android SDK wykona te czynności:
Przechwytuje zrzut ekranu bieżącej aktywności aplikacji.
Przeprowadza testy, aby upewnić się, że tester włączył funkcje testowe zestawu SDK. Jeśli funkcje testowania nie są włączone, zestaw Android SDK monituje testera o zalogowanie się do usługi App Distribution przy użyciu konta Google.
Uruchamia czynność pełnoekranową, która umożliwia testerowi napisanie i przesłanie opinii.
Opcja 1: wyzwalacz powiadomienia
Użyj metody showFeedbackNotification() , aby wyświetlić trwałe lub ciągłe powiadomienie na urządzeniu testera, które może dotknąć, aby zainicjować informację zwrotną. Podczas konfigurowania powiadomienia należy podać tekst, który zostanie wyświetlony testerowi przed przesłaniem opinii, oraz poziom przerwania powiadomienia (odpowiadający ważności kanału powiadomień). Jeśli chcesz powiadomić swoich testerów o gromadzeniu i przetwarzaniu ich danych zwrotnych, możesz użyć tekstu, aby przekazać takie powiadomienie.
Kiedy używasz showFeedbackNotification() i gdy aplikacja przechodzi w tło, powiadomienie jest ukryte. Jeśli chcesz jawnie ukryć powiadomienie, użyj cancelFeedbackNotification() . Zalecamy umieszczenie showFeedbackNotification() w metodzie onCreate() głównej działalnoś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: Wyzwalacz niestandardowy
Użyj metody startFeedback() , aby zainicjować informację zwrotną przy użyciu wybranego mechanizmu. Na przykład, aby uzyskać informację zwrotną, możesz dodać element menu „Prześlij opinię” do menu akcji aplikacji lub pozwolić testerom potrząsnąć urządzeniem lub zrobić zrzut ekranu . Gdy uruchamiasz informację zwrotną, podaj tekst, który zostanie wyświetlony testerowi przed przesłaniem opinii. Jeśli chcesz powiadomić swoich testerów o gromadzeniu i przetwarzaniu ich danych zwrotnych, możesz użyć tego tekstu, aby przekazać takie powiadomienie.
Kotlin+KTX
Firebase.appDistribution.startFeedback(R.string.feedbackMessage)
Java
FirebaseAppDistribution.getInstance().startFeedback(R.string.feedbackMessage);
Krok 4: Zbuduj i przetestuj swoją implementację
Testy lokalne
Aby przetestować implementację bez konieczności uprzedniego rozpowszechniania aplikacji, wykonaj następujące kroki:
Włącz tryb deweloperski na swoim urządzeniu lokalnym:
adb shell setprop debug.firebase.appdistro.devmode true
Zbuduj swoją aplikację jako wersję przedpremierową zawierającą pełne biblioteki dystrybucji aplikacji i przetestuj, czy możesz wywoływać opinie, korzystając z mechanizmu zaimplementowanego w Kroku 3: Konfigurowanie opinii w aplikacji . Opinia nie jest przesyłana w trybie deweloperskim.
Po przetestowaniu możesz wyłączyć tryb deweloperski na swoim urządzeniu:
adb shell setprop debug.firebase.appdistro.devmode false
Testowanie od końca do końca
Aby sprawdzić, czy Twoja aplikacja może wysyłać opinie, utwórz wersję przedpremierową, która zawiera pełne biblioteki dystrybucji aplikacji, i przetestuj implementację, wykonując następujące czynności:
Prześlij nową wersję aplikacji do dystrybucji aplikacji.
Rozpowszechnij wersję aplikacji na koncie, do którego masz uprawnienia dostępu.
Pobierz aplikację za pośrednictwem aplikacji internetowej App Distribution lub aplikacji do testowania systemu Android.
Wywołaj informację zwrotną za pomocą mechanizmu zaimplementowanego w Kroku 3: Konfiguruj informację zwrotną w aplikacji .
Upewnij się, że jesteś zalogowany na to samo konto, na które dystrybuowałeś wersję aplikacji, i prześlij opinię.
Zobacz swoją opinię na karcie nowej wersji w konsoli Firebase .
Aby dowiedzieć się, jak rozwiązywać typowe problemy, na przykład testerzy nie mogą przesyłać opinii w aplikacji, zobacz Włączanie funkcji testowania za pomocą zestawu SDK .
Krok 5: Zarządzaj opiniami testerów
Po umożliwieniu testerom wysyłania opinii możesz użyć następujących narzędzi do przeglądania tych opinii i podejmowania działań na ich podstawie:
Przeglądaj i usuwaj opinie w konsoli Firebase
Możesz przeglądać i usuwać opinie użytkowników, w tym zrzuty ekranu, otwierając kartę Opinie testerów w określonej wersji w konsoli Firebase. Opinie użytkowników są uporządkowane według wersji, dzięki czemu można potwierdzić wersję, której dotyczy opinia.
Po przejrzeniu opinii użytkowników możesz usunąć tę opinię, klikając przycisk Usuń opinię . Usunięta opinia zostanie usunięta z Twojej wersji.
Otrzymuj powiadomienia e-mail o nowych opiniach
Aby aktywnie otrzymywać informacje zwrotne od nowych testerów, możesz otrzymywać powiadomienia e-mail, gdy tester prześle opinię. Powiadomienie e-mail zawiera pisemną opinię przesłaną przez testera oraz link do przesłanych przez niego zrzutów ekranu.
Aby otrzymywać alerty e-mail dotyczące dystrybucji aplikacji za pośrednictwem tego domyślnego mechanizmu, musisz mieć uprawnienie firebase.projects.update . Następujące role domyślnie obejmują to wymagane uprawnienie: administrator Firebase lub właściciel projektu lub edytujący .
Domyślnie każdy członek projektu, który ma wymagane uprawnienia do otrzymywania alertów e-mail, otrzyma wiadomość e-mail po przesłaniu nowego raportu zwrotnego. Członkowie projektu mogą indywidualnie zrezygnować z tych alertów.
Aby wyłączyć alerty e-mail, zobacz Otrzymywanie alertów Firebase .
Wyślij nową opinię do narzędzi innych firm
Alerty dystrybucji aplikacji możesz też wysyłać do kanału powiadomień preferowanego przez Twój zespół, korzystając z Cloud Functions dla Firebase. Na przykład możesz napisać funkcję, która przechwytuje zdarzenie alertu w celu uzyskania nowej 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 dla Firebase, wykonaj te czynności:
Skonfiguruj Cloud Functions dla Firebase , co obejmuje następujące zadania:
Pobierz Node.js i npm.
Zainstaluj i zaloguj się do Firebase CLI.
Zainicjuj Cloud Functions dla Firebase przy użyciu Firebase CLI.
Napisz i wdróż funkcję , która przechwytuje zdarzenie alertu opinii w aplikacji z dystrybucji aplikacji i obsługuje ładunek zdarzenia (na przykład publikuje informacje o alercie w wiadomości na Discordzie).
Aby zobaczyć przykładową funkcję, która pokazuje, jak wysłać nową opinię do Jira, zapoznaj się z tym przykładem .
Aby dowiedzieć się więcej o wszystkich zdarzeniach alertów, które można przechwytywać, zapoznaj się z dokumentacją referencyjną dotyczącą alertów dystrybucji aplikacji .