Skip to content
This repository has been archived by the owner on May 12, 2021. It is now read-only.
/ RateMyApp Public archive

An Android module to kindly ask users to rate your application

License

Notifications You must be signed in to change notification settings

mariosangiorgio/RateMyApp

Repository files navigation

RateMyApp

An Android module to kindly ask users to rate your application.

Build Status

alt tag

Basically, asks the user before he goes to Play Store if they will rate the app with 1-3 stars or 4-5.

1-3: ask them to send an email with feedback and DOESN'T TAKE THEM TO PLAY STORE 4-5: send them to Play Store normally

Include in project.

You can embed RateMyApp in your application either by downloading and including the library or (better) by declearing it as a dependency.

    dependencies {
        compile 'com.mariosangiorgio:RateMyApp:1.4.0'
    }

ChangeLog

Version 1.4

  • Adds ShowFragmentActionFactory. This can help implementers customize the first action
  • Adds the ability to customize email subject and add an email message.
  • Removes unnecessary appcompat dependency.

Version 1.2.2-1.3

  • Removed memory leak by removing hard reference to Activities. appLaunched() and build() do not hold references to your activity.

Example

On your main activity you will need to override in the following wat the onCreate and onSaveInstanceState methods;

@Override
public void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);

    /*
     * Do here other things you need to do on creation
     */

    if(savedInstanceState == null ) { // This null guard protects us from calling appLaunched on rotation.
        RateMyAppBuilder builder = new RateMyAppBuilder();
        builder.setLaunchesBeforeAlert(3);  // Optional
        builder.setDaysBeforeAlert(7);      // Optional
        builder.setEmailAddress("[email protected]");   // Optional. It will enable two-phase rating request

        RateMyApp rateMyApp = builder.build(this);
        rateMyApp.appLaunched(this);
    }
}

Languages

RateMyApp currently supports the following languages:

  • English (default)
  • Italian
  • German (thanks to bigjan)
  • Slovak (thanks to pylerSM)
  • Traditional Chinese (Taiwan) (thanks to Aerotinge)
  • Portuguese (thanks to RaphaDroid)

Customize Strings

If you want to customize any of the message strings you can do it easily with Android default resource override

Build Yourself

Please note that if you want to compile the library by yourself you need to provide values for the signing.password and for sonatypePassword variables. You can either add them (with fake values, the real ones are needed only if you want to publish the library to maven central) to gradle.properties or pass them from the command line (by adding -Psigning.password=SECRET -PsonatypePassword=SECRET to the gradle invocation).

About

An Android module to kindly ask users to rate your application

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published