Merge pull request #25 from PDF417/release/v6.1.0

Release/v6.1.0

.travis.yml

@@ -5,8 +5,8 @@ sudo: false
 android:
     components:
         - tools
-        - build-tools-25.0.0
-        - android-23
+        - build-tools-25.0.2
+        - android-25
         - extra-android-m2repository
 script:
     - cd Pdf417MobiDemo

Pdf417MobiDemo/build.gradle

@@ -4,7 +4,7 @@ buildscript {
         jcenter()
     }
     dependencies {
-        classpath 'com.android.tools.build:gradle:2.2.2'
+        classpath 'com.android.tools.build:gradle:2.2.3'
     }
 }
 
@@ -19,8 +19,8 @@ allprojects {
 // versions of libraries that all modules require
 
 project.ext {
-    pdf417MobiVersion = '6.0.1'
-    compileSdkVersion = 23
-    targetSdkVersion = 23
-    buildToolsVersion = '25.0.0'
+    pdf417MobiVersion = '6.1.0'
+    compileSdkVersion = 25
+    targetSdkVersion = 25
+    buildToolsVersion = '25.0.2'
 }

Pdf417MobiDemo/pdf417MobiDemo/src/main/java/mobi/pdf417/demo/Pdf417MobiDemo.java

@@ -33,7 +33,7 @@ public class Pdf417MobiDemo extends Activity {
     // demo license key for package com.microblink.barcode
     // obtain your licence key at http://microblink.com/login or
     // contact us at http://help.microblink.com
-    private static final String LICENSE_KEY = "LF4HOK6C-2CBLHLKC-2W32Z7CV-Z5Y5Z644-XIDIRD7F-ZFRKASEV-MTUXMWH6-7BSYYAS4";
+    private static final String LICENSE_KEY = "BKEBQ4LY-V4GNRCKE-2CGDYLRI-H4HHHUWZ-7EFI7ZOJ-MKQERFLE-5F3FR7XY-MXORWT6N";
 
     private static final int MY_REQUEST_CODE = 1337;
 

Pdf417MobiDemo/pdf417MobiDemoCustomUI/src/main/java/mobi/pdf417/demo/Pdf417CustomUIDemo.java

@@ -29,7 +29,7 @@ public class Pdf417CustomUIDemo extends Activity {
     // demo license key for package com.microblink.barcode
     // obtain your licence key at http://microblink.com/login or
     // contact us at http://help.microblink.com
-    public static final String LICENSE = "LF4HOK6C-2CBLHLKC-2W32Z7CV-Z5Y5Z644-XIDIRD7F-ZFRKASEV-MTUXMWH6-7BSYYAS4";
+    public static final String LICENSE = "BKEBQ4LY-V4GNRCKE-2CGDYLRI-H4HHHUWZ-7EFI7ZOJ-MKQERFLE-5F3FR7XY-MXORWT6N";
 
     private static final int MY_REQUEST_CODE = 1337;
 

Pdf417MobiDemo/pdf417MobiDirectAPIDemo/src/main/java/com/microblink/barcode/MenuActivity.java

@@ -38,7 +38,7 @@ public class MenuActivity extends Activity {
 
     // obtain your licence key at http://microblink.com/login or
     // contact us at http://help.microblink.com
-    private static final String LICENSE_KEY = "LF4HOK6C-2CBLHLKC-2W32Z7CV-Z5Y5Z644-XIDIRD7F-ZFRKASEV-MTUXMWH6-7BSYYAS4";
+    private static final String LICENSE_KEY = "BKEBQ4LY-V4GNRCKE-2CGDYLRI-H4HHHUWZ-7EFI7ZOJ-MKQERFLE-5F3FR7XY-MXORWT6N";
 
     private static final int MY_REQUEST_CODE = 1337;
     private static final String TAG = "DirectApiDemo";

Pdf417MobiDemo/pdf417MobiDirectAPIDemo/src/main/res/layout/fragment_camera2.xml

@@ -3,11 +3,16 @@
                 android:layout_width="match_parent"
                 android:layout_height="match_parent">
 
-    <com.microblink.barcode.customcamera.camera2.AutoFitTextureView
-        android:id="@+id/texture"
-        android:layout_width="wrap_content"
-        android:layout_height="wrap_content"
-        android:layout_alignParentLeft="true"
-        android:layout_alignParentTop="true" />
+    <RelativeLayout
+        android:layout_width="match_parent"
+        android:layout_height="match_parent"
+        android:gravity="center">
+
+        <com.microblink.barcode.customcamera.camera2.AutoFitTextureView
+            android:id="@+id/texture"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"/>
+
+    </RelativeLayout>
 
 </RelativeLayout>

README.md

@@ -54,6 +54,7 @@ See below for more information about how to integrate _PDF417.mobi_ SDK into you
 * [Troubleshooting](#troubleshoot)
   * [Integration problems](#integrationTroubleshoot)
   * [SDK problems](#sdkTroubleshoot)
+  * [Frequently asked questions and known problems](#faq)
 * [Additional info](#info)
 
 # <a name="intro"></a> Android _PDF417.mobi_ integration instructions
@@ -97,7 +98,7 @@ After that, you just need to add _PDF417.mobi_ as a dependency to your applicati
 
 ```
 dependencies {
-    compile('com.microblink:pdf417.mobi:6.0.1@aar') {
+    compile('com.microblink:pdf417.mobi:6.1.0@aar') {
     	transitive = true
     }
 }
@@ -118,7 +119,7 @@ Current version of Android Studio will not automatically import javadoc from mav
 
 1. In Android Studio project sidebar, ensure [project view is enabled](https://developer.android.com/sdk/installing/studio-androidview.html)
 2. Expand `External Libraries` entry (usually this is the last entry in project view)
-3. Locate `pdf417.mobi-6.0.1` entry, right click on it and select `Library Properties...`
+3. Locate `pdf417.mobi-6.1.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 definining documentation URL will appear
@@ -143,7 +144,7 @@ Open your `pom.xml` file and add these directives as appropriate:
 	<dependency>
 		  <groupId>com.microblink</groupId>
 		  <artifactId>pdf417.mobi</artifactId>
-		  <version>6.0.1</version>
+		  <version>6.1.0</version>
 		  <type>aar</type>
   	</dependency>
 </dependencies>
@@ -154,12 +155,12 @@ Open your `pom.xml` file and add these directives as appropriate:
 1. In Android Studio menu, click _File_, select _New_ and then select _Module_.
 2. In new window, select _Import .JAR or .AAR Package_, and click _Next_.
 3. In _File name_ field, enter the path to _LibPdf417Mobi.aar_ and click _Finish_.
-4. In your app's `build.gradle`, add dependency to `LibRecognizer` and appcompat-v7:
+4. In your app's `build.gradle`, add dependency to `LibPdf417Mobi` and appcompat-v7:
 
 	```
 	dependencies {
-   		compile project(':LibRecognizer')
- 		compile "com.android.support:appcompat-v7:25.0.0"
+   		compile project(':LibPdf417Mobi')
+ 		compile "com.android.support:appcompat-v7:25.1.0"
 	}
 	```
 5. If you plan to use ProGuard, add following lines to your `proguard-rules.pro`:
@@ -175,11 +176,11 @@ Open your `pom.xml` file and add these directives as appropriate:
 
 1. In Android Studio project sidebar, ensure [project view is enabled](https://developer.android.com/sdk/installing/studio-androidview.html)
 2. Expand `External Libraries` entry (usually this is the last entry in project view)
-3. Locate `LibRecognizer-unspecified` entry, right click on it and select `Library Properties...`
+3. Locate `LibPdf417Mobi-unspecified` entry, right click on it and select `Library Properties...`
 4. A `Library Properties` pop-up window will appear
 5. Click the `+` button in bottom left corner of the window
 6. Window for choosing JAR file will appear
-7. Find and select `LibRecognizer-javadoc.jar` file which is located in root folder of the SDK distribution
+7. Find and select `LibPdf417Mobi-javadoc.jar` file which is located in root folder of the SDK distribution
 8. Click `OK`
 
 ## <a name="eclipseIntegration"></a> Eclipse integration instructions
@@ -654,10 +655,6 @@ This method pauses the scanning loop, but keeps both camera and native library i
 ##### <a name="recognizerView_resumeScanning"></a> [`resumeScanning(boolean)`](https://pdf417.github.io/pdf417-android/com/microblink/view/recognition/RecognizerView.html#resumeScanning-boolean-)
 With this method you can resume the paused scanning loop. If called with `true` parameter, implicitly calls `resetRecognitionState()`. If called with `false`, old recognition state will not be reset, so it could be reused for boosting recognition result. This may not be always a desired behaviour.  Pause and resume scanning methods count the number of calls, so if you called `pauseScanning()` twice, you will have to call `resumeScanning` twice to actually resume scanning loop.
 
-
-##### <a name="recognizerView_setInitialScanningPaused"></a> [`setInitialScanningPaused()`](https://pdf417.github.io/pdf417-android/com/microblink/view/recognition/RecognizerView.html#setInitialScanningPaused-boolean-)
-This method lets you set up RecognizerView to not automatically resume scanning first time [resume](#recognizerView_resume) is called. An example use case of when you might want this is if you want to display onboarding help when opening camera first time and want to prevent scanning in background while onboarding is displayed over camera preview.
-
 ##### <a name="recognizerView_resetRecognitionState"></a> [`resetRecognitionState()`](https://pdf417.github.io/pdf417-android/com/microblink/view/recognition/RecognizerView.html#resetRecognitionState--)
 With this method you can reset internal recognition state. State is usually kept to improve recognition quality over time, but without resetting recognition state sometimes you might get poorer results (for example if you scan one object and then another without resetting state you might end up with result that contains properties from both scanned objects).
 
@@ -1531,6 +1528,24 @@ If you are having problems with scanning certain items, undesired behaviour on s
 	* information about device that you are using - we need exact model name of the device. You can obtain that information with [this app](https://play.google.com/store/apps/details?id=com.jphilli85.deviceinfo&hl=en)
 	* please stress out that you are reporting problem related to Android version of _PDF417.mobi_ SDK
 
+## <a name="faq"></a> Frequently asked questions and known problems
+Here is a list of frequently asked questions and solutions for them and also a list of known problems in the SDK and how to work around them.
+
+### <a name="android7MultiWindowButtons"></a> When automatic rotation is enabled, buttons are mislayouted on default scan activity after orientation change in Android 7.0 multi-window mode
+This is a known issue which can only be worked around by disabling multi window support in your entire activity stack which, as described in [Android documentation](https://developer.android.com/guide/topics/ui/multi-window.html#configuring) or by using [custom UI integration approach](#recognizerView). We are aware of the issue and will fix it in a future release.
+
+### <a name="featureNotSupportedByLicenseKey"></a> Sometimes scanning works, sometimes it says that feature is not supported by license key
+
+Each license key contains information about which features are allowed to use and which are not. This error can usually happens with production licence keys when you attempt to use recognizer which was not included in licence key. You should contact [support](http://help.microblink.com) to check if provided licence key is OK and that it really contains all features that you have purchased.
+
+### <a name="missingResources"></a> When my app starts, I get exception telling me that some resource/class cannot be found or I get `ClassNotFoundException`
+
+This usually happens when you perform integration into [Eclipse project](#eclipseIntegration) and you forget to add resources or native libraries into the project. You must alway take care that same versions of both resources, assets, java library and native libraries are used in combination. Combining different versions of resources, assets, java and native libraries will trigger crash in SDK. This problem can also occur when you have performed improper integration of _PDF417.mobi_ SDK into your SDK. Please read how to [embed _PDF417.mobi_ inside another SDK](#embedAAR).
+
+### <a name="unsatisfiedLinkError"></a> When my app starts, I get `UnsatisfiedLinkError`
+
+This error happens when JVM fails to load some native method from native library. If performing integration into [Eclipse project](#eclipseIntegration) make sure you have the same version of all native libraries and java wrapper. If performing integration [into Android studio](quickIntegration) and this error happens, make sure that you have correctly combined _PDF417.mobi_ SDK with [third party SDKs that contain native code](#combineNativeLibraries). If this error also happens in our integration demo apps, then it may indicate a bug in the SDK that is manifested on specific device. Please report that to our [support team](http://help.microblink.com).
+
 
 # <a name="info"></a> Additional info
 Complete API reference can be found in [Javadoc](https://pdf417.github.io/pdf417-android/index.html). 

Release notes.md

@@ -1,5 +1,15 @@
 # Release notes
 
+## 6.1.0
+
+- removed `RecognizerView` method `setInitialScanningPaused`. For achieving the same functionality, method `pauseScanning` should be used.
+- added support for cancelling ongoing DirectAPI recognition call
+- added support for Android 7 multi-window mode
+- fixed autofocus bug on Huawei Honor 8
+- fixed black camera on Motorola Moto Z
+- made camera focusing more stable on some devices
+    - _stable_ means less "jumpy" when searching for focused image
+
 ## 6.0.1
 - fixed camera management on LG X Cam
 - fixed crash on some devices when using `ImageListener`

builtFromCommit.txt

@@ -1 +1 @@
-Built from commit 9a4bd9c3c3293fdcd154472377f38fc9aa892eb6
+Built from commit 0f9870644add215a196e4e7ababf59b5012097ff

docs/allclasses-frame.html

@@ -21,17 +21,19 @@ <h1 class="bar">All&nbsp;Classes</h1>
 <li><a href="com/microblink/view/BaseCameraView.CameraViewState.html" title="enum in com.microblink.view" target="classFrame">BaseCameraView.CameraViewState</a></li>
 <li><a href="com/microblink/recognizers/BaseRecognitionResult.html" title="class in com.microblink.recognizers" target="classFrame">BaseRecognitionResult</a></li>
 <li><a href="com/microblink/activity/BaseScanActivity.html" title="class in com.microblink.activity" target="classFrame">BaseScanActivity</a></li>
-<li><a href="com/microblink/directApi/frame/BitmapCameraFrame.html" title="class in com.microblink.directApi.frame" target="classFrame">BitmapCameraFrame</a></li>
 <li><a href="com/microblink/view/CameraAspectMode.html" title="enum in com.microblink.view" target="classFrame">CameraAspectMode</a></li>
 <li><a href="com/microblink/view/CameraEventsListener.html" title="interface in com.microblink.view" target="classFrame"><span class="interfaceName">CameraEventsListener</span></a></li>
 <li><a href="com/microblink/util/CameraPermissionManager.html" title="class in com.microblink.util" target="classFrame">CameraPermissionManager</a></li>
 <li><a href="com/microblink/hardware/camera/CameraType.html" title="enum in com.microblink.hardware.camera" target="classFrame">CameraType</a></li>
+<li><a href="com/microblink/view/CameraViewGroup.html" title="class in com.microblink.view" target="classFrame">CameraViewGroup</a></li>
+<li><a href="com/microblink/view/CameraViewGroup.LayoutParams.html" title="class in com.microblink.view" target="classFrame">CameraViewGroup.LayoutParams</a></li>
 <li><a href="com/microblink/metadata/DetectionMetadata.html" title="class in com.microblink.metadata" target="classFrame">DetectionMetadata</a></li>
 <li><a href="com/microblink/view/recognition/DetectionStatus.html" title="enum in com.microblink.view.recognition" target="classFrame">DetectionStatus</a></li>
 <li><a href="com/microblink/detectors/DetectorResult.html" title="class in com.microblink.detectors" target="classFrame">DetectorResult</a></li>
 <li><a href="com/microblink/detectors/DetectorResult.DetectionCode.html" title="enum in com.microblink.detectors" target="classFrame">DetectorResult.DetectionCode</a></li>
 <li><a href="com/microblink/directApi/DirectApiErrorListener.html" title="interface in com.microblink.directApi" target="classFrame"><span class="interfaceName">DirectApiErrorListener</span></a></li>
 <li><a href="com/microblink/results/barcode/ElementType.html" title="enum in com.microblink.results.barcode" target="classFrame">ElementType</a></li>
+<li><a href="com/microblink/metadata/GlareMetadata.html" title="class in com.microblink.metadata" target="classFrame">GlareMetadata</a></li>
 <li><a href="com/microblink/image/Image.html" title="class in com.microblink.image" target="classFrame">Image</a></li>
 <li><a href="com/microblink/image/ImageBuilder.html" title="class in com.microblink.image" target="classFrame">ImageBuilder</a></li>
 <li><a href="com/microblink/image/ImageFormat.html" title="enum in com.microblink.image" target="classFrame">ImageFormat</a></li>
@@ -67,6 +69,7 @@ <h1 class="bar">All&nbsp;Classes</h1>
 <li><a href="com/microblink/view/viewfinder/quadview/QuadViewManagerFactory.html" title="class in com.microblink.view.viewfinder.quadview" target="classFrame">QuadViewManagerFactory</a></li>
 <li><a href="com/microblink/view/viewfinder/quadview/QuadViewPreset.html" title="enum in com.microblink.view.viewfinder.quadview" target="classFrame">QuadViewPreset</a></li>
 <li><a href="com/microblink/recognizers/RecognitionResultConstants.html" title="interface in com.microblink.recognizers" target="classFrame"><span class="interfaceName">RecognitionResultConstants</span></a></li>
+<li><a href="com/microblink/metadata/RecognitionResultMetadata.html" title="class in com.microblink.metadata" target="classFrame">RecognitionResultMetadata</a></li>
 <li><a href="com/microblink/recognizers/RecognitionResults.html" title="class in com.microblink.recognizers" target="classFrame">RecognitionResults</a></li>
 <li><a href="com/microblink/recognizers/settings/RecognitionSettings.html" title="class in com.microblink.recognizers.settings" target="classFrame">RecognitionSettings</a></li>
 <li><a href="com/microblink/recognizers/settings/RecognitionSettings.FrameQualityEstimationMode.html" title="enum in com.microblink.recognizers.settings" target="classFrame">RecognitionSettings.FrameQualityEstimationMode</a></li>