JarCastingSubtleRater
Discreet AppRater for Android
Inspired by the Discreen App Rate library, but with more customizations.
Installation
Using gradle, just add this to your dependencies:
compile 'it.sephiroth.android.library.subtlerater:library:+@aar'
Usage
Usage is quite simple. This is a common usage
SubtleRater.Builder builder = new SubtleRater.Builder( this );
builder.withListener( this );
builder.withDelay( 500 );
builder.hideAfter( 3000 );
builder.withPolicy(
new RetryPolicy.Builder( RetryPolicy.Policy.INCREMENTAL )
.launchCount( 2 )
.retryDelay( ONE_WEEK ).build()
);
SubtleRater mRater = builder.build();
mRater.show();
If auto hide is set ( using hideAfter ), then the view will be automatically hidden after a certain amount of time, otherwise you should call manually:
mRater.hide();
In order to understand the available policies which can be used with the withPolicy method:
The RetryPolicy builder has the following methods:
-
RetryPolicy( Policy ): is the constructor and the required policy enum has the following fields:
- NONE: After the view has been shown to the user, it will never appear again.
- INCREMENTAL: Will retry each time the initial count has been triggered (2, 4, 6, 8...)
- EXPONENTIAL: Will retry exponentially to be less intrusive (2, 4, 8, 16...)
-
launchCount( long count ): After how many invocations the user will be notified
-
retryDelay( long ms ): To be used with INCREMENTAL or EXPONENTIAL. If set, once the SubtleRater is hidden without user interaction ( hideAfter is > 0 or hide is called manually ), a subsequent invocation of the show method will first check if enough time has passed before start checking the launchCount again. Use this to be less intrusive to your users.
Customization
The rater View/Animation can be customized using the Builder's methods withContent, inAnimation, outAnimation. Also the parent ViewGroup can be set ( otherwise the activity root will be used ).
For a more detailed example, see the demo application included.
