Z tego przewodnika dowiesz się, jak włączyć przesyłanie opinii w aplikacji za pomocą opcjonalnego pakietu Android SDK Firebase App Distribution, by testerzy mogli przesyłać opinie (w tym zrzuty ekranu) bezpośrednio w aplikacji.
Zanim zaczniesz
Dodaj Firebase do swojego projektu Android, chyba że masz to już za sobą.
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 SDK na Androida 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. Bez pełnej implementacji pakietu SDK wywołania nie działają.
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ąć włączenia funkcji automatycznej aktualizacji w ramach pełnej implementacji pakietu SDK w kompilowanych wersjach Google Play, określ warianty kompilacji, w tym typy kompilacji lub wersje produktu, które będziesz rozpowszechniać za pomocą App Distribution.
Zadeklaruj zależność z pakietem SDK App Distribution do Androida 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 przedpremierowego: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 powiadomień: pakiet SDK App Distribution Android może wyświetlać bieżące powiadomienie, które tester może kliknąć z dowolnego miejsca w aplikacji. Użyj tego wyzwalacza, jeśli chcesz zacząć szybciej i nie musisz dostosowywać sposobu przekazywania 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 w 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.
Rozpoczyna aktywność na pełnym ekranie, dzięki czemu tester może napisać i przesłać opinię.
Opcja 1. Reguła 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 wyświetlany testerom przed przesłaniem przez nich opinii, oraz poziom przerwania, który będzie miał powiadomienie (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
Użyj metody startFeedback(), aby przesłać opinię za pomocą wybranego przez siebie mechanizmu. Aby na przykład wywołać opinię, możesz dodać opcję menu „Prześlij opinię” do menu czynności aplikacji, 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, i 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
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 App Distribution.
Udostępnij wersję aplikacji na koncie, do którego masz dostęp.
Pobierz aplikację za pomocą aplikacji internetowej App Distribution lub testera na Androida.
Prześlij opinię, korzystając z mechanizmu zaimplementowanego w Kroku 3. Skonfiguruj opinie 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. brak możliwości rozpoczęcia przesyłania opinii w aplikacji przez testerów, 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ć, której wersji się dotyczą.
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ę. Alert e-mail zawiera pisemną opinię dostarczoną przez testera oraz link do przesłanych przez niego zrzutów ekranu.
Aby otrzymywać e-maile z powiadomieniami App Distribution za pomocą tego domyślnego mechanizmu, musisz mieć uprawnienia firebase.projects.update. Te role domyślnie mają wymagane uprawnienia: Administrator Firebase lub Właściciel lub Edytujący projektu.
Domyślnie każdy członek projektu, który ma wymagane uprawnienia do otrzymywania alertów e-mail, otrzymuje e-maila po przesłaniu nowego raportu. 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 po otrzymaniu nowych opinii w aplikacji i publikuje informacje o alertach do usług zewnętrznych, takich jak Discord, Slack lub 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 alertach 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.