Release 4.3.0

Author: ashley-campbell-iovation

README.html

@@ -36,19 +36,19 @@ <h2 id="androidintegrationfilesandrequirements">Android Integration Files and Re
 <tbody>
 <tr>
 	<td> <strong>SDK Filename</strong>    </td>
-	<td> fraudforce-lib-release-4.2.0.aar                     </td>
+	<td> fraudforce-lib-release-4.3.0.aar                     </td>
 </tr>
 <tr>
 	<td> <strong>Version</strong>      </td>
-	<td> 4.2.0                            </td>
+	<td> 4.3.0                            </td>
 </tr>
 <tr>
 	<td> <strong>Package</strong>      </td>
 	<td> com.iovation.mobile.android.FraudForce                   </td>
 </tr>
 <tr>
 	<td> <strong>Android SDK Dependencies</strong> </td>
-	<td> Android SDK 4.1 or higher (SDK level 16)                   </td>
+	<td> Android SDK 5.0 or higher (SDK level 21)                   </td>
 </tr>
 <tr>
 	<td> <strong>Library Dependencies</strong>  </td>
@@ -70,22 +70,23 @@ <h2 id="androidintegrationfilesandrequirements">Android Integration Files and Re
 </table>
 
 <blockquote>
+<p><strong>NOTE</strong> Regarding Android 11 background location changes: The FraudForce SDK neither requires nor requests location when the application is in a background state.</p>
 <p><strong>NOTE</strong> If the permissions listed are not required by the application, the values collected using those permissions will be ignored. The permissions are not required to obtain a usable blackbox, but they do help obtain some unique device information.</p>
 <p><strong>NOTE</strong> Android 10 introduced the ACCESS_BACKGROUND_LOCATION permission, protected at the dangerous level as is the case for ACCESS_FINE_LOCATION. Refer to the official Android documentation for when and how to incorporate this permission.</p>
 </blockquote>
 
-<p>Version 4.2.0 of the iovation FraudForce SDK for Android supports Android 4.1 or higher.</p>
+<p>Version 4.3.0 of the iovation FraudForce SDK for Android supports Android 5.0 or higher.</p>
 
 <h2 id="installingthefraudforcesdkforandroid">Installing the FraudForce SDK for Android</h2>
 
 <ol>
-<li><p>Download iovation-android-sdk-4.2.0.zip from here: <a href="https://github.com/iovation/deviceprint-SDK-Android">iovation Mobile SDK for Android</a>. </p></li>
-<li><p>Unzip iovation-android-sdk-4.2.0.zip.</p></li>
+<li><p>Download iovation-android-sdk-4.3.0.zip from here: <a href="https://github.com/iovation/deviceprint-SDK-Android">iovation Mobile SDK for Android</a>. </p></li>
+<li><p>Unzip iovation-android-sdk-4.3.0.zip.</p></li>
 <li><p>Depending on your IDE, do one of the following:</p>
 
 <ul>
 <li><p>In <strong>Eclipse and Maven</strong>, deploy the AAR file to your local Maven repository, using maven-deploy. For more information, see <a href="http://maven.apache.org/guides/mini/guide-3rd-party-jars-local.html">Guide to installing 3rd party JARs</a>.</p></li>
-<li><p>If you are using <strong>Android Studio with Gradle</strong>, add the <em>fraudforce-lib-release-4.2.0.aar</em> file to your application module&#8217;s libs directory. Then, edit the <em>build.gradle</em> file in order to add the libs directory as a flat-file repository to the <code>buildscript</code> and <code>repository</code> sections. This makes the fraudforce-lib-release-4.2.0.aar file accessible to Gradle.</p>
+<li><p>If you are using <strong>Android Studio with Gradle</strong>, add the <em>fraudforce-lib-release-4.3.0.aar</em> file to your application module&#8217;s libs directory. Then, edit the <em>build.gradle</em> file in order to add the libs directory as a flat-file repository to the <code>buildscript</code> and <code>repository</code> sections. This makes the fraudforce-lib-release-4.3.0.aar file accessible to Gradle.</p>
 
 <pre><code>buildscript {
     repositories {
@@ -102,11 +103,11 @@ <h2 id="installingthefraudforcesdkforandroid">Installing the FraudForce SDK for
 }
 </code></pre>
 
-<p>Also in the application module&#8217;s <code>build.gradle</code> file, make sure that fraudforce-lib-release-4.2.0 is a compile-time dependency:</p>
+<p>Also in the application module&#8217;s <code>build.gradle</code> file, make sure that fraudforce-lib-release-4.3.0 is a compile-time dependency:</p>
 
 <pre><code>dependencies {
     compile fileTree(dir: 'libs', include: ['*.jar'])
-    compile(name:'fraudforce-lib-release-4.2.0', ext:'aar')
+    compile(name:'fraudforce-lib-release-4.3.0', ext:'aar')
 }
 </code></pre>
 
@@ -149,7 +150,7 @@ <h2 id="integratingintonativeapps">Integrating into Native Apps</h2>
     .enableNetworkCalls(true) // Defaults to false if left out of configuration
     .build();
 </code></pre></li>
-<li><p>Initialize the FraudForceManager class using the generated FraudForceConfiguration object, and the context.</p>
+<li><p>Initialize the FraudForceManager class using the generated FraudForceConfiguration object, and the application context.</p>
 
 <pre><code>FraudForceManager fraudForceManager = FraudForceManager.getInstance();
 fraudForceManager.initialize(configuration, context);
@@ -158,6 +159,7 @@ <h2 id="integratingintonativeapps">Integrating into Native Apps</h2>
 
 <blockquote>
 <p><strong>NOTE</strong>: This method calls updates the geolocation and network information, if enabled.</p>
+<p><strong>NOTE</strong>: As with initialization, pass the application context when refreshing.</p>
 </blockquote>
 
 <pre><code>FraudForceManager.getInstance().refresh(context);
@@ -229,7 +231,7 @@ <h3 id="implementinghybridappsupport">Implementing Hybrid App Support</h3>
     .enableNetworkCalls(true) // Defaults to false if left out of configuration
     .build();
 </code></pre></li>
-<li><p>Initialize the FraudForceManager class using the generated FraudForceConfiguration object, and the context.</p>
+<li><p>Initialize the FraudForceManager class using the generated FraudForceConfiguration object, and the application context.</p>
 
 <pre><code>FraudForceManager fraudForceManager = FraudForceManager.getInstance();
 fraudForceManager.initialize(configuration, context);
@@ -288,7 +290,7 @@ <h2 id="compilingthesampleappinandroidstudio">Compiling The Sample App in Androi
 
 <ol>
 <li><p>In Android Studio, select File | Open or click <strong>Open Existing Android Studio Project</strong> from the quick-start screen.</p></li>
-<li><p>From the directory where you unzipped fraudforce-lib-release-4.2.0.zip, open the <strong>android-studio-sample-app</strong> directory.</p></li>
+<li><p>From the directory where you unzipped fraudforce-lib-release-4.3.0.zip, open the <strong>android-studio-sample-app</strong> directory.</p></li>
 <li><p>In the project navigation view, open <code>src/main/java/com/iovation/mobile/android/sample/MainActivity.java</code></p></li>
 <li><p>Right-click the file editing view and select <em>Run Main Activity</em>.</p>
 
@@ -303,11 +305,19 @@ <h2 id="compilingthesampleappinandroidstudio">Compiling The Sample App in Androi
 
 <h2 id="changelog">Changelog</h2>
 
+<h3 id="4.3.0">4.3.0</h3>
+
+<ul>
+    <li><p>Minimum supported Android version updated, from 16 to 21.</p></li>
+    <li><p>Update target and compilation SDK versions to 30.</p></li>
+    <li><p>Bug fixes for NPEs sometimes encountered during asynchronous calls to initialize and/or refresh.</p></li>
+</ul>
+
 <h3 id="4.2.0">4.2.0</h3>
 
 <ul>
     <li><p>Several obfuscation-related updates/fixes, including preservation of base package.</p></li>
-    <li><p>Update target SDK to 29</p></li>
+    <li><p>Update target SDK to 29.</p></li>
 </ul>
 
 

README.md

@@ -17,33 +17,35 @@ The iovation FraudForce SDK integrates with native and hybrid apps. Hybrid apps
 
 |                                 |                                                                                                                   |
 |---------------------------------|-------------------------------------------------------------------------------------------------------------------|
-| **SDK Filename**                | fraudforce-lib-release-4.2.0.aar                                                                                  |
-| **Version**                     | 4.2.0                                                                                                             |
+| **SDK Filename**                | fraudforce-lib-release-4.3.0.aar                                                                                  |
+| **Version**                     | 4.3.0                                                                                                             |
 | **Package**                     | com.iovation.mobile.android.FraudForce                                                                            |
-| **Android SDK Dependencies**    | Android SDK 4.1 or higher (SDK level 16)                                                                          |
+| **Android SDK Dependencies**    | Android SDK 5.0 or higher (SDK level 21)                                                                          |
 | **Library Dependencies**        | None                                                                                                              |
 | **Required Permissions**        | None                                                                                                              |
 | **Optional Permissions**        | BLUETOOTH, CAMERA, ACCESS\_WIFI\_STATE, READ\_PHONE\_STATE, ACCESS\_FINE\_LOCATION, ACCESS\_BACKGROUND\_LOCATION, |
 |                                 | GET\_ACCOUNTS, ACCESS\_NETWORK\_STATE                                                                             |
 | **Supported NDK Architectures** | x86, x86_64, arm64-v8a, armeabi-v7a                                                                               |
 
+> __NOTE__ Regarding Android 11 background location changes: The FraudForce SDK neither requires nor requests location when the application is in a background state.
+
 > __NOTE__ If the permissions listed are not required by the application, the values collected using those permissions will be ignored. The permissions are not required to obtain a usable blackbox, but they do help obtain some unique device information.
 
 > __NOTE__ Android 10 introduced the ACCESS_BACKGROUND_LOCATION permission, protected at the dangerous level as is the case for ACCESS_FINE_LOCATION. Refer to the official Android documentation for when to incorporate this permission.
 
-Version 4.2.0 of the iovation FraudForce SDK for Android supports Android 4.1 or higher.
+Version 4.3.0 of the iovation FraudForce SDK for Android supports Android 5.0 or higher.
 
 ## Installing the FraudForce SDK for Android
 
-1.  Download iovation-android-sdk-4.2.0.zip from here: [iovation Mobile SDK for Android](https://github.com/iovation/deviceprint-SDK-Android). 
+1.  Download iovation-android-sdk-4.3.0.zip from here: [iovation Mobile SDK for Android](https://github.com/iovation/deviceprint-SDK-Android). 
 
-2.  Unzip iovation-android-sdk-4.2.0.zip.
+2.  Unzip iovation-android-sdk-4.3.0.zip.
 
 3.  Depending on your IDE, do one of the following:
 
 	- In __Eclipse and Maven__, deploy the AAR file to your local Maven repository, using maven-deploy. For more information, see [Guide to installing 3rd party JARs](http://maven.apache.org/guides/mini/guide-3rd-party-jars-local.html).
 
-	- If you are using __Android Studio with Gradle__, add the *fraudforce-lib-release-4.2.0.aar* file to your application module's libs directory. Then, edit the *build.gradle* file in order to add the libs directory as a flat-file repository to the `buildscript` and `repository` sections. This makes the fraudforce-lib-release-4.2.0.aar file accessible to Gradle.
+	- If you are using __Android Studio with Gradle__, add the *fraudforce-lib-release-4.3.0.aar* file to your application module's libs directory. Then, edit the *build.gradle* file in order to add the libs directory as a flat-file repository to the `buildscript` and `repository` sections. This makes the fraudforce-lib-release-4.3.0.aar file accessible to Gradle.
 
 		```
         buildscript {
@@ -60,12 +62,12 @@ Version 4.2.0 of the iovation FraudForce SDK for Android supports Android 4.1 or
             }
         }
 		```
-		Also in the application module's `build.gradle` file, make sure that fraudforce-lib-release-4.2.0 is a compile-time dependency:
+		Also in the application module's `build.gradle` file, make sure that fraudforce-lib-release-4.3.0 is a compile-time dependency:
 
 		```
         dependencies {
             compile fileTree(dir: 'libs', include: ['*.jar'])
-            compile(name:'fraudforce-lib-release-4.2.0', ext:'aar')
+            compile(name:'fraudforce-lib-release-4.3.0', ext:'aar')
         }
 		```
 		
@@ -103,7 +105,7 @@ To integrate into native apps:
         .build();
     ```
 
-3. Initialize the FraudForceManager class using the generated FraudForceConfiguration object, and the context.
+3. Initialize the FraudForceManager class using the generated FraudForceConfiguration object, and the application context.
 
     ```
     FraudForceManager fraudForceManager = FraudForceManager.getInstance();
@@ -114,6 +116,8 @@ To integrate into native apps:
 
     > __NOTE__: This method calls updates the geolocation and network information, if enabled.
 
+    > __NOTE__: As with initialization, pass the application context when refreshing.
+
     ```
     FraudForceManager.getInstance().refresh(context);
     ```
@@ -179,7 +183,7 @@ Integrate into hybrid apps by implementing the following workflow for collecting
         .build();
     ```
 
-3. Initialize the FraudForceManager class using the generated FraudForceConfiguration object, and the context.
+3. Initialize the FraudForceManager class using the generated FraudForceConfiguration object, and the application context.
 
     ```
     FraudForceManager fraudForceManager = FraudForceManager.getInstance();
@@ -239,7 +243,7 @@ The SDK includes the ability to make a network call to iovation's service. This
 
 1 In Android Studio, select File | Open or click **Open Existing Android Studio Project** from the quick-start screen.
 
-2. From the directory where you unzipped fraudforce-lib-release-4.2.0.zip, open the **android-studio-sample-app** directory.
+2. From the directory where you unzipped fraudforce-lib-release-4.3.0.zip, open the **android-studio-sample-app** directory.
 
 3. In the project navigation view, open `src/main/java/com/iovation/mobile/android/sample/MainActivity.java`
 
@@ -255,6 +259,12 @@ The SDK includes the ability to make a network call to iovation's service. This
 
 ## Changelog
 
+### 4.3.0
+
+- Minimum supported Android version updated, from 16 to 21.
+- Update target and compilation SDK versions to 30.
+- Bug fixes for NPEs sometimes encountered during asynchronous calls to initialize and/or refresh.
+
 ### 4.2.0
 
 - Several obfuscation-related updates/fixes, including preservation of base package.

android-studio-sample-app/app/build.gradle

@@ -1,14 +1,14 @@
 apply plugin: 'com.android.application'
 
 android {
-    compileSdkVersion 29
+    compileSdkVersion 30
 
     defaultConfig {
         applicationId "com.iovation.mobile.android.sample.androidstudiosampleapp"
-        minSdkVersion 16
-        targetSdkVersion 29
+        minSdkVersion 21
+        targetSdkVersion 30
         versionCode 1
-        versionName "4.2.0"
+        versionName "4.3.0"
     }
     buildTypes {
         release {
@@ -43,5 +43,5 @@ repositories {
 
 dependencies {
     api fileTree(dir: 'libs', include: ['*.jar'])
-    api(name:'fraudforce-lib-4.2.0-release', ext:'aar')
+    api(name:'fraudforce-lib-release-4.3.0', ext:'aar')
 }

android-studio-sample-app/app/libs/fraudforce-lib-4.2.0-release.aar

@@ -8,7 +8,7 @@ buildscript {
         google()
     }
     dependencies {
-        classpath 'com.android.tools.build:gradle:3.6.3'
+        classpath 'com.android.tools.build:gradle:4.0.2'
 
         // NOTE: Do not place your application dependencies here; they belong
         // in the individual module build.gradle files

android-studio-sample-app/app/libs/fraudforce-lib-release-4.3.0.aar

@@ -1,6 +1,6 @@
-#Mon Nov 06 13:04:02 PST 2017
+#Mon Nov 09 08:29:48 PST 2020
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-5.1.1-all.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-6.1.1-all.zip