Android GlobalIQA SDK change logs and release history

V1.5.6（2026.10.30）

1. New feature: Added a new enum value, LOAD_JNI_FAILED, to the return values of GlobalIQASDK.setLicenseAndCheck(). This code is returned when loading the native .so library fails.
2. New feature: Added GlobalIQASDK.getErrorMsg() to retrieve detailed error information when native library loading fails. This method returns an error message only when setLicenseAndCheck() returns LOAD_JNI_FAILED; otherwise, it returns null.

V1.5.5（2026.06.30）

1. New feature: Android 16 Adaptation.
2. Fix bug: To solve the issue where rotating the screen after taking a photo causes the photo upload to fail and forces the user to retake the shot.

V1.5.4（2026.04.09）

1. Fix Bug: Fixed an ANR issue that could occur during video recording.
2. Fix Bug: Fixed an ANR issue caused by thread lock contention in the onLayout method of the camera view.
3. Fix Bug: Fixed ANR issues triggered when calling Camera APIs (setAutoFocus and getNumberOfCameras).

V1.5.1（2026.01.14）

1. Functional Optimization：Standardized internal API return types to ensure binary compatibility across versions.

V1.5.0（2025.11.28）

1. New Feature: The SDK supports glossy detection.

V1.4.2（2025.10.10）

1. Functional Optimization: Resolved the issue where callback functions were executed multiple times during rapid successive detection start/stop detection.

V1.4.1（2025.09.22）

1. Fix known crash: Intermittent crash caused by IQAPageState serialization

V1.4.0（2025.08.05）

1. Supports Android 15: Added full compatibility with Android 15, including 16 KB page size support for improved performance on newer devices.
2. Flexible UI Integration:New View-based integration mode allows you to embed IQA directly into custom layouts with complete control over the user interface. For highly customized implementations, see the integration guide.
3. Dynamic Model File Distribution: Dynamic model file distribution reduces initial package size and accelerates feature updates.

V1.2.8（2024.12.30）

1、Version Introduction

• Fix bug.

2、Version Upgrade

• implementation 'ai.advance.mobile-sdk.android:global-iqa:1.2.8'

V1.2.7（2024.10.17）

1、Version Introduction

• Optimize occlusion detection.

2、Version Upgrade

• implementation 'ai.advance.mobile-sdk.android:global-iqa:1.2.7'

V1.2.6（2024.9.03）

1、Version Introduction

• Optimize the TH IQA occlusion model.

2、Version Upgrade

• implementation 'ai.advance.mobile-sdk.android:global-iqa:1.2.6'

V1.2.5（2024.8.15）

1、Version Introduction

• Introduce occlusion processing capabilities to the scanning model, which will be applicable exclusively within the context of Thailand.

2、Version Upgrade

• implementation 'ai.advance.mobile-sdk.android:global-iqa:1.2.5'

V1.2.4（2024.7.19）

1、Version Introduction

• Support for the Thai language

2、Version Upgrade

• implementation 'ai.advance.mobile-sdk.android:global-iqa:1.2.4'

V1.2.3.1（2024.4.30）

1、Version Introduction

• Bug Fix

  In this new release of Global Image Quality Check, we have made the following improvements in handling exception cases below:

  1. when the camera is turned off. Although we caught the IOException , a RuntimeException occurred here for unknown reasons. We adjust the catch block to catch Exception instead of IOException .

2、Version Upgrade

• implementation 'ai.advance.mobile-sdk.android:global-iqa:1.2.3.1'

V1.2.3（2024.4.22）

1、Version Introduction

• Bug Fix

  In this new release of Global Image Quality Check, we have made the following improvements in handling exception cases below:

  1. When the Camera.stopPreview(); is called to stop the camera preview, the Camera API throws an unhandled exception. Hence, a try-catch block was used to catch this exception
  2. When the SDK attempts to capture an image and finds that the image is empty, we have added a null check to handle such cases.
  3. When GlobalIQAView is not fully initialized and the user clicks on the page to execute GlobalIQAView.autoFocus(), it leads to a NullPointerExceptioninternally. To avoid this issue, we have added a null check to handle this exception.

2、Version Upgrade

• implementation 'ai.advance.mobile-sdk.android:global-iqa:1.2.3'

V1.2.2（2023.11.21）

1、Version Introduction

• bug fix

2、Version Upgrade

• implementation 'ai.advance.mobile-sdk.android:global-iqa:1.2.2'

V1.2.1（2023.8.11）

1、Version Introduction

• Support configuration for either photo only or scan only.

2、Version Upgrade

• implementation 'ai.advance.mobile-sdk.android:global-iqa:1.2.1'

V1.2.0（2023.5.29）

1、Version Introduction

• Increase scanning speed

2、Version Upgrade

• implementation 'ai.advance.mobile-sdk.android:global-iqa:1.2.0'

V1.1.0（2023.4.6）

1、Version Introduction

• token authentication transformation

2、Version Upgrade

• implementation 'ai.advance.mobile-sdk.android:global-iqa:1.1.0'

V1.0.9（2023.3.6）

1、Version Introduction

1. Algorithm optimization to improve scanning speed
2. By default, there will be no more 3 seconds of transition animation when the scan times out and turns to take photo

2、Version Upgrade

• implementation 'ai.advance.mobile-sdk.android:global-iqa:1.0.9'

V1.0.8（2022.11.4）

1、Version Introduction

1. Change the title of the scan page to Scan Document

2、Version Upgrade

• implementation 'ai.advance.mobile-sdk.android:global-iqa:1.0.8'

V1.0.7（2022.11.4）

1、Version Introduction

1. Fix the misspelling of PAGIBG card type

2、Version Upgrade

• implementation 'ai.advance.mobile-sdk.android:global-iqa:1.0.7'

V1.0.6（2022.9.27）

1、Version Introduction

• Add the following methods for customizing the UI

  1. The text above the camera view supports passing in rich text:

     SpannableString spannableString = new SpannableString("xxxxx");
     spannableString.setSpan(....);
     intent.putExtra(GlobalIQAActivity.EXTRA_SPANNABLE_ABOVE_CAMERA, spannableString);
     

  2. In take photo mode,support for setting rich text to the tip view below the camera view:

     xxxxxxxxxx
     SpannableString spannableString = new SpannableString("xxxxx");
     spannableString.setSpan(....);
     intent.putExtra(GlobalIQAActivity.EXTRA_SPANNABLE_TIP_TEXT_OF_TAKE_PHOTO, spannableString);
     

  3. In take photo mode,support for setting rich text for the tip view below the image when previewing after taking a photo:

     xxxxxxxxxx
     SpannableString spannableString = new SpannableString("xxxxx");
     spannableString.setSpan(....);
     intent.putExtra(GlobalIQAActivity.EXTRA_SPANNABLE_PREVIEW_TIP_OF_TAKE_PHOTO, spannableString);
     

  4. Camera view mask support for setting rounded corners (in px):

     xxxxxxxxxx
     new UIExtras.Builder()
     .setFrameRectCornerRadius(20)
     .build()
     

  5. In take photo mode, the background color of the tip view below the camera view can be changed:

     xxxxxxxxxx
     new UIExtras.Builder()
     .setTakePhotoTipViewBackgroundColor(your color value)
     .build()      
     

  6. In take photo mode，The icon to the left of the tip view below the camera view can be set to hide:

     xxxxxxxxxx
     new UIExtras.Builder()
     .takePhotoTipViewLeftIconVisible(false)
     .build()        
     

  7. In scan mode, you can customize the style of the tip view：

     ​x
     TipViewUIElements elements = new TipViewUIElements();
     elements.setNoCardDrawableResId(R.drawable.xxx);// No card detected
     elements.setHoldSteadilyDrawableResId(R.drawable.xxx);// Please hold the phone steady
     elements.setCardPoorQualityDrawableResId(R.drawable.xxx);// Card poor quality: blurred/spotty/too dark
     elements.setCardIncompleteDrawableResId(R.drawable.xxx);// Card incomplete
     elements.setCardTooSmallDrawableResId(R.drawable.xxx);// Card too small
     elements.setViewWidthPercentRelativeToCameraView(1f); // The width of the tip view relative to the camera view, e.g., set to 1 for equal width of the camera view
     elements.setAspectRatio(0.25f);// Tip view aspect ratio,width/height
     
     new UIExtras.Builder()
     .setPortraitTipViewBackgrounds(elements)// In portrait
     .setLandscapeTipViewBackgrounds(landscapeElements)// In landscape
     .build()    
     

2、Version Upgrade

• implementation 'ai.advance.mobile-sdk.android:global-iqa:1.0.6'

V1.0.5（2022.9.15）

1、Version Introduction

• Add the following types of card recognition

  • VOTERID
  • NATIONALID
  • PRC
  • PAGIBG
  • POSTALID

2、Version Upgrade

• implementation 'ai.advance.mobile-sdk.android:global-iqa:1.0.5'

V1.0.4（2022.8.10）

1、Version Introduction

• Add a maven repository for online dependencies, remove the guardian_global_iqa_v1.0.x.aar and guardian_core_vx.x.aar that your project already depends on, and do the dependencies as follows.

  1. Add a maven repository dependency to build.gradle in the root of your project

     xxxxxxxxxx
     allprojects {
         repositories {
             google()
             jcenter()
             ...
             maven {
                 url 'http://public-n3.advai.net/repository/maven-releases/'
                 // If your gradle version is greater than 7.0, you need to add the following configuration to allow pulling aar via http
                 allowInsecureProtocol = true
             }
         }
     }
     

  2. Adding package dependencies to app/build.gradle

     xxxxxxxxxx
     dependencies {
          ...
         // Version record view:http://public-n3.advai.net/repository/maven-releases/ai/advance/mobile-sdk/android/global-iqa/maven-metadata.xml
         implementation 'ai.advance.mobile-sdk.android:global-iqa:1.0.4' 
     }
     

V1.0.3（2022.7.1）

1、Version Introduction

• Add several custom UI methods, please refer to the integration documentation for details.

  xxxxxxxxxx
  ...
  .setPagePortraitBackgroundResource(R.drawable.xxx)// The page background picture at portrait state
  .setPageLandscapeBackgroundResource(R.drawable.xxx)// The page background picture at landscape state
  .setPageLandscapeTitleBgResource(R.drawable.xxx)// The title background picture at portrait state
  .setPagePortraitTitleBgResource(R.drawable.xxx)// The page background picture at landscape state
  .setCameraWidthPercentInPortraitState(0.8f)// The width percent of camera view when the page at  portrait state,the value must between [0,1]
  .setCameraHeightPercentInLandscapeState(0.7)// The width percent of camera view when the page at landscape state,the value must between [0,0.7]
  .setRetakeBtnTextColor(your colorRes)//The retake button text color in 'Take Photo' mode
  .setContinueBtnTextColor(your colorRes)// The continue button text color in 'Take Photo' mode
  .setTakePhotoTipDialogShowSeconds(3)// The tip dialog(when scanning timeout) duration seconds, set to 0 will not show the dialog
  .setScanLimitSeconds(20)// The scanning seconds limit,the value must between [5,60]
  .setCountdownTimerVisible(true)// Whether the countdown timer view shown
  

2、Version Upgrade

• Replace the old version of aar with guardian_global_iqa_v1.0.3.aar and modify the dependencies in gradle

V1.0.2（2022.6.7）

1、Version Introduction

• add function to get picture type

  xxxxxxxxxx
  String pictureType = GlobalIQAResult.getPictureType();// takePhoto or scan 
  

2、Version Upgrade

• Replace the old version of aar with guardian_global_iqa_v1.0.2.aar and modify the dependencies in gradle

V1.0.1（2022.4.13）

1、Version Introduction

• add passport type card support

2、Version Upgrade

• Replace the old version of aar with guardian_global_iqa_v1.0.1.aar and modify the dependencies in gradle