Zbieraj opinie od testerów

W tym przewodniku opisano, jak włączyć opinie w aplikacji za pomocą opcjonalnego pakietu SDK Firebase App Distribution dla systemu Android, 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 konsolę Google Cloud i wybierz swój projekt Firebase.

  2. W obszarze API testerów aplikacji Firebase kliknij opcję Włącz .

Krok 2: Dodaj dystrybucję aplikacji do swojej aplikacji

Zestaw SDK aplikacji do dystrybucji aplikacji dla systemu Android składa się z dwóch bibliotek:

  • firebase-appdistribution-api : Biblioteka przeznaczona wyłącznie do interfejsu API, którą można uwzględnić we wszystkich wariantach kompilacji .
  • firebase-appdistribution : pełna implementacja SDK (opcjonalnie).

Biblioteka przeznaczona wyłącznie do interfejsu API umożliwia kodowi wykonywanie wywołań do zestawu SDK. Wywołania nie przynoszą żadnego efektu, jeśli nie ma pełnej implementacji zestawu SDK.

  1. Zadeklaruj zależność dla zestawu SDK systemu Android do dystrybucji aplikacji w pliku Gradle modułu (na poziomie aplikacji) (zwykle <project>/<app-module>/build.gradle.kts lub <project>/<app-module>/build.gradle ).

  2. Aby uniknąć włączania funkcji samodzielnej aktualizacji pełnej implementacji pakietu SDK do kompilacji Google Play, określ warianty kompilacji, w tym typy kompilacji lub wersje produktów , które będziesz dystrybuować za pośrednictwem aplikacji App Distribution.

  3. Zadeklaruj zależność dla zestawu SDK systemu Android do dystrybucji aplikacji w pliku Gradle modułu (na poziomie aplikacji) (zwykle app/build.gradle ). Dodaj pełną implementację SDK tylko do wariantów, które są przeznaczone wyłącznie do testów przed wydaniem:

    Kotlin+KTX

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

    Java

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

Krok 3: Skonfiguruj opinie w aplikacji

Aby zebrać opinie od testerów, użyj jednego z następujących wyzwalaczy, aby umożliwić testerom zainicjowanie informacji zwrotnej:

  • Wbudowany wyzwalacz powiadomień : zestaw SDK aplikacji do dystrybucji aplikacji dla systemu Android może wyświetlać ciągłe powiadomienie, z którego tester może skorzystać z dowolnego miejsca w aplikacji. Użyj tego wyzwalacza, jeśli chcesz szybciej rozpocząć pracę i nie musisz dostosowywać sposobu przekazywania opinii przez testerów.

  • Niestandardowy wyzwalacz : możesz udostępnić własny mechanizm wyzwalający, taki jak dotknięcie przycisku lub elementu menu w aplikacji lub potrząsanie urządzeniem.

Gdy użyjesz jednego z tych wyzwalaczy, a tester prześle opinię, zestaw SDK systemu Android wykona następujące działania:

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

  2. Uruchamia kontrole, aby upewnić się, że tester włączył funkcje testowe pakietu SDK. Jeśli funkcje testowania nie są włączone, pakiet SDK systemu Android monituje testera o zalogowanie się do aplikacji App Distribution przy użyciu konta Google.

  3. Rozpoczyna działanie na pełnym ekranie, które umożliwia testerowi napisanie i przesłanie opinii.

Opcja 1: wyzwalacz powiadomienia

Użyj showFeedbackNotification() , aby wyświetlić trwałe lub ciągłe powiadomienie na urządzeniu testera, którego może dotknąć, aby zainicjować informację zwrotną. Konfigurując powiadomienie, musisz podać tekst, który będzie wyświetlany testerowi, zanim prześle opinię, oraz poziom przerwania powiadomienia (odpowiadający ważności kanału powiadomień). Jeśli chcesz powiadomić testerów o gromadzeniu i przetwarzaniu ich danych zwrotnych, możesz użyć tego tekstu, aby przekazać takie powiadomienie.

Kiedy używasz showFeedbackNotification() i kiedy aplikacja przechodzi w tło, powiadomienie jest ukryte. Jeśli chcesz jawnie ukryć powiadomienie, użyj cancelFeedbackNotification() . Zalecamy umieszczenie showFeedbackNotification() w onCreate() głównego działania.

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ą za pomocą wybranego mechanizmu. Aby na przykład uzyskać opinię, możesz dodać opcję „Prześlij opinię” do menu akcji aplikacji lub pozwolić testerom potrząsnąć urządzeniem lub zrobić zrzut ekranu . Gdy wywołasz informację zwrotną, podaj tekst, który zostanie wyświetlony testerowi, zanim prześle opinię. 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 wcześniejszego 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ą, która zawiera pełne biblioteki dystrybucji aplikacji, i przetestuj, czy możesz wyzwalać opinie, korzystając z mechanizmu zaimplementowanego w kroku 3: Skonfiguruj opinie 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 aplikacja może wysyłać opinie, zbuduj aplikację jako wersję przedpremierową zawierającą pełne biblioteki dystrybucji aplikacji i przetestuj implementację, wykonując następujące kroki:

  1. Prześlij nową wersję aplikacji do App Distribution.

  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 testowej Androida.

  4. Wywołuj informację zwrotną za pomocą mechanizmu zaimplementowanego w Kroku 3: Skonfiguruj 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. Wyświetl swoją opinię na karcie nowej wersji w konsoli Firebase .

Aby dowiedzieć się, jak rozwiązać typowe problemy, takie jak brak możliwości uruchomienia przez testerów opinii w aplikacji, zobacz Włączanie funkcji testowania za pomocą pakietu SDK .

Krok 5: Zarządzaj opiniami testerów

Po umożliwieniu testerom wysyłania opinii możesz skorzystać z następujących narzędzi, aby przeglądać te opinie i reagować na nie:

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ę Opinia testera w ramach konkretnej wersji w konsoli Firebase. Opinie użytkowników są uporządkowane według wydań, dzięki czemu można sprawdzić wersję, której 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 Twojej wersji.

Otrzymuj powiadomienia e-mail o nowych opiniach

Aby aktywnie poznać opinie nowych testerów, możesz otrzymywać powiadomienia e-mail, gdy tester prześle opinię. Powiadomienie e-mail zawiera pisemną opinię dostarczoną przez testera oraz link do przesłanych przez niego zrzutów ekranu.

Aby otrzymywać powiadomienia 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 redaktor .

Domyślnie każdy członek projektu, który ma wymagane uprawnienia do otrzymywania powiadomień e-mail, otrzyma wiadomość e-mail po przesłaniu nowego raportu z opinią. Członkowie projektu mogą indywidualnie zrezygnować z tych alertów.

Aby wyłączyć alerty e-mailowe, zobacz Otrzymuj alerty Firebase .

Wysyłaj nowe opinie do narzędzi innych firm

Możesz także wysyłać alerty dotyczące dystrybucji aplikacji do preferowanego kanału powiadomień swojego zespołu, korzystając z Cloud Functions dla Firebase. Możesz na przykład napisać funkcję, która przechwytuje zdarzenie alertu dotyczące nowych 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 następujące kroki:

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

    1. Pobierz Node.js i npm.

    2. Zainstaluj i zaloguj się w interfejsie CLI Firebase.

    3. Zainicjuj funkcje chmury dla Firebase za pomocą interfejsu wiersza polecenia Firebase.

  2. Napisz i wdróż funkcję , która przechwytuje zdarzenie alertu opinii w aplikacji z App Distribution i obsługuje ładunek zdarzenia (na przykład publikuje informacje o alercie w wiadomości na Discordzie).

Aby zobaczyć przykładową funkcję pokazującą, 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 przechwycić, zapoznaj się z dokumentacją referencyjną dotyczącą alertów dystrybucji aplikacji .