Reader SDK Documents
Reader SDK Documents
Breadcrumbs

IFU052(01) v4.1.1 (Android)

Novarum DX Ltd
Instructions for Use / Guides

Document ID: IFU052 
Revision: 01 
Released: Aug 5, 2026 

1. Overview

v4.1.1 updates the Android Reader SDK package com.novarumdx:ndx-imaging-android, distributed through AWS CodeArtifact using the customer-facing novarum.client.maven Maven repository. It is the Android release following v4.0.1 and incorporates the Android SDK v4.1.0 changes together with the NDX Imaging Core v1.1.1 maintenance update.

  • Release package: com.novarumdx:ndx-imaging-android:4.1.1.

  • Embedded core: NDX Imaging Core v1.1.1, embedded via JNI/native libraries in the Android AAR.

  • Primary release purpose: deliver native Android reliability fixes from the 4.0.1 baseline, update the shared core runtime, and complete verification for the 4.1.1 Android release.

Warning: The SDK 4.1.1 (Android) is not compatible with current reader files that do not use the new format with the {estimators: [ wrapper. Reader files must be updated to the new format before use with SDK 4.1.1 (Android).

2. What’s Changed Since 4.0.1

2.1. Android SDK fixes

  • Datalogic Memor 11 camera orientation fix: SDKAND-130 addresses devices whose camera sensor orientation is flipped relative to standard Android devices. The SDK now processes frames at the correct orientation so scans can complete on affected hardware.

  • Final-frame completion UI fix: SDKAND-44 resolves the issue where the Android reader froze or navigated before the green completion check mark appeared on the last frame.

  • PMF Story strip-status correction: SDKAND-129 resolves a discrepancy where the final PMF Story strip status could remain storedButNotFull instead of reflecting the completed final-frame state.

2.2. NDX Imaging Core v1.1.1 update

  • Core v1.1.1 embedded: the Android AAR embeds NDX Imaging Core v1.1.1, replacing the v4.0.1-era core build.

  • Core verification evidence: Core v1.1.1 includes successful automated/device-farm evidence across Desktop, Android, iOS, Python and WASM execution records, including Android device-farm runs on Google Pixel 10 Pro / Android 16 and Samsung Galaxy S25 Ultra / Android 15.

3. Integration Notes

3.1. Android Maven integration

  • Continue using the AWS CodeArtifact Maven repository novarum.client.maven.

  • Update the Android SDK dependency version to 4.1.1.

  • Use the dependency coordinate com.novarumdx:ndx-imaging-android:4.1.1.

3.2. Consolidated Android SDK package

  • The Android customer dependency remains a single SDK artefact.

  • The package provides the Android-facing Kotlin/Java API, camera preview integration, callbacks, result model and native runtime integration required by customer applications.

  • The Android SDK continues to operate as the platform adapter around the shared NDX Imaging Core C++ engine. Customer applications continue to provide permissions, configuration, workflow, result handling and any onward data transmission.

  • JNI exception boundary handling remains in place so native engine failures are translated before crossing into the Android API layer.

4. Breaking vs. Non-breaking Summary

Change

Type

Developer impact

Customer dependency updated to com.novarumdx:ndx-imaging-android:4.1.1

Integration update

Update the Gradle dependency and ensure CodeArtifact Maven access is configured.

Embedded NDX Imaging Core updated to v1.1.1

Runtime dependency update

No API change is required for normal Android integrations; rebuild and regression test the host app with the new SDK artefact.

Datalogic Memor 11 camera orientation handling corrected

Bug fix

Affected devices should now process frames at the correct orientation. Verify scanning on target device models.

Final-frame check mark and PMF Story status behaviour corrected

Bug fix

No integration change required. Existing callbacks and result handling should continue to work.

5. When to Upgrade

Upgrade from Android SDK v4.0.1 to v4.1.1 when you need the latest Android v4 maintenance release, particularly if your application targets Datalogic Memor 11 or other devices with non-standard camera sensor orientation, or if you need the final-frame completion and PMF Story status corrections.

Apps using the existing v4.0.1 integration path should normally only need to update the Gradle dependency version and re-run application-level verification.

6. Compatibility Notes

  • Minimum Android SDK is 26.

  • compileSdk is 35.

  • Java source/target compatibility and Kotlin JVM target are 17.

  • Android Gradle Plugin version is 8.9.0.

  • Gradle Wrapper version is 8.11.1.

  • Kotlin version should be 1.9+.

  • OpenCV 4.12.0 is an internal SDK dependency.

  • Apps or modules that build native code should use NDK 29.0.14033849 rc4 and CMake 3.22.1.

  • The SDK requires camera access; request android.permission.CAMERA before displaying NovarumAnalyzerPreview.

7. Summary of Developer Actions

Area

Action Required

Repository access

Authenticate to AWS CodeArtifact and configure the Maven repository novarum.client.maven.

Dependency setup

Update the app module dependency to implementation "com.novarumdx:ndx-imaging-android:4.1.1".

Reader configuration

Confirm Novarum-provided reader JSON files use the current {estimators: [ wrapper format.

Device regression

Regression test scanning on representative Android devices, including any Datalogic Memor 11 devices in scope.

Build configuration

Keep minSdk 26, compileSdk 35, Java/JVM target 17, AGP 8.9.0 and Gradle Wrapper 8.11.1.

Permissions

Ensure camera permission and camera feature entries are present in AndroidManifest.xml, and request camera permission at runtime before scanning.

Configuration loading

Continue loading analyser configuration using PMFLoader.loadAnalyserConfiguration(json = configJson).

Reader view integration

Continue embedding NovarumAnalyzerPreview in XML layouts or wrapping it in Compose with AndroidView.

Callbacks and abort handling

Continue handling onFrameCaptured, onComplete, and abort() / onAbort according to the host application workflow.

8. Versioning Summary

Component

Version

Notes

Android Reader SDK Maven artefact

4.1.1

Dependency coordinate com.novarumdx:ndx-imaging-android:4.1.1.

NDX Imaging Core

1.1.1

Embedded via JNI/native libraries in the Android AAR.

Previous Android baseline

4.0.1

This document summarises changes since that release.

Minimum Android SDK

26

Required.

compileSdk

35

Required.

Java / JVM target

17

Required.

Android Gradle Plugin

8.9.0

Required.

Gradle Wrapper

8.11.1

Required for AGP 8.9.0.

Kotlin

1.9+

Required for Kotlin-based integrations.

OpenCV

4.12.0

Internal SDK dependency.

NDK

29.0.14033849 rc4

Required for host apps/modules that build native code.

CMake

3.22.1

Required for host apps/modules that build native code.

9. Fixed Issues

(Total: 3)
project = "SDK (Android)" AND type = "NDX Bug" AND fixversion >4.0.1-android AND status = Done ORDER BY created DESC
Key
Summary
Affects versions
Risk (calculated)
Fix versions
Test Result
Status
SDKAND-130
Devices have a rotated camera resulting in being unable to scan 4.0.1-android
🟥 High
 4.1.0-android 🟩 Pass
Done
SDKAND-129
PMF Story: Discrepancy between last strip statuses captured compared to result's pmfstory 4.0.1-android
🟨 Moderate
 4.1.0-android 🟩 Pass
Done
SDKAND-44
Green check mark does not appear on last frame 4.0.0-android, 4.0.1-android
🟩 Low
 4.1.0-android 🟩 Pass
Done

10. Known Issues

(Total: 1)
project = "SDK (Android)" AND issuetype = "NDX Bug" AND status NOT IN ("Archived", "Done") ORDER BY created DESC
Key
Summary
Affects versions
Risk (calculated)
Fix versions
Test Result
Status
SDKAND-133
Some devices have reduced sensor output 4.1.0-android
🟩 Low
   🟦 To Do
Open