Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/hotchemi/android-rate
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.
https://github.com/hotchemi/android-rate
Last synced: 4 days ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/hotchemi/android-rate
- Owner: hotchemi
- License: mit
- Created: 2014-02-11T15:17:22.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2022-07-13T03:07:40.000Z (over 2 years ago)
- Last Synced: 2024-10-14T12:43:25.422Z (3 months ago)
- Language: Java
- Homepage: http://hotchemi.github.io/Android-Rate
- Size: 676 KB
- Stars: 722
- Watchers: 29
- Forks: 216
- Open Issues: 48
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
Android-Rate
============
[](https://travis-ci.org/hotchemi/Android-Rate)
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.
## Install
You can download from maven central.
${latest.version} is 
```groovy
dependencies {
compile 'com.github.hotchemi:android-rate:{latest.version}'
}
```
## Usage
### Configuration
Android-Rate provides methods to configure its behavior.
```java
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
AppRate.with(this)
.setInstallDays(0) // default 10, 0 means install day.
.setLaunchTimes(3) // default 10
.setRemindInterval(2) // default 1
.setShowLaterButton(true) // default true
.setDebug(false) // default false
.setOnClickButtonListener(new OnClickButtonListener() { // callback listener.
@Override
public void onClickButton(int which) {
Log.d(MainActivity.class.getName(), Integer.toString(which));
}
})
.monitor();
// Show a dialog if meets conditions
AppRate.showRateDialogIfMeetsConditions(this);
}
```
The default conditions to show rate dialog is as below:
1. App is launched more than 10 days later than installation. Change via `AppRate#setInstallDays(int)`.
2. App is launched more than 10 times. Change via `AppRate#setLaunchTimes(int)`.
3. App is launched more than 2 days after neutral button clicked. Change via `AppRate#setRemindInterval(int)`.
4. App shows neutral dialog(Remind me later) by default. Change via `setShowLaterButton(boolean)`.
5. To specify the callback when the button is pressed. The same value as the second argument of `DialogInterface.OnClickListener#onClick` will be passed in the argument of `onClickButton`.
6. Setting `AppRate#setDebug(boolean)` will ensure that the rating request is shown each time the app is launched. **This feature is only development!**.
### Clear show dialog flag
When you want to show the dialog again, call `AppRate#clearAgreeShowDialog()`.
```java
AppRate.with(this).clearAgreeShowDialog();
```
### When the button presses on
call `AppRate#showRateDialog(Activity)`.
```java
AppRate.with(this).showRateDialog(this);
```
### Set custom view
call `AppRate#setView(View)`.
```java
LayoutInflater inflater = (LayoutInflater)this.getSystemService(LAYOUT_INFLATER_SERVICE);
View view = inflater.inflate(R.layout.custom_dialog, (ViewGroup)findViewById(R.id.layout_root));
AppRate.with(this).setView(view).monitor();
```
### Custom dialog
If you want to use your own dialog labels, override string xml resources on your application.
```xml
Rate this app
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!
Rate It Now
Remind Me Later
No, Thanks
```
## Language
Android-Rate currently supports the following languages:
- English
- Czech
- German
- Spanish
- Basque
- Persian
- French
- Italy
- Hebrew
- Japanese
- Korean
- Polish
- Portuguese
- Russian
- Turkish
- Ukrainian
- Vietnamese
- Chinese
## Support
Android-Rate supports API level 9 and up.
## Sample
Please try to move the [sample](https://github.com/hotchemi/Android-Rate/tree/master/sample).
## Contribute
1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Added some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request