Skip to content

Пример внедрения SDK отзывов и оценок RuStore

License

Notifications You must be signed in to change notification settings

rustore-dev/rustore-java-review-sdk-example

Repository files navigation

Пример внедрения SDK отзывов и оценок RuStore

Оглавление

Условия работы SDK оценок и отзывов

Для работы SDK оценок и отзывов необходимо соблюдение следующих условий:

Требования для пользователя:

  • ОС Android версии 7.0 или выше.

  • На устройстве пользователя установлена актуальная версия RuStore.

  • Пользователь авторизован в RuStore.

  • Приложение должно быть опубликовано в RuStore.

Требования для разработчика/приложения:

  • ApplicationId, указанный в build.gradle, совпадает с applicationId apk-файла, который вы публиковали в консоль RuStore.

  • Подпись keystore должна совпадать с подписью, которой было подписано приложение, опубликованное в консоль RuStore. Убедитесь, что используемый buildType (пр. debug) использует такую же подпись, что и опубликованное приложение (пр. release).

Подготовка требуемых параметров

  1. applicationId - из приложения, которое вы публиковали в консоль RuStore, находится в файле build.gradle вашего проекта

    android {
        defaultConfig {
            applicationId = "ru.rustore.sdk.reviewexample"
        }
    }
    
  2. release.keystore - подпись, которой было подписано приложение, опубликованное в консоль RuStore.

  3. release.properties - в этом файле должны быть указаны параметры подписи, которой было подписано приложение, опубликованное в консоль RuStore. Как работать с ключами подписи APK-файлов

Настройка примера приложения

  1. Замените applicationId, в файле build.gradle, на applicationId apk-файла, который вы публиковали в консоль RuStore:

    android {
        defaultConfig {
           applicationId = "ru.rustore.sdk.reviewexample"
        }
    }
    
  2. В директории cert замените сертификат release.keystore - сертификатом своего приложения, так же в release.properties выполните настройку параметров key_alias, key_password, store_password. Подпись release.keystore должна совпадать с подписью, которой было подписано приложение, опубликованное в консоль RuStore. Убедитесь, что используемый buildType (пр. debug) использует такую же подпись, что и опубликованное приложение (пр. release).

  3. Запустите проект и проверьте работу приложения

Сценарий-использования

Представим, что у нас есть игра, где нужно нажать 5 раз кнопку, чтобы победить. Это означает, что начало флоу пользователя - старт игры (открытие экрана), а конец флоу - победа в игре.

Начало флоу Оценка приложения Конец флоу

Подготовка к работе с оценками

Для работы с оценками необходимо создать RuStoreReviewManager с помощью RuStoreReviewManagerFactory.

RuStoreReviewManager reviewManager = RuStoreReviewManagerFactory.INSTANCE.create(requireContext());

Подготовка к запуску оценки приложения

Рекомендуется использовать requestReviewFlow заранее, перед вызовом launchReviewFlow, чтобы подготовить необходимую информацию для отображения экрана. Срок жизни ReviewInfo — около пяти минут.

private void requestReviewFlow() {
    if (reviewInfo != null) return

    reviewManager.requestReviewFlow()
           .addOnSuccessListener(reviewInfo -> {
               this.reviewInfo = reviewInfo;
           });
}

Запуск оценки приложения

Для запуска формы запроса оценки и отзыва о приложении у пользователя вызовите метод launchReviewFlow, используя ранее полученный ReviewInfo.

private void launchReviewFlow(){
    if (reviewInfo != null) {
        reviewManager.launchReviewFlow(reviewInfo)
               .addOnSuccessListener(reviewInfo -> Log.w("ReviewFlow", "Review Flow started"))
               .addOnFailureListener(throwable -> Log.e("ReviewFlow", "Review Flow error" + throwable));
    }
}

Полный код приведенных выше примеров кода приведен в данном репозитории (UserFlowFragment).

Условия распространения

Данное программное обеспечение, включая исходные коды, бинарные библиотеки и другие файлы распространяется под лицензией MIT. Информация о лицензировании доступна в документе MIT-LICENSE.txt

Техническая поддержка

Если появились вопросы по интеграции SDK оценок и отзывов, обратитесь по ссылке.

About

Пример внедрения SDK отзывов и оценок RuStore

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages