SmartAppRating

Small library which can be used to display a rating popup. Different informations are used to trigger the popup such as last crash date, number of session, etc

Usage

JSON Configuration file

With version 1.2.0 or lower, the only way to use this library is via a JSON configuration file. A sample is available in this repository : here

Gradle

Gradle :

implementation 'com.smartnsoft:smartapprating:1.2.0'

Application configuration

Application class :

final SmartAppRatingManager smartAppRatingManager = new Builder(this)
        .setIsInDevelopmentMode(BuildConfig.DEBUG)
        .setApplicationId(BuildConfig.APPLICATION_ID)
        .setApplicationVersionName(BuildConfig.VERSION_NAME)
        .setConfigurationFileURL("http://simple_base_url.com/", "path/to/configuration/file")
        .build();

// Needed to detect crashes
SmartAppRatingManager.setUncaughtExceptionHandler(this, Thread.getDefaultUncaughtExceptionHandler());

In order to count the number of session :

SmartAppRatingManager.increaseNumberOfSession(PreferenceManager.getDefaultSharedPreferences(this));

Display the popup :

If you want to retrieve the configuration and display the popup in one call

smartAppRatingManager.fetchConfigurationAndTryToDisplayPopup();

If you want to retrieve the configuration and display the popup later

// first
smartAppRatingManager.fetchConfiguration();
...
// then later
smartAppRatingManager.showRatePopup();

After a major update, if you want to ask user to rate again, you'll have to use this method:

SmartAppRatingManager.resetRating(sharedPreferences);

Custom popup activity

If you want to use a custom layout or override specific parts of the popup activity :

Extends from class SmartAppRatingActivity

public final class MyCustomAppRatingActivity
    extends SmartAppRatingActivity
{

  @Override
  protected int getLayoutId()
  {
    return R.layout.my_custom_layout;
  }
  
}

And register the new one in the SmartAppRatingManager Builder

final SmartAppRatingManager smartAppRatingManager = new Builder(this)
        .setRatePopupActivity(MyCustomAppRatingActivity.class)
        ...
        .build();

Releases

1.2.0 (2019-06-05)

Added the ability to set custom drawable for each position of the rating bar
Available on Bintray !

1.1.0 (2018-06-05)

Updated ConstraintLayout to version 1.1.0
Added a way to get RatingPopup Intent to add more extras
Improved the rating bar widget
Disabled the reset rating feature of the SimpleRatingBar

1.0.0 (2018-02-01)

Initial release

Author

The Android Team @ Smart&Soft, software agency

Contribution

All sorts of contributions are welcome. Please create a pull request and/or issue.

safety97/SmartAppRating-android