ML Kit native libraries are not 16 KB page-size aligned (AGP 8.5+ compatibility issue)

[kayasthjaideep19-cyber]

I am experiencing issues using ML Kit with the new 16 KB page-size requirement introduced for Android 15 and AGP 8.5+. Several ML Kit native .so libraries appear not to be aligned to 16 KB, causing build failures when running stripDebugSymbols, and potentially causing Google Play upload validation failures.

This issue occurs even with the latest ML Kit dependency versions.

implementation "com.google.mlkit:barcode-scanning:17.3.0"

Build Tools / Environment

Android Gradle Plugin (AGP): 8.5.x or 8.6.x

Gradle: 8.x

Target SDK: 34 or 35

Build type: Release (issues occur during symbol stripping)

Device ABIs tested: arm64-v8a, armeabi-v7a, x86_64

stripReleaseDebugSymbols FAILED
ELF file alignment does not match 16 KB requirement.

[FaceAISDK]

libimage_processing_util_jni.so？？

The native library libimage_processing_util_jni.so included in your current ML Kit version is aligned to 4 KB, which causes errors on newer devices or during Google Play Console verification.

Here are the best ways to fix it, ranked from most recommended to least.

Solution 1: Add CameraX Dependency (Recommended)
This is the most effective workaround currently. Even if you don't use CameraX features, the CameraX 1.4.0+ library includes a newer, 16 KB-aligned version of libimage_processing_util_jni.so. Adding this dependency forces Gradle to use the fixed version of the .so file, overriding the old one from ML Kit.

Steps: Open your module-level build.gradle (usually app/build.gradle) and add the following line to your dependencies:

Gradle

dependencies {
    // ... other dependencies

    // Add CameraX core to get the 16KB-aligned native library
    implementation "androidx.camera:camera-core:1.4.0" 

    // Keep your existing ML Kit dependency
    implementation 'com.google.mlkit:face-detection:16.1.7'
}

Note: You must use version 1.4.2 or higher.

if your project dependency other lib that also dependency CameraX core and not 1.4.2 or higher.
you can force int app Gradle file like this

//CameraX，适配Android16 KB Page请强制升级到1.4.2 以上版本
def camera_version = "1.4.2"
configurations.configureEach {
    resolutionStrategy {
        force "androidx.camera:camera-core:$camera_version",
                "androidx.camera:camera-camera2:$camera_version",
                "androidx.camera:camera-lifecycle:$camera_version",
                "androidx.camera:camera-view:$camera_version"
    }
}

https://github.com/FaceAISDK/FaceAISDK_Android/blob/publish/demo/build.gradle

Good luck 🍀

[heytsai]

Hi kayasthjaideep19-cyber,

Thank you for reporting the issue. I tested com.google.mlkit:barcode-scanning:17.3.0 using APK Analyzer With the following config:

• Environment: the recommended minimums on DAC (AGP 8.5.1, and targetSdk 35)
• Dependencies: only com.google.mlkit:barcode-scanning:17.3.0

The analysis does not indicate any 16KB compatibility issues.

If your app includes CameraX or other libraries, could you please try updating them to the latest versions? As noted by FaceAISDK, the issue may stem from CameraX (see related bug) or other dependencies.

Thanks.