Merge pull request #334 from BlinkID/release/6.12

Release/6.12

Author: i1E

BlinkIDSample/build.gradle

@@ -8,7 +8,7 @@ buildscript {
         google()
     }
     dependencies {
-        classpath 'com.android.tools.build:gradle:8.7.1'
+        classpath 'com.android.tools.build:gradle:8.7.2'
         classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
     }
 }
@@ -25,7 +25,7 @@ allprojects {
 // versions of libraries that all modules require
 
 project.ext {
-    blinkIdVersion = '6.11.2'
+    blinkIdVersion = '6.12.0'
     compileSdkVersion = 34
     targetSdkVersion = 34
     appCompatVersion = '1.7.0'

LibBlinkID-javadoc.jar

@@ -115,7 +115,7 @@ Add _BlinkID_ as a dependency and make sure `transitive` is set to true
 
 ```
 dependencies {
-    implementation('com.microblink:blinkid:6.11.2@aar') {
+    implementation('com.microblink:blinkid:6.12.0@aar') {
         transitive = true
     }
 }
@@ -127,7 +127,7 @@ Android studio should automatically import javadoc from maven dependency. If tha
 
 1. In Android Studio project sidebar, ensure [project view is enabled](https://developer.android.com/studio/projects#ProjectView)
 2. Expand `External Libraries` entry (usually this is the last entry in project view)
-3. Locate `blinkid-6.11.2` entry, right click on it and select `Library Properties...`
+3. Locate `blinkid-6.12.0` entry, right click on it and select `Library Properties...`
 4. A `Library Properties` pop-up window will appear
 5. Click the second `+` button in bottom left corner of the window (the one that contains `+` with little globe)
 6. Window for defining documentation URL will appear
@@ -1356,7 +1356,7 @@ Execution failed for task ':app:mergeDebugNativeLibs'.
 > A failure occurred while executing com.android.build.gradle.internal.tasks.MergeJavaResWorkAction
    > 2 files found with path 'lib/arm64-v8a/libc++_shared.so' from inputs:
       - <path>/.gradle/caches/transforms-3/3d428f9141586beb8805ce57f97bedda/transformed/jetified-opencv-4.5.3.0/jni/arm64-v8a/libc++_shared.so
-      - <path>/.gradle/caches/transforms-3/609476a082a81bd7af00fd16a991ee43/transformed/jetified-blinkid-6.11.2/jni/arm64-v8a/libc++_shared.so
+      - <path>/.gradle/caches/transforms-3/609476a082a81bd7af00fd16a991ee43/transformed/jetified-blinkid-6.12.0/jni/arm64-v8a/libc++_shared.so
      If you are using jniLibs and CMake IMPORTED targets, see
      https://developer.android.com/r/tools/jniLibs-vs-imported-targets
 ```

LibBlinkID.aar

@@ -1,5 +1,20 @@
 # Release notes
 
+## v6.12.0
+
+### What's New
+- **Beta Feature: Second Page Passport Scanning**
+     - We’ve launched support for scanning and extracting data from the second page of passports for select countries - Slovenia, Ireland, and New Zealand. When BlinkID detects one of these passports, a UI message will guide the user to the second page. By default, this feature is disabled but can be enabled via the `BlinkIdMultiSideRecognizer.scanPassportDataPageOnly` setting - if set to `false`, it will be required to scan the second page of certain passports. This feature is in beta, and your feedback is appreciated.
+- USA Green Card - Enabled Data Match for the `Document Number` field, matching values from the VIZ (Visual Inspection Zone) and MRZ to further enhance extraction reliability.
+
+
+### Bug Fixes
+- Spain ID: Fixed an issue with indefinite expiry dates, ensuring consistent values between the MRZ and Visual Inspection Zone (VIZ).
+- Bulgaria ID: Improved parsing for indefinite expiry dates in the MRZ for better accuracy.
+- Netherlands ID & Norway Passport: Resolved issues with the `Personal ID number` field that were causing the data match feature to fail.
+- Chinese Passport: Enhanced reliability of extracted data with additional logic for the `Document Number` field.
+- German ID & Luxembourg ID: Adjusted name extraction logic to resolve issues with name separation, ensuring more consistent results.
+
 ## v6.11.2
 
 ### Bug fixes

README.md

@@ -1 +1 @@
-Built from commit 1afdb86a7494ab92eabf0035a30f471008ff6251
+Built from commit be7079831774720d89d845d66e1eabee2fcf1389

Release notes.md

@@ -153,9 +153,9 @@ <h2>Method Summary</h2>
 <div class="block">Set license key and unlock the SDK.</div>
 </div>
 <div class="col-first even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code>static void</code></div>
-<div class="col-second even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code><a href="#setPingProxyUrl(java.lang.String)" class="member-name-link">setPingProxyUrl</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" class="external-link">String</a>&nbsp;url)</code></div>
+<div class="col-second even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code><a href="#setMicroblinkProxyUrl(java.lang.String)" class="member-name-link">setMicroblinkProxyUrl</a><wbr>(<a href="https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" class="external-link">String</a>&nbsp;url)</code></div>
 <div class="col-last even-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4">
-<div class="block">Set custom URL for Ping (used as a proxy).</div>
+<div class="block">Set custom URL for Ping and licence check (used as a proxy).</div>
 </div>
 <div class="col-first odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code>static void</code></div>
 <div class="col-second odd-row-color method-summary-table method-summary-table-tab1 method-summary-table-tab4"><code><a href="#setShowTrialLicenseWarning(boolean)" class="member-name-link">setShowTrialLicenseWarning</a><wbr>(boolean&nbsp;showTrialLicenseWarning)</code></div>
@@ -269,17 +269,19 @@ <h3>setLicenseBuffer</h3>
 </section>
 </li>
 <li>
-<section class="detail" id="setPingProxyUrl(java.lang.String)">
-<h3>setPingProxyUrl</h3>
-<div class="member-signature"><span class="modifiers">public static</span>&nbsp;<span class="return-type">void</span>&nbsp;<span class="element-name">setPingProxyUrl</span><wbr><span class="parameters">(@NonNull
+<section class="detail" id="setMicroblinkProxyUrl(java.lang.String)">
+<h3>setMicroblinkProxyUrl</h3>
+<div class="member-signature"><span class="modifiers">public static</span>&nbsp;<span class="return-type">void</span>&nbsp;<span class="element-name">setMicroblinkProxyUrl</span><wbr><span class="parameters">(@NonNull
  <a href="https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/lang/String.html" title="class or interface in java.lang" class="external-link">String</a>&nbsp;url)</span></div>
-<div class="block">Set custom URL for Ping (used as a proxy). Will be applied if the correct license right exists.</div>
+<div class="block">Set custom URL for Ping and licence check (used as a proxy). If you need to set the proxy URL,
+ you should do it before setting the license key; otherwise this call won't have any effect.
+ Proxy URL will be applied if the correct license right exists; otherwise
+ <a href="licence/exception/InvalidLicenceKeyException.html" title="class in com.microblink.blinkid.licence.exception"><code>InvalidLicenceKeyException</code></a> will be thrown when setting the license key.</div>
 <dl class="notes">
 <dt>Parameters:</dt>
-<dd><code>url</code> - String containing the desired url base.</dd>
+<dd><code>url</code> - String containing the desired URL base. URL has to use HTTPS protocol.</dd>
 <dt>Throws:</dt>
-<dd><code>InvalidLicenseKeyException</code> - if license is not valid</dd>
-<dd><code><a href="https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/lang/IllegalArgumentException.html" title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - if URL is not valid and doesn't use HTTPS protocol</dd>
+<dd><code><a href="https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/lang/IllegalArgumentException.html" title="class or interface in java.lang" class="external-link">IllegalArgumentException</a></code> - if the URL is not using HTTPS protocol.</dd>
 </dl>
 </section>
 </li>