LIBcc10508

Author: AlexanderLS

README.md

@@ -1,7 +1,7 @@
 AndroidRate
 ============
 
-AndroidRate is a library to help you promote your android app by prompting users to rate the app after using it for a few days. Original project [Android-Rate](https://github.com/hotchemi/Android-Rate) (The MIT License (MIT)) was developed by Shintaro Katafuchi.
+AndroidRate is a library to help you promote your android app by prompting users to rate the app after using it for a few days. Project based on [Android-Rate](https://github.com/hotchemi/Android-Rate) by Shintaro Katafuchi.
 
 ![screen shot](http://i.gyazo.com/286342ba215a515f2f443a7ce996cc92.gif)
 
@@ -20,6 +20,23 @@ dependencies {
 
 ## Usage
 
+### Simple Configuration
+
+```java
+@Override
+protected void onCreate(Bundle savedInstanceState) {
+  super.onCreate(savedInstanceState);
+  setContentView(R.layout.activity_main);
+
+  AppRate.with(this)
+      .setInstallDays((byte) 0)           // default 10, 0 means install day
+      .setLaunchTimes((byte) 3)           // default 10
+      .monitor();
+
+  AppRate.showRateDialogIfMeetsConditions(this);
+}
+```
+
 ### Configuration
 
 AndroidRate provides methods to configure its behavior.
@@ -172,7 +189,7 @@ AppRate.with(this).setStoreType(StoreType.BLACKBERRY, long); // BlackBerry World
 
 #### Chinese app stores
 
-The first Chinese app store found on the user device will be used. The Library doesn't check the availability of your application on the app store.
+The first Chinese app store found on the user device will be used, if first fails, second will be used, etc. The Library doesn't check the availability of your application on the app store.
 
 ```java
 AppRate.with(this).setStoreType(StoreType.CHINESESTORES); // 19 chinese app stores: 腾讯应用宝, 360手机助手,
@@ -183,20 +200,20 @@ AppRate.with(this).setStoreType(StoreType.CHINESESTORES); // 19 chinese app stor
 #### Other store
 
 ```java
-AppRate.with(this).setStoreType(String); // Any other store,
-                                         // String - an RFC 2396-compliant URI to your app
-                                         // e. g. "https://otherstore.com/app?id=com.yourapp"
-                                         // or "otherstore://apps/com.yourapp"
+AppRate.with(this).setStoreType(String...); // Any other store/stores,
+                                            // String... - an RFC 2396-compliant URI or array of URIs to your app,
+                                            // e. g. "https://otherstore.com/app?id=com.yourapp"
+                                            // or "otherstore://apps/com.yourapp"
 ```
 
-#### Сustom Intents
+### Сustom Intents
 
 You can set custom action to the Rate button. For example, you want to open your custom RateActivity when the Rate button clicked.
 
 ```java
-AppRate.with(this).setStoreType(Intent[]); // Any custom intents, Intent[] - array of intents,
-                                           // first will be executed (startActivity(intents[0])),
-                                           // if first fails, second will be executed (startActivity(intents[1])), etc.
+AppRate.with(this).setStoreType(Intent...); // Any custom intents, Intent... - intent or array of intents,
+                                            // first will be executed (startActivity(intents[0])),
+                                            // if first fails, second will be executed (startActivity(intents[1])), etc.
 ```
 
 ### Check the availability of Google Play
@@ -207,6 +224,12 @@ if (GoogleApiAvailability.getInstance().isGooglePlayServicesAvailable(this) != C
 }
 ```
 
+### Maximum number of the display of the dialog within a 365-day period
+
+```java
+AppRate.with(this).set365DayPeriodMaxNumberDialogLaunchTimes(short);
+```
+
 ## Language
 
 AndroidRate currently supports the following languages:

library/src/main/java/com/vorlonsoft/android/rate/AppRate.java

@@ -275,34 +275,18 @@ public AppRate setStoreType(@StoreType.StoreWithApplicationId final int storeTyp
         return ((storeType != APPLE) && (storeType != BLACKBERRY)) ? setStoreType(storeType, null, null) : setStoreType(storeType, new String[]{String.valueOf(applicationId)}, null);
     }
 
-    @SuppressWarnings({"unused", "ConstantConditions"})
-    public AppRate setStoreType(@NonNull final String uri) {
-        if (uri == null) {
-            throw new IllegalArgumentException("setStoreType(String uri): 'uri' must be != null");
-        }
-        return setStoreType(new String[]{uri});
-    }
-
     @SuppressWarnings({"ConstantConditions", "WeakerAccess"})
-    public AppRate setStoreType(@NonNull final String[] uris) {
+    public AppRate setStoreType(@NonNull final String... uris) {
         if (uris == null) {
-            throw new IllegalArgumentException("setStoreType(String[] uris): 'uris' must be != null");
+            throw new IllegalArgumentException("setStoreType(String... uris): 'uris' must be != null");
         }
         return setStoreType(OTHER, uris, null);
     }
 
-    @SuppressWarnings({"ConstantConditions", "unused"})
-    public AppRate setStoreType(@NonNull final Intent intent) {
-        if (intent == null) {
-            throw new IllegalArgumentException("setStoreType(Intent intent): 'intent' must be != null");
-        }
-        return setStoreType(new Intent[]{intent});
-    }
-
     @SuppressWarnings({"ConstantConditions", "WeakerAccess"})
-    public AppRate setStoreType(@NonNull final Intent[] intents) {
+    public AppRate setStoreType(@NonNull final Intent... intents) {
         if (intents == null) {
-            throw new IllegalArgumentException("setStoreType(Intent[] intents): 'intents' must be != null");
+            throw new IllegalArgumentException("setStoreType(Intent... intents): 'intents' must be != null");
         }
         return setStoreType(INTENT, null, intents);
     }

library/src/main/java/com/vorlonsoft/android/rate/PreferenceHelper.java

@@ -129,7 +129,9 @@ static short get365DayPeriodDialogLaunchTimes(final Context context){
             }
         }
         dialogLaunchTimes = dialogLaunchTimes.replaceAll(":[0-9][0-9]*y[0-9][0-9]*-[0-9][0-9]*:",":");
-        dialogLaunchTimes = dialogLaunchTimes.substring(1, dialogLaunchTimes.length()-1);
+        if (dialogLaunchTimes.length() > 2) {
+            dialogLaunchTimes = dialogLaunchTimes.substring(1, dialogLaunchTimes.length() - 1);
+        }
 
         short dialogLaunchTimesCount = 0;
         final String[] dialogLaunchTimesSplit = dialogLaunchTimes.split(":");

sample/build.gradle

@@ -60,7 +60,7 @@ android {
 }
 dependencies {
     implementation project(':library')
-    implementation 'com.google.android.gms:play-services-base:15.0.0'
+    implementation 'com.google.android.gms:play-services-base:15.0.1'
     debugImplementation 'com.squareup.leakcanary:leakcanary-android:1.5.4'
     releaseImplementation 'com.squareup.leakcanary:leakcanary-android-no-op:1.5.4'
 }