了解 2023 年 Google I/O 大会上介绍的 Firebase 亮点。了解详情

Zbieraj opinie od testerów

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

  1. Otwórz Google Cloud Console i wybierz swój projekt Firebase.

  2. 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.

  1. 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.

  2. 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-beta08'
    
       // ADD the full SDK implementation to the "beta" variant only (example)
       betaImplementation 'com.google.firebase:firebase-appdistribution:16.0.0-beta08'
    }
    

    Java

    
    dependencies {
       // ADD the API-only library to all variants
       implementation 'com.google.firebase:firebase-appdistribution-api:16.0.0-beta08'
    
       // ADD the full SDK implementation to the "beta" variant only (example)
       betaImplementation 'com.google.firebase:firebase-appdistribution:16.0.0-beta08'
    }
    

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:

  1. Przechwytuje zrzut ekranu bieżącej aktywności aplikacji.

  2. 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.

  3. 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:

  1. Włącz tryb deweloperski na swoim urządzeniu lokalnym:

    adb shell setprop debug.firebase.appdistro.devmode true
    
  2. 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.

  3. 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:

  1. Prześlij nową wersję aplikacji do dystrybucji aplikacji.

  2. Rozpowszechnij wersję aplikacji na koncie, do którego masz uprawnienia dostępu.

  3. Pobierz aplikację za pośrednictwem aplikacji internetowej App Distribution lub aplikacji do testowania systemu Android.

  4. Wywołaj informację zwrotną za pomocą mechanizmu zaimplementowanego w Kroku 3: Konfiguruj informację zwrotną w aplikacji .

  5. Upewnij się, że jesteś zalogowany na to samo konto, na które dystrybuowałeś wersję aplikacji, i prześlij opinię.

  6. 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:

  1. Skonfiguruj Cloud Functions dla Firebase , co obejmuje następujące zadania:

    1. Pobierz Node.js i npm.

    2. Zainstaluj i zaloguj się do Firebase CLI.

    3. Zainicjuj Cloud Functions dla Firebase przy użyciu Firebase CLI.

  2. 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 .