fix: migrate to LiteRT 1.4.0 for proper 16KB page size support

- Replace TensorFlow Lite 2.12.0 with LiteRT 1.4.0
- TFLite 2.12.0 (from 2022) lacks 16KB aligned native libraries
- LiteRT 1.4.0 provides proper 16KB page alignment
- Add verification script to check page size alignment
- Bump version to 0.12.1

Author: bhanuka96

CHANGELOG.md

@@ -1,5 +1,12 @@
+## 0.12.1 (October 28, 2025)
+* **CRITICAL FIX**: Properly implement Android 16KB page size support
+* Migrated from TensorFlow Lite 2.12.0 to Google AI Edge LiteRT 1.4.0
+* LiteRT provides native libraries with 16KB page alignment required by Google Play
+* Added verification script (scripts/verify_16kb.sh) to check page size alignment
+* Note: Version 0.12.0 claimed 16KB support but used TensorFlow Lite 2.12.0 (incompatible)
+
 ## 0.12.0 (October 27, 2025)
-* Android 16KB page size support for Google Play 2025 compliance
+* Android 16KB page size support attempted (incomplete - fixed in 0.12.1)
 * Updated Android Gradle Plugin to 8.6.1
 * Updated Compile SDK to 36 (Android 15+)
 * Modernized Gradle build system with plugins DSL

android/build.gradle

@@ -63,8 +63,8 @@ android {
 
 
 dependencies {
-    def tflite_version = "2.12.0"
+    def litert_version = "1.4.0"
 
-    implementation("org.tensorflow:tensorflow-lite:${tflite_version}")
-    implementation("org.tensorflow:tensorflow-lite-gpu:${tflite_version}")
+    implementation("com.google.ai.edge.litert:litert:${litert_version}")
+    implementation("com.google.ai.edge.litert:litert-gpu:${litert_version}")
 }

pubspec.yaml

@@ -16,7 +16,7 @@
 
 name: tflite_flutter
 description: TensorFlow Lite Flutter plugin provides an easy, flexible, and fast Dart API to integrate TFLite models in flutter apps across mobile and desktop platforms.
-version: 0.12.0
+version: 0.12.1
 homepage: https://github.com/tensorflow/flutter-tflite
 
 environment:

scripts/verify_16kb.sh

@@ -0,0 +1,103 @@
+#!/bin/bash
+
+# Script to verify 16KB page size alignment for Android native libraries
+# Usage: ./verify_16kb.sh <path_to_apk_or_aab>
+
+set -e
+
+if [ $# -eq 0 ]; then
+    echo "Usage: $0 <path_to_apk_or_aab>"
+    echo "Example: $0 app-release.apk"
+    exit 1
+fi
+
+APK_PATH="$1"
+TEMP_DIR=$(mktemp -d)
+
+echo "=========================================="
+echo "16KB Page Size Verification"
+echo "=========================================="
+echo "File: $APK_PATH"
+echo ""
+
+# Extract the APK/AAB
+echo "Extracting archive..."
+unzip -q "$APK_PATH" -d "$TEMP_DIR"
+
+# Find all .so files
+SO_FILES=$(find "$TEMP_DIR" -name "*.so" -type f)
+
+if [ -z "$SO_FILES" ]; then
+    echo "❌ No native libraries (.so files) found in the archive"
+    rm -rf "$TEMP_DIR"
+    exit 1
+fi
+
+echo "Found native libraries:"
+echo "$SO_FILES" | sed 's|.*/||'
+echo ""
+
+ALL_ALIGNED=true
+
+# Check each .so file
+for SO_FILE in $SO_FILES; do
+    SO_NAME=$(basename "$SO_FILE")
+    ARCH=$(dirname "$SO_FILE" | xargs basename)
+
+    # Only check arm64-v8a and x86_64 architectures (required for 16KB)
+    if [[ "$ARCH" == "arm64-v8a" ]] || [[ "$ARCH" == "x86_64" ]]; then
+        echo "Checking: $ARCH/$SO_NAME"
+
+        # Check if readelf is available
+        if ! command -v readelf &> /dev/null; then
+            echo "  ⚠️  readelf not found. Install binutils or use Android NDK's llvm-readelf"
+            echo "     Skipping detailed alignment check"
+            continue
+        fi
+
+        # Get LOAD segment alignments
+        ALIGNMENTS=$(readelf -l "$SO_FILE" 2>/dev/null | grep LOAD | awk '{print $NF}')
+
+        MIN_ALIGNMENT=16384  # 2^14 = 16KB
+        ALIGNED=true
+
+        for ALIGN in $ALIGNMENTS; do
+            # Convert hex alignment (e.g., 2**14) to decimal
+            if [[ "$ALIGN" =~ 2\*\*([0-9]+) ]]; then
+                POWER="${BASH_REMATCH[1]}"
+                ALIGN_VALUE=$((2**POWER))
+
+                if [ "$ALIGN_VALUE" -lt "$MIN_ALIGNMENT" ]; then
+                    echo "  ❌ UNALIGNED: segment alignment 2**$POWER ($ALIGN_VALUE bytes) < 16KB"
+                    ALIGNED=false
+                    ALL_ALIGNED=false
+                fi
+            fi
+        done
+
+        if [ "$ALIGNED" = true ]; then
+            echo "  ✅ ALIGNED: All segments meet 16KB requirement"
+        fi
+        echo ""
+    fi
+done
+
+# Cleanup
+rm -rf "$TEMP_DIR"
+
+echo "=========================================="
+if [ "$ALL_ALIGNED" = true ]; then
+    echo "✅ SUCCESS: All native libraries are 16KB aligned"
+    echo "=========================================="
+    exit 0
+else
+    echo "❌ FAILURE: Some libraries are NOT 16KB aligned"
+    echo "=========================================="
+    echo ""
+    echo "Recommended actions:"
+    echo "1. Ensure you're using LiteRT 1.4.0+ or TensorFlow Lite 2.16.1+"
+    echo "2. Verify AGP version is 8.5.1 or higher"
+    echo "3. Check that NDK version is r27 or higher (if compiling native code)"
+    echo "4. Rebuild your app after updating dependencies"
+    exit 1
+fi