Собирайте обратную связь от тестировщиков

В этом руководстве описывается, как включить обратную связь в приложении с помощью дополнительного Firebase App Distribution Android SDK, чтобы ваши тестировщики могли отправлять отзывы (включая снимки экрана) непосредственно в приложении.

Прежде чем начать

Если вы еще этого не сделали, добавьте Firebase в свой Android-проект .

Шаг 1: включите API App Distribution Tester

  1. Откройте консоль Google Cloud и выберите свой проект Firebase.

  2. В разделе Firebase App Testers API нажмите Включить .

Шаг 2: Добавьте App Distribution в свое приложение

App Distribution Android SDK состоит из двух библиотек:

  • firebase-appdistribution-api : библиотека, работающая только с API, которую можно включить во все варианты сборки .
  • firebase-appdistribution : Полная реализация SDK (необязательно).

Библиотека, работающая только с API, позволяет вашему коду обращаться к SDK. Эти обращения не будут иметь никакого эффекта, если отсутствует полная реализация SDK.

  1. Объявите зависимость для App Distribution Android SDK в файле Gradle вашего модуля (уровня приложения) (обычно <project>/<app-module>/build.gradle.kts или <project>/<app-module>/build.gradle ).

  2. Чтобы избежать включения функции самостоятельного обновления полной реализации SDK в ваши сборки Google Play, определите варианты сборок, включая типы сборок или версии продукта , которые вы будете распространять через App Distribution .

  3. Объявите зависимость для App Distribution Android SDK в Gradle-файле вашего модуля (на уровне приложения) (обычно app/build.gradle ). Полную реализацию SDK добавляйте только в те варианты, которые предназначены исключительно для предварительного тестирования:

    Kotlin 

    dependencies {
    // ADD the API-only library to all variants
    implementation("com.google.firebase:firebase-appdistribution-api-ktx:16.0.0-beta15")

    // ADD the full SDK implementation to the "beta" variant only (example)
    betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta17")
}

    Java 

    dependencies {
    // ADD the API-only library to all variants
    implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta17")

    // ADD the full SDK implementation to the "beta" variant only (example)
    betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta17")
}

Шаг 3: Настройте обратную связь в приложении

Чтобы собрать отзывы от тестировщиков, используйте один из следующих триггеров, позволяющих тестировщикам инициировать обратную связь:

  • Встроенный триггер уведомлений : App Distribution Android SDK может отображать постоянное уведомление, которое тестировщик может нажать из любой точки приложения. Используйте этот триггер, если хотите быстрее приступить к работе и вам не нужно настраивать способ предоставления обратной связи тестировщиками.

  • Пользовательский триггер : вы можете предоставить собственный механизм триггера, например нажатие кнопки или пункта меню в приложении или встряхивание устройства.

При использовании любого из этих триггеров и отправке тестировщиком отзыва Android SDK выполняет следующие действия:

  1. Делает снимок экрана текущей активности приложения.

  2. Проверяет, включены ли тестировщиком функции тестирования SDK. Если функции тестирования не включены, Android SDK предлагает тестировщику войти в App Distribution , используя свою учетную запись Google.

  3. Запускает полноэкранное действие, позволяющее тестировщику писать и отправлять свои отзывы.

Вариант 1: Триггер уведомления

Используйте showFeedbackNotification() для отображения постоянного или текущего уведомления на устройстве тестировщика, которое можно нажать для отправки отзыва. При настройке уведомления необходимо указать текст, который будет отображаться тестировщику перед отправкой отзыва, а также уровень прерывания уведомления (соответствующий важности канала уведомления). Если вы хотите уведомить тестировщиков о сборе и обработке данных их отзывов, вы можете использовать текст для такого уведомления.

При использовании showFeedbackNotification() и переходе приложения в фоновый режим уведомление скрывается. Если вы хотите явно скрыть уведомление, используйте cancelFeedbackNotification() . Мы рекомендуем поместить showFeedbackNotification() в onCreate() вашей основной активности.

Kotlin 

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