Release 1.2.1 Osaka

CHANGELOG.md

@@ -1,7 +1,38 @@
 # CHANGELOG
 
-## 1.2.1 Osaka (next release)
-
+## 1.2.1 Osaka (released 13.09.2018)
+
+- LIBcc20913 Javadoc documentation updated
+- LIBcc10913 Inspection
+- LIBff10913 .setTimeToWait(...) and .setRemindTimeToWait(...) added
+- LIBff10912 .setVersionCodeCheck(boolean) and .setVersionNameCheck(boolean) added
+- LIBcc20912 AppInformation.java refactoring
+- LIBcc10912 AppInformation.java refactoring
+- LIBcc50908 .idea files updated
+- LIBcc40908 sample app updated
+- LIBcc30908 README.md updated
+- LIBcc20908 AppRate.java inspection
+- LIBcc10908 getAppCompatDialogBuilder(...) and getDialogBuilder(...) updated
+- LIBff10908 AppInformation Class added
+- LIBff70905 AppRate#setRemindLaunchesNumber(byte) added
+- LIBff60905 clearRemindButtonClick() added
+- LIBff50905 Romanian language added
+- LIBff40905 Norwegian language added
+- LIBff30905 Malay language added
+- LIBff20905 Hindi languages added
+- LIBff10905 Android Library launcher icon added
+- LIBcc30905 README.md updated
+- LIBcc20905 Copyright corrected
+- LIBbb30905 AppCompatDialogManager and DefaultDialogManager singletons don't set context in synchronized(...){}
+- LIBbb20905 Add SoftReference to OnClickButtonListener [hotchemi/Android-Rate#79](https://github.com/hotchemi/Android-Rate/issues/79)
+- LIBbb10905 Remove WeekReference to OnClickButtonListener [hotchemi/Android-Rate#115](https://github.com/hotchemi/Android-Rate/issues/115)
+- LIBcc10905 "Latest snapshot (non-tested) version" section added
+- LIBff30904 AppCompatDialogManager example of use added
+- LIBff20904 isOverRemindDate() optimization
+- LIBcc20904 badge updated
+- LIBcc10904 javadoc and documentation updated
+- LIBff10904 AppCompatDialogManager added
+- LIBff10831 Dialog type added
 - LIBcc50831 Next release
 
 ## 1.2.0 Yokohama (released 31.08.2018)

README.md

@@ -56,7 +56,7 @@ If you don't want to wait for the next release, you can add the Sonatype's snaps
 Then add the following dependency to your relevant project modules `build.gradle` files:
 
     dependencies {
-        implementation "com.vorlonsoft:androidrate:1.2.1-SNAPSHOT"
+        implementation "com.vorlonsoft:androidrate:1.2.2-SNAPSHOT"
     }
 
 ## Usage
@@ -92,7 +92,7 @@ protected void onCreate(Bundle savedInstanceState) {
       .setInstallDays((byte) 0)                  // default is 10, 0 means install day, 10 means app is launched 10 or more days later than installation
       .setLaunchTimes((byte) 3)                  // default is 10, 3 means app is launched 3 or more times
       .setRemindInterval((byte) 1)               // default is 1, 1 means app is launched 1 or more days after neutral button clicked
-      // Since Release 1.2.1: .setRemindLaunchesNumber((byte) 1)         // default is 0, 1 means app is launched 1 or more times after neutral button clicked
+      .setRemindLaunchesNumber((byte) 1)         // default is 0, 1 means app is launched 1 or more times after neutral button clicked
       .monitor();                                // Monitors app launch times
   AppRate.showRateDialogIfMeetsConditions(this); // Shows the Rate Dialog when conditions are met
 }
@@ -115,15 +115,15 @@ protected void onCreate(Bundle savedInstanceState) {
                                            *         setStoreType(APPLE, long) (Apple App Store, long - your application ID),
                                            *         setStoreType(String...) (Any other store/stores, String... - an URI or array of URIs to your app) and
                                            *         setStoreType(Intent...) (Any custom intent/intents, Intent... - an intent or array of intents) */
-      .setInstallDays((byte) 0)           // default is 10, 0 means install day, 10 means app is launched 10 or more days later than installation
+      .setTimeToWait(Time.DAY, (short) 0) // default is 10 days, 0 means install millisecond, 10 means app is launched 10 or more time units later than installation
       .setLaunchTimes((byte) 3)           // default is 10, 3 means app is launched 3 or more times
-      .setRemindInterval((byte) 1)        // default is 1, 1 means app is launched 1 or more days after neutral button clicked
-      // Since Release 1.2.1: .setRemindLaunchesNumber((byte) 1)  // default is 0, 1 means app is launched 1 or more times after neutral button clicked
+      .setRemindTimeToWait(Time.DAY, (short) 2) // default is 1 day, 1 means app is launched 1 or more time units after neutral button clicked
+      .setRemindLaunchesNumber((byte) 1)  // default is 0, 1 means app is launched 1 or more times after neutral button clicked
       .setSelectedAppLaunches((byte) 1)   // default is 1, 1 means each launch, 2 means every 2nd launch, 3 means every 3rd launch, etc
       .setShowLaterButton(true)           // default is true, true means to show the Neutral button ("Remind me later").
       .set365DayPeriodMaxNumberDialogLaunchTimes((short) 3) // default is unlimited, 3 means 3 or less occurrences of the display of the Rate Dialog within a 365-day period
-      // Since Release 1.2.1: .setVersionCodeCheck(true)          // default is false, true means to re-enable the Rate Dialog if a new version of app with different version code is installed
-      // Since Release 1.2.1: .setVersionNameCheck(true)          // default is false, true means to re-enable the Rate Dialog if a new version of app with different version name is installed
+      .setVersionCodeCheck(true)          // default is false, true means to re-enable the Rate Dialog if a new version of app with different version code is installed
+      .setVersionNameCheck(true)          // default is false, true means to re-enable the Rate Dialog if a new version of app with different version name is installed
       .setDebug(false)                    // default is false, true is for development only, true ensures that the Rate Dialog will be shown each time the app is launched
       .setOnClickButtonListener(which -> Log.d(this.getLocalClassName(), Byte.toString(which))) // Java 8+, change for Java 7-
       .monitor();                         // Monitors the app launch times
@@ -141,15 +141,15 @@ protected void onCreate(Bundle savedInstanceState) {
 Default options of the Rate Dialog are as below:
 
 1. Google Play launches when you press the positive button. Change via `AppRate#setStoreType(int)`, `AppRate#setStoreType(int, long)`, `AppRate#setStoreType(String...)` or `AppRate#setStoreType(Intent...)`.
-2. App is launched 10 or more days later than installation. Change via `AppRate#setInstallDays(byte)`.
+2. App is launched 10 or more days later than installation. Change via `AppRate#setTimeToWait(long, short)` or `AppRate#setInstallDays(byte)`.
 3. App is launched 10 or more times. Change via `AppRate#setLaunchTimes(byte)`.
-4. App is launched 1 or more days after neutral button clicked. Change via `AppRate#setRemindInterval(byte)`.
-Since Release 1.2.1: 5. App is launched 0 or more times after neutral button clicked. Change via `AppRate#setRemindLaunchesNumber(byte)`.
+4. App is launched 1 or more days after neutral button clicked. Change via `AppRate#setRemindTimeToWait(long, short)` or `AppRate#setRemindInterval(byte)`.
+5. App is launched 0 or more times after neutral button clicked. Change via `AppRate#setRemindLaunchesNumber(byte)`.
 6. Each launch (the condition is satisfied if appLaunches % `param` == 0). Change via `AppRate#setSelectedAppLaunches(byte)`.
 7. App shows the Neutral button ("Remind me later"). Change via `setShowLaterButton(boolean)`.
 8. Unlimited occurrences of the display of the Rate Dialog within a 365-day period. Change via `AppRate#set365DayPeriodMaxNumberDialogLaunchTimes(short)`.
-Since Release 1.2.1: 9. Don't re-enable the Rate Dialog if a new version of app with different version code is installed. Change via `AppRate#setVersionCodeCheck(boolean)`.
-Since Release 1.2.1: 10. Don't re-enable the Rate Dialog if a new version of app with different version name is installed. Change via `AppRate#setVersionNameCheck(boolean)`.
+9. Don't re-enable the Rate Dialog if a new version of app with different version code is installed. Change via `AppRate#setVersionCodeCheck(boolean)`.
+10. Don't re-enable the Rate Dialog if a new version of app with different version name is installed. Change via `AppRate#setVersionNameCheck(boolean)`.
 11. Setting `AppRate#setDebug(boolean)` to `true` ensures that the Rate Dialog will be shown each time the app is launched. **This feature is for development only!**.
 12. There is no default callback when the button of Rate Dialog is pressed. Change via `AppRate.with(this).setOnClickButtonListener(OnClickButtonListener)`.
 

gradle.properties

@@ -14,7 +14,7 @@ android.enableR8            = true
 android.useAndroidX         = true
 
 GROUP                       = com.vorlonsoft
-VERSION_NAME                = 1.2.1-SNAPSHOT
+VERSION_NAME                = 1.2.1
 VERSION_CODE                = 45
 
 POM_DESCRIPTION             = Library to help you promote your Android app by prompting users to rate the app after using it for a few days.

javadoc/com/vorlonsoft/android/rate/AppRate.html

@@ -117,7 +117,7 @@ <h2 title="Class AppRate" class="title">Class AppRate</h2>
 <dt><span class="simpleTagLabel">Since:</span></dt>
 <dd>0.0.4</dd>
 <dt><span class="simpleTagLabel">Version:</span></dt>
-<dd>1.2.0</dd>
+<dd>1.2.1</dd>
 <dt><span class="simpleTagLabel">Author:</span></dt>
 <dd>Alexander Savin, Shintaro Katafuchi</dd>
 </dl>

javadoc/com/vorlonsoft/android/rate/DefaultDialogManager.html

@@ -130,7 +130,7 @@ <h2 title="Class DefaultDialogManager" class="title">Class DefaultDialogManager<
 <dt><span class="simpleTagLabel">Since:</span></dt>
 <dd>1.0.2</dd>
 <dt><span class="simpleTagLabel">Version:</span></dt>
-<dd>1.2.0</dd>
+<dd>1.2.1</dd>
 <dt><span class="simpleTagLabel">Author:</span></dt>
 <dd>Alexander Savin, Antoine Vianey</dd>
 <dt><span class="seeLabel">See Also:</span></dt>

javadoc/com/vorlonsoft/android/rate/DialogManager.Factory.html

@@ -119,7 +119,7 @@ <h2 title="Interface DialogManager.Factory" class="title">Interface DialogManage
 <dt><span class="simpleTagLabel">Since:</span></dt>
 <dd>1.0.2</dd>
 <dt><span class="simpleTagLabel">Version:</span></dt>
-<dd>1.2.0</dd>
+<dd>1.2.1</dd>
 <dt><span class="simpleTagLabel">Author:</span></dt>
 <dd>Alexander Savin, Antoine Vianey</dd>
 <dt><span class="seeLabel">See Also:</span></dt>

javadoc/com/vorlonsoft/android/rate/DialogManager.html

@@ -114,7 +114,7 @@ <h2 title="Interface DialogManager" class="title">Interface DialogManager</h2>
 <dt><span class="simpleTagLabel">Since:</span></dt>
 <dd>1.0.2</dd>
 <dt><span class="simpleTagLabel">Version:</span></dt>
-<dd>1.2.0</dd>
+<dd>1.2.1</dd>
 <dt><span class="simpleTagLabel">Author:</span></dt>
 <dd>Alexander Savin, Antoine Vianey</dd>
 <dt><span class="seeLabel">See Also:</span></dt>

javadoc/com/vorlonsoft/android/rate/DialogOptions.html

@@ -116,7 +116,7 @@ <h2 title="Class DialogOptions" class="title">Class DialogOptions</h2>
 <dt><span class="simpleTagLabel">Since:</span></dt>
 <dd>0.5.1</dd>
 <dt><span class="simpleTagLabel">Version:</span></dt>
-<dd>1.2.0</dd>
+<dd>1.2.1</dd>
 <dt><span class="simpleTagLabel">Author:</span></dt>
 <dd>Alexander Savin, Shintaro Katafuchi</dd>
 </dl>

javadoc/com/vorlonsoft/android/rate/OnClickButtonListener.html

@@ -112,7 +112,7 @@ <h2 title="Interface OnClickButtonListener" class="title">Interface OnClickButto
 <dt><span class="simpleTagLabel">Since:</span></dt>
 <dd>0.2.0</dd>
 <dt><span class="simpleTagLabel">Version:</span></dt>
-<dd>1.2.0</dd>
+<dd>1.2.1</dd>
 <dt><span class="simpleTagLabel">Author:</span></dt>
 <dd>Alexander Savin, Shintaro Katafuchi</dd>
 </dl>

javadoc/com/vorlonsoft/android/rate/StoreOptions.html

@@ -110,7 +110,7 @@ <h2 title="Class StoreOptions" class="title">Class StoreOptions</h2>
 <dt><span class="simpleTagLabel">Since:</span></dt>
 <dd>1.1.7</dd>
 <dt><span class="simpleTagLabel">Version:</span></dt>
-<dd>1.2.0</dd>
+<dd>1.2.1</dd>
 <dt><span class="simpleTagLabel">Author:</span></dt>
 <dd>Alexander Savin, Shintaro Katafuchi</dd>
 </dl>

javadoc/com/vorlonsoft/android/rate/StoreType.html

@@ -110,7 +110,7 @@ <h2 title="Class StoreType" class="title">Class StoreType</h2>
 <dt><span class="simpleTagLabel">Since:</span></dt>
 <dd>1.0.0</dd>
 <dt><span class="simpleTagLabel">Version:</span></dt>
-<dd>1.2.0</dd>
+<dd>1.2.1</dd>
 <dt><span class="simpleTagLabel">Author:</span></dt>
 <dd>Alexander Savin, Shintaro Katafuchi</dd>
 </dl>

javadoc/com/vorlonsoft/android/rate/package-summary.html

@@ -231,7 +231,7 @@ <h2 title="Package com.vorlonsoft.android.rate Description">Package com.vorlonso
 <dt><span class="simpleTagLabel">Since:</span></dt>
 <dd>0.0.4</dd>
 <dt><span class="simpleTagLabel">Version:</span></dt>
-<dd>1.2.0</dd>
+<dd>1.2.1</dd>
 <dt><span class="simpleTagLabel">Author:</span></dt>
 <dd>Alexander Savin, Shintaro Katafuchi</dd>
 </dl>

library/src/androidTest/java/com/vorlonsoft/android/rate/UriHelperTest.java

@@ -19,7 +19,7 @@
  * <p>Unit test for {@link com.vorlonsoft.android.rate.UriHelper}</p>
  *
  * @since    0.1.3
- * @version  1.2.0
+ * @version  1.2.1
  * @author   Alexander Savin
  * @author   Shintaro Katafuchi
  */

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

@@ -54,7 +54,7 @@
  * and a fast singleton implementation.</p>
  *
  * @since    0.0.4
- * @version  1.2.0
+ * @version  1.2.1
  * @author   Alexander Savin
  * @author   Shintaro Katafuchi
  */

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

@@ -4,7 +4,7 @@
  * <p>Constants Class - constants class of the AndroidRate library.</p>
  *
  * @since    1.1.8
- * @version  1.2.0
+ * @version  1.2.1
  * @author   Alexander Savin
  */
 
@@ -18,7 +18,7 @@ private Constants() {
      * <p>Constants.Date Class - date constants class of the AndroidRate library.</p>
      *
      * @since    1.1.8
-     * @version  1.2.0
+     * @version  1.2.1
      * @author   Alexander Savin
      */
 
@@ -35,7 +35,7 @@ private Date() {
      * <p>Constants.Utils Class - utils constants class of the AndroidRate library.</p>
      *
      * @since    1.1.8
-     * @version  1.2.0
+     * @version  1.2.1
      * @author   Alexander Savin
      */
 

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

@@ -55,7 +55,7 @@
  * singleton implementation inside library, not outside (protected, not private constructor).</p>
  *
  * @since    1.0.2
- * @version  1.2.0
+ * @version  1.2.1
  * @author   Alexander Savin
  * @author   Antoine Vianey
  * @see DefaultDialogManager.Factory
@@ -294,7 +294,7 @@ public Dialog createDialog() {
      * custom dialog (from v7 AppCompat library etc.).</p>
      *
      * @since    1.0.2
-     * @version  1.2.0
+     * @version  1.2.1
      * @author   Alexander Savin
      * @author   Antoine Vianey
      * @see DialogManager.Factory

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

@@ -16,7 +16,7 @@
  * dialog (from v7 AppCompat library etc.).</p>
  *
  * @since    1.0.2
- * @version  1.2.0
+ * @version  1.2.1
  * @author   Alexander Savin
  * @author   Antoine Vianey
  * @see DialogManager.Factory
@@ -39,7 +39,7 @@ public interface DialogManager {
      * custom dialog (from v7 AppCompat library etc.).</p>
      *
      * @since    1.0.2
-     * @version  1.2.0
+     * @version  1.2.1
      * @author   Alexander Savin
      * @author   Antoine Vianey
      * @see DialogManager

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

@@ -17,7 +17,7 @@
  * <p>DialogOptions Class - dialog options class of the AndroidRate library.</p>
  *
  * @since    0.5.1
- * @version  1.2.0
+ * @version  1.2.1
  * @author   Alexander Savin
  * @author   Shintaro Katafuchi
  */

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

@@ -34,7 +34,7 @@
  * <p>IntentHelper Class - intent helper class of the AndroidRate library.</p>
  *
  * @since    0.5.0
- * @version  1.2.0
+ * @version  1.2.1
  * @author   Alexander Savin
  * @author   Shintaro Katafuchi
  */

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

@@ -15,7 +15,7 @@
  * will be passed in the argument of {@link OnClickButtonListener#onClickButton}.</p>
  *
  * @since    0.2.0
- * @version  1.2.0
+ * @version  1.2.1
  * @author   Alexander Savin
  * @author   Shintaro Katafuchi
  */

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

@@ -17,7 +17,7 @@
  * <p>PreferenceHelper Class - preference helper class of the AndroidRate library.</p>
  *
  * @since    0.1.3
- * @version  1.2.0
+ * @version  1.2.1
  * @author   Alexander Savin
  * @author   Shintaro Katafuchi
  */

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

@@ -19,7 +19,7 @@
  * <p>StoreOptions Class - store options class of the AndroidRate library.</p>
  *
  * @since    1.1.7
- * @version  1.2.0
+ * @version  1.2.1
  * @author   Alexander Savin
  * @author   Shintaro Katafuchi
  */

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

@@ -17,7 +17,7 @@
  * <p>StoreType Class - store type class of the AndroidRate library.</p>
  *
  * @since    1.0.0
- * @version  1.2.0
+ * @version  1.2.1
  * @author   Alexander Savin
  * @author   Shintaro Katafuchi
  */

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

@@ -26,7 +26,7 @@
  * <p>UriHelper Class - uri helper class of the AndroidRate library.</p>
  *
  * @since    0.1.3
- * @version  1.2.0
+ * @version  1.2.1
  * @author   Alexander Savin
  * @author   Shintaro Katafuchi
  */

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

@@ -26,7 +26,7 @@
  * <p>Utils Class - utils class of the AndroidRate library.</p>
  *
  * @since    0.5.0
- * @version  1.2.0
+ * @version  1.2.1
  * @author   Alexander Savin
  * @author   Shintaro Katafuchi
  */

library/src/main/java/com/vorlonsoft/android/rate/package-info.java

@@ -10,7 +10,7 @@
  * users to rate the app after using it for a few days.</p>
  *
  * @since    0.0.4
- * @version  1.2.0
+ * @version  1.2.1
  * @author   Alexander Savin
  * @author   Shintaro Katafuchi
  */