Zbieranie opinii od testerów

Pakiet SDK na Androida Firebase App Distribution to wersji beta. Oznacza to, że ta funkcja może się zmienić niekompatybilne wstecznie. Wersja beta nie jest objęta żadną gwarancją jakości usług ani i mogą otrzymać ograniczoną pomoc lub nie mogą jej nie otrzymać.

W tym przewodniku opisujemy, jak włączyć w aplikacji przesyłanie opinii za pomocą Firebase App Distribution Android SDK, aby testerzy mogli przesłać opinię (w tym zrzuty ekranu) bezpośrednio w aplikacji.

Zanim zaczniesz

Dodaj Firebase do swojego projektu Android, chyba że masz to już za sobą.

Uwaga: jeśli w projekcie Firebase masz kilka aplikacji, upewnij się, którą chcesz udostępnić w domenie App Distribution, ma własne google-services.json . Więcej informacji: Obsługa wielu środowisk.

Krok 1. Włącz interfejs App Distribution Tester API

1. Otwórz konsolę Google Cloud. i wybierz projekt Firebase.

2. 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 obsługująca tylko interfejs API, którą możesz dołączyć we wszystkich wariantach kompilacji.
• firebase-appdistribution: pełna implementacja pakietu SDK (opcjonalnie).

.

Uwaga: aby umożliwić działanie funkcji takich jak powiadomienie testerów o nowych kompilacji, pełna implementacja pakietu App Distribution Android SDK zawiera samodzielną aktualizację funkcji, które można uznać za naruszenie Zasady Google Play, nawet jeśli nie jest on wykonywany w czasie działania. Przesyłanie aplikacji do Google Odtwarzanie bez usunięcia pełnej implementacji pakietu SDK może spowodować, że aplikacja zostanie została usunięta z Google Play.

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.

1. Zadeklaruj zależność z pakietem SDK Androida (App Distribution) w swoim Plik Gradle modułu (na poziomie aplikacji) (zwykle <project>/<app-module>/build.gradle.kts lub <project>/<app-module>/build.gradle).

2. 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 pośrednictwem App Distribution.

3. Zadeklaruj zależność z pakietem SDK Androida (App Distribution) w swoim plik Gradle (na poziomie modułu) (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ń: App Distribution SDK dla Androida 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:

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

2. 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 w App Distribution za pomocą swojego konta Google.

   Uwaga: włączenie funkcji testowania na urządzeniu testowym to jednorazowy proces. i pozostanie w miarę aktualizacji aplikacji. Funkcje testowe pozostają dostępne musi być włączona na urządzeniu testowym, dopóki tester nie odinstaluje aplikacji lub dopóki aplikacja nie wywoła metody signOutTester.

3. 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);
    }
}

Uwaga: na Androidzie 13 i nowszych ta metoda wymaga uprawnienia w środowisku wykonawczym do wysyłania powiadomień: POST_NOTIFICATIONS. Jeśli Twoja aplikacja jest kierowana na Androida 13 (poziom API 33) lub powyżej, musisz zadeklarować uprawnienia, a następnie wysyłać prośbę o nie w czasie działania.

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:

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

   adb shell setprop debug.firebase.appdistro.devmode true
   

2. Utwórz aplikację jako wersję przedpremierową, która obejmuje pełne App Distribution i testowanie możliwości wywołania opinii za pomocą tego mechanizmu zaimplementowano w: Krok 3. Skonfiguruj opinie w aplikacji. Opinia to nie został przesłany w trybie deweloperskim.

3. Po zakończeniu testów możesz wyłączyć tryb programisty na swoim urządzeniu:

   adb shell setprop debug.firebase.appdistro.devmode false
   

Kompleksowe testowanie

Uwaga: domyślnie nowa opinia powoduje wysłanie alertów e-mail i alertów w konsoli do wszystkich Właściciele i edytorzy projektów Firebase.

Aby sprawdzić, czy aplikacja może przesyłać opinie, utwórz ją jako wersję przedpremierową wersji obejmującej pełne biblioteki App Distribution, a następnie przetestuj i wykonaj te kroki:

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

2. Udostępnij wersję aplikacji na koncie, do którego masz dostęp.

3. Pobierz aplikację za pomocą aplikacji internetowej App Distribution lub testera na Androida.

4. Prześlij opinię, korzystając z mechanizmu zaimplementowanego w Krok 3. Skonfiguruj opinie w aplikacji

5. Pamiętaj, aby zalogować się na konto, na które przesłano nową wersję aplikacji i prześlij opinię.

6. Swoją opinię znajdziesz na karcie nowej wersji w Firebase.

.

Uwaga: zanim opublikujesz aplikację w Sklepie Google Play, przetestuj ją w aplikacji, aby sprawdzić, czy uwzględniasz tylko zależność biblioteki związanej z interfejsem API, i że mechanizm przesyłania opinii nie jest uwzględniony w wariancie wersji. Więcej informacji znajdziesz w sekcji Krok 2. Dodaj adres App Distribution do aplikacji.

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ń:

• Konsola Firebase

• Alerty e-mail dotyczące nowych opinii

• Narzędzia innych firm

Wyświetl i usuń opinie 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 (App Distribution) 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ć App Distribution alerty zgodnie z preferencjami zespołu kanał za pomocą Cloud Functions for 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.

Uwaga: aby można było korzystać z zaawansowanych funkcji tworzenia alertów, projekt Firebase musi używać abonament Blaze.

Aby skonfigurować zaawansowane funkcje tworzenia alertów za pomocą usługi Cloud Functions for Firebase, wykonaj te czynności:

1. Skonfiguruj Cloud Functions for Firebase. który obejmuje następujące zadania:

   1. Pobierz Node.js i npm.

   2. Zainstaluj interfejs wiersza poleceń Firebase i zaloguj się w nim.

   3. Zainicjuj Cloud Functions for Firebase za pomocą interfejsu wiersza poleceń Firebase.

2. Zapisz i wdróż funkcję, która przechwytuje w aplikacji zdarzenie alertu o opinii w aplikacji App Distribution 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 App Distribution.