Android-Rate is a library to help you promote your android app by prompting users to rate the app after using it for a few days.
Download from maven central.
dependencies {
compile 'com.github.hotchemi:android-rate:{latest.version}'
}
- 2014/02/12 0.0.2 release.
- 2014/02/13 0.0.3 release.
- 2014/04/07 0.0.4 release.
- 2014/04/12 0.0.5 release.
Please try to move the sample.
Call AppRate.monitor(Context)
and AppRate.showRateDialogIfMeetsConditions(Context)
in your launcher activity.
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// Monitor launch times and duration of feeding period from installation
AppRate.monitor(this);
// Show a dialog if meets conditions
AppRate.showRateDialogIfMeetsConditions(this);
}
The default conditions to show rate dialog is as below:
- App is launched more than 10 times.
- App is launched more than 10 days later than installation.
If you want to use your own condition, please call AppRate.setLaunchTimes(int)
and AppRate.setInstallDays(int)
.
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// Monitor launch times and duration of feeding period from installation
AppRate.setInstallDays(0) // default 10, 0 means install day.
.setLaunchTimes(3) // default 10
.monitor(this);
// Show a dialog if meets conditions
AppRate.showRateDialogIfMeetsConditions(this);
}
If you want to use your own dialog labels, override string xml resources on your application.
<resources>
<string name="rate_dialog_title">Rate this app</string>
<string name="rate_dialog_message">If you enjoy playing this app, would you mind taking a moment to rate it? It won\'t take more than a minute. Thanks for your support!</string>
<string name="rate_dialog_ok">Rate It Now</string>
<string name="rate_dialog_cancel">Remind Me Later</string>
<string name="rate_dialog_no">No, Thanks</string>
</resources>
And if you want to decide whether neutral button is appeared, please call AppRate.setShowNeutralButton(boolean)
.
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// method chain
AppRate.setInstallDays(0)
.setShowNeutralButton(false) // default true
.monitor(this);
}
Android-Rate currently supports the following languages:
- English
- Spanish
- French
- Chinese
- Korean
- Japanese
- Vietnamese
Supports Android 2.2 or greater.
$ ./gradlew connectedCheck
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Added some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request