Z tego przewodnika dowiesz się, jak włączyć przesyłanie opinii w aplikacji za pomocą opcjonalnego pakietu SDK Firebase App Distribution na Androida, 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 Rozpowszechnianie aplikacji do swojej aplikacji
Pakiet App Distribution na Androida SDK składa się z 2 bibliotek:
firebase-appdistribution-api: biblioteka obsługująca tylko interfejs 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. Bez pełnej implementacji pakietu SDK wywołania nie działają.
Zadeklaruj zależność z pakietem SDK App Distribution na Androida w pliku Gradle modułu (na poziomie aplikacji) (zwykle
<project>/<app-module>/build.gradle.ktslub<project>/<app-module>/build.gradle).Aby nie uwzględniać w kompilacjach Google Play pełnej funkcji automatycznej aktualizacji pakietu SDK, określ warianty kompilacji, w tym typy kompilacji czy rodzaje usług, które będziesz rozpowszechniać za pomocą Rozpowszechniania aplikacji.
Zadeklaruj zależność z pakietem SDK App Distribution na 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-beta13") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta13") }Java
dependencies { // ADD the API-only library to all variants implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta13") // ADD the full SDK implementation to the "beta" variant only (example) betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta13") }
Krok 3. Skonfiguruj opinie w aplikacji
Jeśli chcesz zbierać opinie od testerów, użyj jednego z tych aktywatorów, aby umożliwić testerom wysyłanie opinii:
Wbudowany wyzwalacz powiadomień: pakiet SDK App Distribution na Androida 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.
Wyzwalacz niestandardowy: możesz udostępnić własny mechanizm, np. kliknięcie przycisku lub pozycji menu w aplikacji albo potrząsanie urządzeniem.
Gdy użyjesz jednego z tych aktywatorów, a tester prześle opinię, pakiet Android SDK wykona 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, aby zalogował się w usłudze Rozpowszechnianie aplikacji przy użyciu swojego konta 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 opcji showFeedbackNotification(), aby wyświetlić na urządzeniu testera trwałe lub trwałe powiadomienie, które może kliknąć, aby zainicjować informację zwrotną.
Podczas konfigurowania powiadomienia musisz podać tekst, który będzie wyświetlany testerowi, zanim prześle opinię, oraz poziom zakłóceń powiadomienia (odpowiadający ważności kanału powiadomień). Jeśli chcesz powiadomić testerów o zbieraniu i przetwarzaniu ich danych opinii, użyj odpowiedniego tekstu.
Gdy użyjesz funkcji showFeedbackNotification(), a aplikacja przejdzie w tle, powiadomienie będzie ukryte. Jeśli chcesz ukryć powiadomienie, użyj cancelFeedbackNotification(). Zalecamy umieszczenie pola 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
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 wyślesz opinię, podaj tekst, który zostanie wyświetlony testerowi, zanim prześle opinię. Możesz skorzystać z tego tekstu, aby powiadomić testerów o zbieraniu i przetwarzaniu ich danych opinii.
Kotlin+KTX
Firebase.appDistribution.startFeedback(R.string.feedbackMessage)
Java
FirebaseAppDistribution.getInstance().startFeedback(R.string.feedbackMessage);
Krok 4. Skompiluj i przetestuj implementację
Testy lokalne
Aby przetestować implementację bez 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 wariant przedpremierowy, który zawiera pełne biblioteki Rozpowszechniania aplikacji, i przetestuj, czy możesz wyzwalać opinie, korzystając z mechanizmu zaimplementowanego na stronie Krok 3. Skonfiguruj przesyłanie opinii w aplikacji. W trybie deweloperskim opinia nie jest przesyłana.
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 przesyłać opinie, utwórz ją jako przedpremierowy wariant obejmujący pełne biblioteki usługi Rozpowszechniania aplikacji i przetestuj implementację, wykonując te czynności:
Prześlij nową wersję aplikacji do usługi Rozpowszechnianie aplikacji.
Udostępnij wersję aplikacji na koncie, do którego masz dostęp.
Pobierz aplikację za pomocą aplikacji internetowej App Distribution lub aplikacji testera na Androida.
Prześlij opinię, korzystając z mechanizmu zaimplementowanego w Kroku 3. Skonfiguruj opinie w aplikacji.
Pamiętaj, aby zalogować się na konto, na którym rozpowszechniono wersję aplikacji, i prześlij opinię.
Swoją opinię znajdziesz na karcie nowej wersji w konsoli Firebase.
Aby dowiedzieć się, jak rozwiązywać typowe problemy, np. gdy testerzy nie mogą zacząć przesyłać opinii w aplikacji, przeczytaj artykuł Włączanie funkcji testowania za pomocą pakietu SDK.
Krok 5. Zarządzaj opiniami testerów
Gdy pozwolisz testerom na przesyłanie opinii, możesz je przeglądać i na tej podstawie podejmować za pomocą tych narzędzi:
Wyświetlanie i usuwanie opinii w konsoli Firebase
Opinie użytkowników, w tym zrzuty ekranu, możesz przeglądać i usuwać na karcie Opinie testerów w konkretnej wersji w konsoli Firebase. Opinie użytkowników są uporządkowane według wersji, dzięki czemu możesz sprawdzić, której wersji się dotyczą.
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
Możesz otrzymywać e-maile z powiadomieniami o przesłaniu opinii przez testerów, aby z wyprzedzeniem otrzymywać informacje o opiniach nowych testerów. Alert e-mail zawiera pisemną opinię dostarczoną przez testera oraz link do przesłanych przez niego zrzutów ekranu.
Aby otrzymywać alerty e-mail z usługi Rozpowszechniania aplikacji za pomocą tego domyślnego mechanizmu, musisz mieć uprawnienie 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. Członkowie projektu mogą samodzielnie 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
Za pomocą Cloud Functions dla Firebase możesz też wysyłać alerty Rozpowszechniania aplikacji do preferowanego kanału powiadomień zespołu. 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 dla Firebase, wykonaj te czynności:
Skonfiguruj Cloud Functions dla Firebase, co obejmuje następujące zadania:
Pobierz Node.js i npm.
Zainstaluj interfejs wiersza poleceń Firebase i zaloguj się w nim.
Zainicjuj Cloud Functions dla Firebase za pomocą interfejsu wiersza poleceń Firebase.
Zapisz i wdróż funkcję, która rejestruje z usługi App Distribution zdarzenie alertu dotyczącego opinii w aplikacji i obsługuje ładunek zdarzeń (np. publikuje informacje o alercie w wiadomości na Discord).
Aby zobaczyć przykładową funkcję, która pokazuje, jak wysyłać nowe opinie do Jira, zapoznaj się z tym przykładem.
Więcej informacji o wszystkich zdarzeniach alertów, które możesz przechwycić, znajdziesz w dokumentacji alertów dotyczących rozpowszechniania aplikacji.