W tym przewodniku opisujemy, jak włączyć w aplikacji przesyłanie opinii za pomocą pakietu SDK Firebase App Distribution na Androida, aby 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 dołączyć 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. Rozmowy były nie powoduje żadnego efektu, jeśli nie ma pełnej implementacji pakietu SDK.
Zadeklaruj zależność z pakietem SDK App Distribution na Androida w plik 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 pełnej implementacji pakietu SDK w kompilacjach Google Play identyfikować warianty kompilacji, typy kompilacji lub rodzaje produktów które będziesz rozpowszechniać za pomocą Rozpowszechniania aplikacji.
Zadeklaruj zależność z pakietem SDK App Distribution na Androida w plik Gradle modułu (na poziomie aplikacji) (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-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 zebrać opinie od testerów, użyj jednego z tych wyzwalaczy pozwól testerom wysyłać opinie:
Wbudowany wyzwalacz powiadomień: Rozpowszechnianie aplikacji przez pakiet Android SDK 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ę.
Reguła niestandardowa: możesz dodać własną regułę. takie jak kliknięcie przycisku lub pozycji menu w aplikacji albo potrząśnięcie urządzenia.
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 do usługi Rozpowszechniania aplikacji przy użyciu swojego konta Google.
Rozpoczyna aktywność na pełnym ekranie, dzięki której tester może napisać i przesłać opinie.
Opcja 1. Reguła powiadomienia
Użyj showFeedbackNotification(), aby wyświetlić trwałą lub
w toku
powiadomienie na urządzeniu testera, które może kliknąć, aby zainicjować informację zwrotną.
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
informować testerów o zbieraniu i przetwarzaniu ich
danych opinii, możesz skorzystać z odpowiedniego tekstu, aby je przesłać.
Gdy użyjesz aplikacji showFeedbackNotification() i przekaże ona
powiadomienie jest ukryte. Jeśli chcesz ukryć
powiadomienie, użyj funkcji cancelFeedbackNotification(). Zalecamy
dodaj showFeedbackNotification() do kategorii onCreate() w Twojej 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ą mechanizmu
wyboru. Aby na przykład wyzwalać opinie, możesz dodać
„Prześlij opinię” do menu czynności lub pozwolić testerom
potrząśnięcie urządzeniem
lub zrób 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. Skompiluj i przetestuj implementację
Testy lokalne
Aby przetestować implementację bez konieczności wcześniejszego 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 Rozpowszechnianie aplikacji i testowanie możliwości wywołania informacji zwrotnej 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
Kompleksowe testowanie
Aby sprawdzić, czy aplikacja może przesyłać opinie, utwórz ją jako wersję przedpremierową obejmującego pełne biblioteki Rozpowszechniania aplikacji, a następnie przetestuj i wykonaj te kroki:
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 Krok 3. Skonfiguruj opinie w aplikacji
Pamiętaj, aby zalogować się na konto, na które przesłano nową wersję aplikacji i prześlij opinię.
Swoją opinię znajdziesz na karcie nowej wersji w Konsola Firebase.
Aby dowiedzieć się, jak rozwiązywać typowe problemy, na przykład 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
Możesz przeglądać i usuwać opinie użytkowników, w tym otwórz kartę 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ć wersji, której dotyczy dana opinia.
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 otrzymywać informacje o opiniach nowych testerów, możesz otrzymywać e-maile alerty o przesłaniu opinii przez testera. Alert e-mail zawiera opinii dostarczonej przez testera i linku do zrzutów ekranu, które przesłał.
Aby otrzymywać alerty e-mail z usługi Rozpowszechniania aplikacji za pomocą tego domyślnego mechanizmu, musisz mieć
uprawnienia firebase.projects.update. Te role obejmują tę funkcję
domyślnie wymagane uprawnienia: administrator Firebase.
lub Właściciela lub Edytującego projektu.
Domyślnie każdy członek projektu, który ma wymagane uprawnienia do otrzymywania alerty e-mail będą otrzymywać e-maila, gdy zostanie przesłany nowy raport dotyczący opinii. 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
Możesz też wysyłać alerty Rozpowszechniania aplikacji zgodnie z preferencjami zespołu za pomocą Cloud Functions dla Firebase. Na przykład możesz napisać rejestruje zdarzenie alertu dla nowych opinii w aplikacji i publikuje i wysyłać alerty do usługi zewnętrznej, takiej jak Discord, Slack czy Jira.
Aby skonfigurować zaawansowane możliwości tworzenia alertów za pomocą Cloud Functions dla Firebase, wykonaj te czynności:
Skonfiguruj Cloud Functions dla Firebase. który 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 w aplikacji Rozpowszechnianie aplikacji zdarzenie alertu dotyczącego opinii w aplikacji i obsługuje ładunek zdarzeń (np. publikuje informacje o alercie w wiadomości na Discordzie).
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 rozpowszechniania aplikacji.