Smart Rate

Smart rate is a library that helps you improve your app's rating and get user feedback, inspired by Smart App Rate library.

Demo

See demo app on Google Play

Features

• Auto-fetch app icon to display it in the dialog
• Appears after the specified session count
• Redirects to the app store (see below), if the given rating is greater then minimal value, specified by you
• Shows the feedback form (with callback to your code), if rating is below then specified
• Supports multiple app stores:
  • Google Play
  • Amazon
  • Xiaomi (currently link is duplicate of Google Play)
  • Samsung
  • Huawei App Gallery
  • Custom link
• Prompts for rating later after given amount of sessions (if user clicked «Later»)
• Customizable texts (all!). Two default translations provided — English and Russian.
• Customizable text and buttons colors
• Size is about ~217 KB

Limitations

• Minimum SDK version is 21
• App must use Material Components theme

Installation

Add dependency to your module's (usually app/build.gradle) build.gradle and sync:

implementation 'com.g2pdev:smartrate:(insert latest version)'

Set up

Please note that upgrade from 1.x to 2.x will reset all library preferences.

Initialize the library

In your Application.onCreate() method call:

SmartRate.init(this)

For example:

class App : Application() {
    override fun onCreate() {
        super.onCreate()
        
        SmartRate.init(this)    
    }
}

Note: calling SmartRate.init() with context other than Application will cause exception.

Show dialog

With default config

In your Activity.onCreate() call SmartRate.show(this):

class MainActivity: AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        
        SmartRate.show(this)
    }
}

See values of default config in Config section.

With custom config

Call method SmartRate.show(this, config):

class MainActivity: AppCompatActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        
        val config = SmartRateConfig().apply {
                            // ... 
        }
        
        SmartRate.show(this, config)
    }
}

See config section below.

Config

Configuration is represented by class SmartRateConfig.

For better AppGallery compatibility the AppID can be set to the store:

store = Store.APP_GALLERY.setAppId("numeric_app_id_from_huawei")

Listeners are also located in the config:

Configuring is pretty easy — just create the default config and then modify it using, for example apply():

val config = SmartRateConfig()
            .apply {
                minSessionCount = 10
                minRatingForStore = 3.5f
            }
           
// ...

Proguard

Not needed — rules are included in library.

TODO

• Test Xiaomi app store
• Add Aptoide

Internals

This library uses:

• Kotlin
• Dagger 2 for dependency injection
• RxJava 2 for Reactive programming
• Moxy for MVP implementation
• Gson for cache values serialization
• Timber for logging (disabled in production)
• LeakCanary for leaks detection (disabled in production)

I believe it's implemented following the Clean Architecture principles. This implementation probably seems over-engineered for such simple task, but, on the other hand, it's pretty testable and extensible.

Tests

All interactors, repository and some caches are covered by tests (see tests)

UI is also almost fully covered by tests with Espresso (see tests)

Code style

Code style is automatically checked by Spotless and ktlint. Check out my post about it on Medium.

CI/CD

Every pull request to master is checked by Travis CI.

When pull request to master is merged and some tag is pushed, Travis CI:

• Builds library and uploads it to Bintray
• Builds APK, signs it and uploads to Google Play using Fastlane Supply
• Builds APK and uploads it to Github Releases

Contributions

Any contributions, including translations, are highly appreciated.

Please, report any issues here.

Credits

This library is inspired by Smart App Rate.

Fallback rate icon made by Freepik.

Author: Artem Smirnov.

License

Copyright (C) 2020 Artem Smirnov

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.