From 439bdf48de7addea51c8f1d186b323b6dcff37c0 Mon Sep 17 00:00:00 2001
From: Feodor Fitsner <feodor@appveyor.com>
Date: Mon, 20 Oct 2025 09:30:34 -0700
Subject: [PATCH 1/3] Add ELF 16KB alignment check script and CMake flags

Introduces a comprehensive shell script to check ELF segment alignment for Android 16KB page size compatibility, addressing upcoming Google Play requirements. Updates CMakeLists.txt to set linker flags for 16KB page size support when building for Android, ensuring native libraries are compliant for Android 15+.
---
 .github/scripts/check_elf_alignment.sh        | 699 ++++++++++++++++++
 src/serious_python_android/src/CMakeLists.txt |   7 +
 2 files changed, 706 insertions(+)
 create mode 100755 .github/scripts/check_elf_alignment.sh

diff --git a/.github/scripts/check_elf_alignment.sh b/.github/scripts/check_elf_alignment.sh
new file mode 100755
index 00000000..d8db1291
--- /dev/null
+++ b/.github/scripts/check_elf_alignment.sh
@@ -0,0 +1,699 @@
+#!/bin/bash
+
+# Enhanced ELF Alignment Checker for Android 16KB Page Size Compatibility
+# This script checks if your app's native libraries are compatible with 16KB page size devices
+# as required by Google Play starting November 1st, 2025 for apps targeting Android 15+
+
+progname="${0##*/}"
+progname="${progname%.sh}"
+
+# Color codes and formatting - detect if colors are supported
+if [[ -t 1 ]] && command -v tput >/dev/null 2>&1 && tput colors >/dev/null 2>&1 && [[ $(tput colors) -ge 8 ]]; then
+  RED="\033[31m"
+  GREEN="\033[32m"
+  YELLOW="\033[33m"
+  BLUE="\033[34m"
+  CYAN="\033[36m"
+  PURPLE="\033[35m"
+  BOLD="\033[1m"
+  DIM="\033[2m"
+  ENDCOLOR="\033[0m"
+  USE_COLORS=true
+else
+  # No color support - use plain text
+  RED=""
+  GREEN=""
+  YELLOW=""
+  BLUE=""
+  CYAN=""
+  PURPLE=""
+  BOLD=""
+  DIM=""
+  ENDCOLOR=""
+  USE_COLORS=false
+fi
+
+# Unicode symbols with fallbacks
+if [[ $USE_COLORS == true ]]; then
+  CHECK_MARK="✓"
+  CROSS_MARK="✗"
+  WARNING_MARK="⚠"
+  INFO_MARK="ℹ"
+  ROCKET="🚀"
+  GEAR="⚙"
+  PACKAGE="📦"
+  DOCUMENT="📄"
+  ALERT="🚨"
+  PARTY="🎉"
+  TOOLS="🔧"
+  BOOKS="📚"
+  ARROW="▶"
+else
+  CHECK_MARK="[OK]"
+  CROSS_MARK="[X]"
+  WARNING_MARK="[!]"
+  INFO_MARK="[i]"
+  ROCKET="[>]"
+  GEAR="[*]"
+  PACKAGE="[P]"
+  DOCUMENT="[D]"
+  ALERT="[!]"
+  PARTY="[*]"
+  TOOLS="[T]"
+  BOOKS="[B]"
+  ARROW=">"
+fi
+
+# Enhanced formatting functions
+print_banner() {
+  local title="$1"
+  local subtitle="$2"
+  local width=88
+
+  echo
+  printf "%*s\n" $width | tr ' ' '═'
+
+  # Main title
+  local title_len=${#title}
+  local title_padding=$(( (width - title_len - 4) / 2 ))
+  printf "║${BOLD}${BLUE}%*s %s %*s${ENDCOLOR}║\n" \
+    $title_padding "" "$title" $title_padding ""
+
+  # Subtitle if provided
+  if [[ -n "$subtitle" ]]; then
+    local subtitle_len=${#subtitle}
+    local subtitle_padding=$(( (width - subtitle_len - 4) / 2 ))
+    printf "║${DIM}%*s %s %*s${ENDCOLOR}║\n" \
+      $subtitle_padding "" "$subtitle" $subtitle_padding ""
+  fi
+
+  printf "%*s\n" $width | tr ' ' '═'
+  echo
+}
+
+print_section() {
+  local icon="$1"
+  local title="$2"
+  local description="$3"
+
+  echo
+  echo -e "${BOLD}${BLUE}$icon $title${ENDCOLOR}"
+  if [[ -n "$description" ]]; then
+    echo -e "${DIM}$description${ENDCOLOR}"
+  fi
+  printf "${BLUE}%*s${ENDCOLOR}\n" 80 | tr ' ' '─'
+}
+
+print_status() {
+  local status="$1"
+  local message="$2"
+  local detail="$3"
+
+  case $status in
+    "success")
+      printf "  ${GREEN}${CHECK_MARK}${ENDCOLOR} %s" "$message"
+      ;;
+    "error")
+      printf "  ${RED}${CROSS_MARK}${ENDCOLOR} %s" "$message"
+      ;;
+    "warning")
+      printf "  ${YELLOW}${WARNING_MARK}${ENDCOLOR} %s" "$message"
+      ;;
+    "info")
+      printf "  ${CYAN}${INFO_MARK}${ENDCOLOR} %s" "$message"
+      ;;
+    "processing")
+      printf "  ${PURPLE}${GEAR}${ENDCOLOR} %s" "$message"
+      ;;
+  esac
+
+  if [[ -n "$detail" ]]; then
+    printf "\n    ${DIM}%s${ENDCOLOR}" "$detail"
+  fi
+  echo
+}
+
+print_subsection() {
+  local title="$1"
+  echo
+  echo -e "  ${BOLD}${PURPLE}${ARROW} $title${ENDCOLOR}"
+  printf "  ${PURPLE}%*s${ENDCOLOR}\n" 50 | tr ' ' '┈'
+}
+
+print_table_header() {
+  echo
+  local line1="┌$(printf '─%.0s' {1..29})┬$(printf '─%.0s' {1..18})┬$(printf '─%.0s' {1..15})┬$(printf '─%.0s' {1..13})┐"
+  local line2="│ $(printf '%-27s' 'Library') │ $(printf '%-16s' 'Architecture') │ $(printf '%-13s' 'Alignment') │ $(printf '%-11s' 'Status') │"
+  local line3="├$(printf '─%.0s' {1..29})┼$(printf '─%.0s' {1..18})┼$(printf '─%.0s' {1..15})┼$(printf '─%.0s' {1..13})┤"
+
+  echo -e "${CYAN}$line1${ENDCOLOR}"
+  echo -e "${BOLD}${CYAN}$line2${ENDCOLOR}"
+  echo -e "${CYAN}$line3${ENDCOLOR}"
+}
+
+print_table_row() {
+  local lib="$1"
+  local arch="$2"
+  local alignment="$3"
+  local status="$4"
+  local is_critical="$5"
+
+  local status_symbol
+  local status_color
+  local status_text
+
+  if [[ $status == "ALIGNED" ]]; then
+    status_symbol="$CHECK_MARK"
+    status_color="$GREEN"
+    status_text="PASS"
+  else
+    status_symbol="$CROSS_MARK"
+    if [[ $is_critical == "true" ]]; then
+      status_color="$RED"
+      status_text="FAIL"
+    else
+      status_color="$YELLOW"
+      status_text="WARN"
+    fi
+  fi
+
+  # Truncate library name if too long
+  local display_lib="$lib"
+  if [[ ${#lib} -gt 27 ]]; then
+    display_lib="${lib:0:24}..."
+  fi
+
+  printf "${CYAN}│${ENDCOLOR} %-27s ${CYAN}│${ENDCOLOR} %-16s ${CYAN}│${ENDCOLOR} %-13s ${CYAN}│${ENDCOLOR} ${status_color}%s %-7s${ENDCOLOR} ${CYAN}│${ENDCOLOR}\n" \
+    "$display_lib" "$arch" "$alignment" "$status_symbol" "$status_text"
+
+  if [[ $is_critical == "true" && $status == "UNALIGNED" ]]; then
+    printf "${CYAN}│${ENDCOLOR} ${RED}%-75s${ENDCOLOR} ${CYAN}│${ENDCOLOR}\n" "  ${ALERT} CRITICAL: Required for Google Play compliance!"
+  fi
+}
+
+print_table_footer() {
+  local line="└$(printf '─%.0s' {1..29})┴$(printf '─%.0s' {1..18})┴$(printf '─%.0s' {1..15})┴$(printf '─%.0s' {1..13})┘"
+  echo -e "${CYAN}$line${ENDCOLOR}"
+  echo
+}
+
+print_summary_box() {
+  local title="$1"
+  local status="$2" # success, warning, error
+  shift 2
+  local lines=("$@")
+
+  local box_color
+  local title_color
+  case $status in
+    "success") box_color="$GREEN"; title_color="$GREEN" ;;
+    "warning") box_color="$YELLOW"; title_color="$YELLOW" ;;
+    "error") box_color="$RED"; title_color="$RED" ;;
+    *) box_color="$BLUE"; title_color="$BLUE" ;;
+  esac
+
+  local width=78
+  echo
+  printf "${box_color}┌%*s┐${ENDCOLOR}\n" $((width-2)) | tr ' ' '─'
+
+  # Title
+  local title_len=${#title}
+  local title_padding=$(( (width - title_len - 4) / 2 ))
+  printf "${box_color}│${ENDCOLOR}${BOLD}${title_color}%*s %s %*s${ENDCOLOR}${box_color}│${ENDCOLOR}\n" \
+    $title_padding "" "$title" $title_padding ""
+
+  printf "${box_color}├%*s┤${ENDCOLOR}\n" $((width-2)) | tr ' ' '─'
+
+  # Content lines
+  for line in "${lines[@]}"; do
+    printf "${box_color}│${ENDCOLOR} %-*s ${box_color}│${ENDCOLOR}\n" $((width-4)) "$line"
+  done
+
+  printf "${box_color}└%*s┘${ENDCOLOR}\n" $((width-2)) | tr ' ' '─'
+  echo
+}
+
+cleanup_trap() {
+  if [ -n "${tmp}" -a -d "${tmp}" ]; then
+    print_status "processing" "Cleaning up temporary files..."
+    rm -rf "${tmp}"
+  fi
+  exit $1
+}
+
+usage() {
+  print_banner "Android 16KB Page Size Compatibility Checker" "Google Play Compliance Tool"
+
+  echo -e "${BOLD}DESCRIPTION:${ENDCOLOR}"
+  echo "  This tool verifies that your Android app's native libraries are compatible"
+  echo "  with 16KB page size devices, as required by Google Play starting November 1st, 2025."
+  echo
+
+  echo -e "${BOLD}USAGE:${ENDCOLOR}"
+  echo -e "  ${GREEN}$progname${ENDCOLOR} ${CYAN}[input-path|input-APK|input-APEX]${ENDCOLOR}"
+  echo
+
+  echo -e "${BOLD}EXAMPLES:${ENDCOLOR}"
+  echo -e "  ${DIM}# Check an APK file${ENDCOLOR}"
+  echo -e "  $progname ${CYAN}app/build/outputs/apk/release/app-release.apk${ENDCOLOR}"
+  echo
+  echo -e "  ${DIM}# Check a directory of native libraries${ENDCOLOR}"
+  echo -e "  $progname ${CYAN}/path/to/native/libs/${ENDCOLOR}"
+  echo
+
+  echo -e "${BOLD}WHAT THIS TOOL CHECKS:${ENDCOLOR}"
+  echo -e "  ${CHECK_MARK} APK zip-alignment for 16KB boundaries (requires build-tools 35.0.0+)"
+  echo -e "  ${CHECK_MARK} ELF segment alignment in native libraries (arm64-v8a and x86_64)"
+  echo -e "  ${CHECK_MARK} Compliance with Android 16KB page size requirements"
+  echo
+
+  echo -e "${BOLD}RESULT MEANINGS:${ENDCOLOR}"
+  echo -e "  ${GREEN}${CHECK_MARK} PASS${ENDCOLOR}  - Library is compatible with 16KB page sizes (2**14 or higher)"
+  echo -e "  ${RED}${CROSS_MARK} FAIL${ENDCOLOR}  - Library needs recompilation with 16KB ELF alignment"
+  echo -e "  ${YELLOW}${WARNING_MARK} WARN${ENDCOLOR}  - Non-critical architecture but should be fixed"
+  echo
+}
+
+# Enhanced dependency checking
+check_dependencies() {
+  print_section "$GEAR" "Dependency Check" "Verifying required tools are available"
+
+  local missing_tools=()
+  local available_tools=()
+
+  # Check each tool
+  local tools=("objdump" "unzip" "file")
+  for tool in "${tools[@]}"; do
+    if command -v "$tool" >/dev/null 2>&1; then
+      available_tools+=("$tool")
+      print_status "success" "$tool" "$(which "$tool")"
+    else
+      missing_tools+=("$tool")
+      print_status "error" "$tool not found"
+    fi
+  done
+
+  if [ ${#missing_tools[@]} -gt 0 ]; then
+    echo
+    print_subsection "Installation Instructions"
+    for tool in "${missing_tools[@]}"; do
+      case $tool in
+        objdump)
+          print_status "info" "Install objdump:" "macOS: Xcode Command Line Tools or Android NDK's llvm-objdump"
+          print_status "info" "" "Linux: sudo apt-get install binutils (Ubuntu/Debian)"
+          ;;
+        unzip)
+          print_status "info" "Install unzip:" "Usually pre-installed on most systems"
+          print_status "info" "" "Linux: sudo apt-get install unzip"
+          ;;
+        file)
+          print_status "info" "Install file:" "Usually pre-installed on most systems"
+          print_status "info" "" "Linux: sudo apt-get install file"
+          ;;
+      esac
+      echo
+    done
+    exit 1
+  fi
+
+  print_status "success" "All dependencies satisfied" "${#available_tools[@]} tools available"
+}
+
+# Validate input arguments
+if [ ${#} -ne 1 ]; then
+  usage
+  exit 1
+fi
+
+case ${1} in
+  --help | -h | -\?)
+    usage
+    exit 0
+    ;;
+  *)
+    dir="${1}"
+    ;;
+esac
+
+# Validate input file/directory
+if ! [ -f "${dir}" -o -d "${dir}" ]; then
+  print_status "error" "Invalid input: ${dir}"
+  echo "  Please provide a valid APK file, APEX file, or directory containing native libraries."
+  exit 1
+fi
+
+# Check dependencies before proceeding
+check_dependencies
+
+print_banner "ANALYSIS IN PROGRESS" "Checking 16KB Page Size Compatibility"
+
+print_status "processing" "Target: $(basename "${dir}")"
+print_status "info" "Compliance Deadline: November 1st, 2025"
+print_status "info" "Requirement: Apps targeting Android 15+ must support 16KB pages"
+
+# APK Processing
+if [[ "${dir}" == *.apk ]]; then
+  trap 'cleanup_trap' EXIT
+
+  print_section "$PACKAGE" "APK Analysis" "Processing Android Package file"
+
+  # Enhanced zipalign check
+  if command -v zipalign >/dev/null 2>&1; then
+    if { zipalign --help 2>&1 | grep -q "\-P <pagesize_kb>"; }; then
+      print_status "processing" "Checking APK zip-alignment for 16KB boundaries..."
+
+      zip_result=$(zipalign -v -c -P 16 4 "${dir}" 2>&1)
+      zip_exit_code=$?
+
+      if [ $zip_exit_code -eq 0 ]; then
+        print_status "success" "APK zip-alignment verification passed"
+      else
+        print_status "error" "APK zip-alignment verification failed"
+        echo "    ${DIM}Details:${ENDCOLOR}"
+        echo "$zip_result" | grep -E 'lib/arm64-v8a|lib/x86_64|Verification|would be' | sed 's/^/      /' || echo "      $zip_result"
+      fi
+    else
+      print_status "warning" "zipalign version doesn't support 16KB alignment checks"
+      print_status "info" "Solution: Update to Android SDK build-tools 35.0.0+"
+      echo "    ${DIM}Update via Android Studio → SDK Manager → SDK Tools${ENDCOLOR}"
+      echo "    ${DIM}Or run: sdkmanager \"build-tools;35.0.0\"${ENDCOLOR}"
+    fi
+  else
+    print_status "warning" "zipalign not found in PATH"
+    print_status "info" "Ensure Android SDK build-tools are installed and in PATH"
+  fi
+
+  # Extract APK
+  dir_filename=$(basename "${dir}")
+  tmp=$(mktemp -d -t "${dir_filename%.apk}_out_XXXXX")
+
+  if [ ! -d "${tmp}" ]; then
+    print_status "error" "Failed to create temporary directory"
+    exit 1
+  fi
+
+  print_status "processing" "Extracting native libraries from APK..."
+  if ! unzip -q "${dir}" "lib/*" -d "${tmp}" 2>/dev/null; then
+    print_summary_box "NO NATIVE LIBRARIES FOUND" "success" \
+      "${PARTY} Your app contains only Java/Kotlin code!" \
+      "" \
+      "${CHECK_MARK} Apps without native libraries automatically support 16KB devices" \
+      "${CHECK_MARK} No additional changes required for Google Play compliance" \
+      "${CHECK_MARK} You're all set for the November 1st, 2025 deadline!"
+    cleanup_trap 0
+  fi
+
+  dir="${tmp}"
+fi
+
+# APEX Processing
+if [[ "${dir}" == *.apex ]]; then
+  trap 'cleanup_trap' EXIT
+
+  print_section "$DOCUMENT" "APEX Analysis" "Processing Android Pony EXpress file"
+
+  if ! command -v deapexer >/dev/null 2>&1; then
+    print_status "error" "deapexer tool not found"
+    echo "    Please ensure Android SDK tools are properly installed and in your PATH."
+    exit 1
+  fi
+
+  dir_filename=$(basename "${dir}")
+  tmp=$(mktemp -d -t "${dir_filename%.apex}_out_XXXXX")
+
+  if [ ! -d "${tmp}" ]; then
+    print_status "error" "Failed to create temporary directory"
+    exit 1
+  fi
+
+  print_status "processing" "Extracting APEX contents..."
+  if ! deapexer extract "${dir}" "${tmp}"; then
+    print_status "error" "Failed to extract APEX file"
+    cleanup_trap 1
+  fi
+
+  dir="${tmp}"
+fi
+
+# Track libraries for enhanced summary
+unaligned_libs=()
+aligned_libs=()
+critical_unaligned_libs=()
+non_critical_unaligned_libs=()
+total_libs=0
+critical_libs=0
+
+print_section "$GEAR" "ELF Segment Analysis" "Scanning native libraries for 16KB alignment compliance"
+
+# Find all native libraries
+matches="$(find "${dir}" -type f -name '*.so' 2>/dev/null)"
+if [ -z "$matches" ]; then
+  # Also check for ELF files without .so extension
+  matches="$(find "${dir}" -type f -exec file {} \; 2>/dev/null | grep 'ELF' | cut -d: -f1)"
+fi
+
+if [ -z "$matches" ]; then
+  print_summary_box "NO NATIVE LIBRARIES DETECTED" "success" \
+    "${PARTY} Your app uses only Java/Kotlin code!" \
+    "" \
+    "${CHECK_MARK} No native library alignment issues to worry about" \
+    "${CHECK_MARK} Already compatible with 16KB page size devices" \
+    "${CHECK_MARK} Ready for Google Play's November 1st, 2025 requirement!"
+  cleanup_trap 0
+fi
+
+print_status "info" "Found native libraries - analyzing ELF segment alignment..."
+
+print_table_header
+
+IFS=$'\n'
+for match in $matches; do
+  # Skip non-ELF files and nested packages
+  if [[ "${match}" == *".apk" ]]; then
+    continue
+  fi
+  if [[ "${match}" == *".apex" ]]; then
+    continue
+  fi
+
+  # Verify it's actually an ELF file
+  if ! [[ $(file "${match}" 2>/dev/null) == *"ELF"* ]]; then
+    continue
+  fi
+
+  total_libs=$((total_libs + 1))
+
+  # Determine architecture and criticality
+  arch="unknown"
+  is_critical="false"
+  if [[ "${match}" == *"arm64-v8a"* ]]; then
+    arch="arm64-v8a"
+    is_critical="true"
+    critical_libs=$((critical_libs + 1))
+  elif [[ "${match}" == *"x86_64"* ]]; then
+    arch="x86_64"
+    is_critical="true"
+    critical_libs=$((critical_libs + 1))
+  elif [[ "${match}" == *"armeabi-v7a"* ]]; then
+    arch="armeabi-v7a"
+  elif [[ "${match}" == *"x86"* ]]; then
+    arch="x86"
+  fi
+
+  # Check ELF segment alignment
+  res="$(objdump -p "${match}" 2>/dev/null | grep LOAD | awk '{ print $NF }' | head -1)"
+
+  if [ -z "$res" ]; then
+    print_table_row "$(basename "${match}")" "$arch" "UNKNOWN" "FAILED" "$is_critical"
+    continue
+  fi
+
+  # Check if alignment meets 16KB requirement (2**14 or higher)
+  if [[ $res =~ 2\*\*(1[4-9]|[2-9][0-9]|[1-9][0-9]{2,}) ]]; then
+    print_table_row "$(basename "${match}")" "$arch" "$res" "ALIGNED" "$is_critical"
+    aligned_libs+=("${match}")
+  else
+    print_table_row "$(basename "${match}")" "$arch" "$res" "UNALIGNED" "$is_critical"
+    unaligned_libs+=("${match}")
+
+    if [[ "$is_critical" == "true" ]]; then
+      critical_unaligned_libs+=("${match}")
+    else
+      non_critical_unaligned_libs+=("${match}")
+    fi
+  fi
+done
+
+print_table_footer
+
+# Enhanced Summary Section
+if [ ${#unaligned_libs[@]} -gt 0 ]; then
+  # Failure case - unaligned libraries found
+  summary_lines=(
+    "${ALERT} ACTION REQUIRED: Unaligned native libraries detected!"
+    ""
+    "Analysis Results:"
+    "  • Total libraries scanned: $total_libs"
+    "  • Critical architectures (64-bit): $critical_libs"
+    "  • Libraries aligned: ${#aligned_libs[@]}"
+    "  • Libraries UNALIGNED: ${#unaligned_libs[@]}"
+  )
+
+  if [ ${#critical_unaligned_libs[@]} -gt 0 ]; then
+    summary_lines+=("  • Critical failures: ${#critical_unaligned_libs[@]} (MUST FIX)")
+  fi
+
+  if [ ${#non_critical_unaligned_libs[@]} -gt 0 ]; then
+    summary_lines+=("  • Non-critical warnings: ${#non_critical_unaligned_libs[@]} (SHOULD FIX)")
+  fi
+
+  summary_lines+=("")
+  summary_lines+=("Google Play Compliance: FAILED")
+  summary_lines+=("Deadline: November 1st, 2025")
+
+  print_summary_box "COMPATIBILITY CHECK FAILED" "error" "${summary_lines[@]}"
+
+  # Detailed library breakdown
+  if [ ${#critical_unaligned_libs[@]} -gt 0 ]; then
+    print_subsection "Critical Libraries Requiring Immediate Attention"
+    for lib in "${critical_unaligned_libs[@]}"; do
+      arch_type="64-bit"
+      [[ "${lib}" == *"arm64-v8a"* ]] && arch_type="ARM64"
+      [[ "${lib}" == *"x86_64"* ]] && arch_type="x86_64"
+      print_status "error" "$(basename "$lib")" "$arch_type architecture - Required for Google Play"
+    done
+  fi
+
+  if [ ${#non_critical_unaligned_libs[@]} -gt 0 ]; then
+    print_subsection "Non-Critical Libraries (Recommended to Fix)"
+    for lib in "${non_critical_unaligned_libs[@]}"; do
+      arch_type="32-bit"
+      [[ "${lib}" == *"armeabi-v7a"* ]] && arch_type="ARMv7"
+      [[ "${lib}" == *"x86"* ]] && arch_type="x86"
+      print_status "warning" "$(basename "$lib")" "$arch_type architecture"
+    done
+  fi
+
+  # Comprehensive fix instructions
+  print_section "$TOOLS" "How to Fix Unaligned Libraries" "Step-by-step guide to achieve 16KB compatibility"
+
+  print_subsection "Step 1: Update Your Build Environment"
+  print_status "info" "Android Gradle Plugin (AGP)" "Upgrade to version 8.5.1 or higher"
+  print_status "info" "Android NDK" "Update to NDK r27 or higher (r28+ recommended)"
+  print_status "info" "Build Tools" "Ensure Android SDK build-tools 35.0.0+ for zipalign"
+
+  print_subsection "Step 2: Configure 16KB ELF Alignment"
+  echo
+  echo -e "${BOLD}For NDK r28 and newer:${ENDCOLOR}"
+  print_status "success" "Automatic Support" "16KB alignment enabled by default - no changes needed!"
+
+  echo
+  echo -e "${BOLD}For NDK r27:${ENDCOLOR}"
+  print_status "info" "Gradle Configuration" "Add to your app/build.gradle:"
+  echo -e "${DIM}    android {"
+  echo -e "        defaultConfig {"
+  echo -e "            externalNativeBuild {"
+  echo -e "                cmake {"
+  echo -e "                    arguments '-DANDROID_SUPPORT_FLEXIBLE_PAGE_SIZES=ON'"
+  echo -e "                }"
+  echo -e "            }"
+  echo -e "        }"
+  echo -e "    }${ENDCOLOR}"
+
+  print_status "info" "NDK-Build Configuration" "Add to Application.mk:"
+  echo -e "${DIM}    APP_SUPPORT_FLEXIBLE_PAGE_SIZES := true${ENDCOLOR}"
+
+  echo
+  echo -e "${BOLD}For NDK r26 and older:${ENDCOLOR}"
+  print_status "info" "Manual Linker Flags" "Add to your native build configuration:"
+  echo -e "${DIM}    # For Android.mk:"
+  echo -e "    LOCAL_LDFLAGS += \"-Wl,-z,max-page-size=16384\""
+  echo
+  echo -e "    # For CMakeLists.txt:"
+  echo -e "    target_link_options(\${CMAKE_PROJECT_NAME} PRIVATE \"-Wl,-z,max-page-size=16384\")${ENDCOLOR}"
+
+  print_subsection "Step 3: Update Library Packaging"
+  print_status "info" "AGP 8.5.1+" "Uncompressed libraries used by default (no changes needed)"
+  print_status "info" "Older AGP versions" "Add to app/build.gradle:"
+  echo -e "${DIM}    android {"
+  echo -e "        packagingOptions {"
+  echo -e "            jniLibs {"
+  echo -e "                useLegacyPackaging = true"
+  echo -e "            }"
+  echo -e "        }"
+  echo -e "    }${ENDCOLOR}"
+
+  print_subsection "Step 4: Build and Verify"
+  print_status "processing" "Clean Build" "Run ./gradlew clean"
+  print_status "processing" "Rebuild Project" "Run ./gradlew assembleRelease"
+  print_status "processing" "Re-run This Script" "Verify all libraries are now aligned"
+  print_status "processing" "Test on Device" "Use Android 15 emulator with 16KB system image"
+
+  print_section "$BOOKS" "Additional Resources" "Learn more about 16KB page size support"
+  print_status "info" "Official Guide" "https://developer.android.com/guide/practices/page-sizes"
+  print_status "info" "NDK Documentation" "https://developer.android.com/ndk/guides/"
+  print_status "info" "Testing Guide" "Use 'adb shell getconf PAGE_SIZE' (should return 16384)"
+  print_status "info" "Emulator Setup" "Android 15 system images with 16KB page size"
+
+  final_message=""
+  if [ ${#critical_unaligned_libs[@]} -gt 0 ]; then
+    final_message="CRITICAL: Fix required for Google Play compliance by November 1st, 2025!"
+  else
+    final_message="Warning: Non-critical issues found - recommended to fix for complete compatibility"
+  fi
+
+  print_summary_box "NEXT STEPS" "error" \
+    "$final_message" \
+    "" \
+    "1. Update your build tools and NDK version" \
+    "2. Apply the configuration changes above" \
+    "3. Clean and rebuild your project" \
+    "4. Run this script again to verify fixes" \
+    "5. Test thoroughly on 16KB devices/emulator"
+
+  cleanup_trap 1
+else
+  # Success case - all libraries aligned
+  summary_lines=(
+    "${PARTY} All native libraries are properly aligned!"
+    ""
+    "Analysis Results:"
+    "  • Total libraries scanned: $total_libs"
+    "  • Critical architectures: $critical_libs"
+    "  • All libraries: ${#aligned_libs[@]}/${total_libs} ALIGNED"
+    ""
+    "Google Play Compliance: PASSED ${CHECK_MARK}"
+    "Ready for November 1st, 2025 deadline!"
+  )
+
+  print_summary_box "COMPATIBILITY CHECK PASSED" "success" "${summary_lines[@]}"
+
+  print_section "$ROCKET" "Next Steps" "Ensure complete 16KB compatibility"
+
+  print_status "success" "Library Alignment" "All ELF segments properly aligned for 16KB pages"
+  print_status "info" "Runtime Testing" "Test on Android 15 emulator with 16KB system image"
+  print_status "info" "Code Review" "Check for hardcoded PAGE_SIZE dependencies in your code"
+  print_status "info" "Third-party SDKs" "Verify all dependencies are 16KB compatible"
+  print_status "info" "Zipalign Verification" "Run: zipalign -c -P 16 -v 4 your-app.apk"
+
+  print_subsection "Testing Commands"
+  echo -e "${DIM}  # Verify page size on device/emulator${ENDCOLOR}"
+  echo -e "${DIM}  adb shell getconf PAGE_SIZE    # Should return: 16384${ENDCOLOR}"
+  echo
+  echo -e "${DIM}  # Verify APK alignment${ENDCOLOR}"
+  echo -e "${DIM}  zipalign -c -P 16 -v 4 app-release.apk${ENDCOLOR}"
+
+  print_summary_box "CONGRATULATIONS!" "success" \
+    "${PARTY} Your app is 16KB page size compatible!" \
+    "" \
+    "${CHECK_MARK} All native libraries meet Google Play requirements" \
+    "${CHECK_MARK} Ready for devices with 16KB page sizes" \
+    "${CHECK_MARK} Compliant with November 1st, 2025 deadline" \
+    "" \
+    "Recommendation: Test thoroughly on 16KB environment to ensure" \
+    "no runtime issues exist in your application code."
+fi
+
+echo
+print_status "info" "Analysis completed at $(date)"
+echo
diff --git a/src/serious_python_android/src/CMakeLists.txt b/src/serious_python_android/src/CMakeLists.txt
index 2d52ffcd..c2800814 100644
--- a/src/serious_python_android/src/CMakeLists.txt
+++ b/src/serious_python_android/src/CMakeLists.txt
@@ -14,4 +14,11 @@ set_target_properties(serious_python PROPERTIES
   OUTPUT_NAME "serious_python"
 )
 
+# Add 16 KB page size support for Android 15
+if(ANDROID)
+    set_target_properties(serious_python PROPERTIES
+        LINK_FLAGS "-Wl,-z,max-page-size=16384"
+    )
+endif()
+
 target_compile_definitions(serious_python PUBLIC DART_SHARED_LIB)

From 92e76d076e83462ae9b4d6c42eef0bf3a215ebbb Mon Sep 17 00:00:00 2001
From: Feodor Fitsner <feodor@appveyor.com>
Date: Mon, 20 Oct 2025 09:39:24 -0700
Subject: [PATCH 2/3] Bump version to 0.9.4

---
 src/serious_python/CHANGELOG.md                               | 4 ++++
 src/serious_python/pubspec.yaml                               | 2 +-
 src/serious_python_android/CHANGELOG.md                       | 4 ++++
 src/serious_python_android/android/build.gradle               | 2 +-
 src/serious_python_android/pubspec.yaml                       | 2 +-
 src/serious_python_darwin/CHANGELOG.md                        | 4 ++++
 .../darwin/serious_python_darwin.podspec                      | 2 +-
 src/serious_python_darwin/pubspec.yaml                        | 2 +-
 src/serious_python_linux/CHANGELOG.md                         | 4 ++++
 src/serious_python_linux/pubspec.yaml                         | 2 +-
 src/serious_python_platform_interface/CHANGELOG.md            | 4 ++++
 src/serious_python_platform_interface/pubspec.yaml            | 2 +-
 src/serious_python_windows/CHANGELOG.md                       | 4 ++++
 src/serious_python_windows/pubspec.yaml                       | 2 +-
 14 files changed, 32 insertions(+), 8 deletions(-)

diff --git a/src/serious_python/CHANGELOG.md b/src/serious_python/CHANGELOG.md
index c6a429d9..614940aa 100644
--- a/src/serious_python/CHANGELOG.md
+++ b/src/serious_python/CHANGELOG.md
@@ -1,3 +1,7 @@
+## 0.9.4
+
+* 16 KB memory page support for Android 15+ (by [@ReYaNOW](https://github.com/ReYaNOW)).
+
 ## 0.9.3
 
 * Fix: Hidden files in site-packages are skipped when building macOS app.
diff --git a/src/serious_python/pubspec.yaml b/src/serious_python/pubspec.yaml
index 2684f173..732cee5f 100644
--- a/src/serious_python/pubspec.yaml
+++ b/src/serious_python/pubspec.yaml
@@ -2,7 +2,7 @@ name: serious_python
 description: A cross-platform plugin for adding embedded Python runtime to your Flutter apps.
 homepage: https://flet.dev
 repository: https://github.com/flet-dev/serious-python
-version: 0.9.3
+version: 0.9.4
 
 platforms:
   ios:
diff --git a/src/serious_python_android/CHANGELOG.md b/src/serious_python_android/CHANGELOG.md
index 075ab98c..658f9f8d 100644
--- a/src/serious_python_android/CHANGELOG.md
+++ b/src/serious_python_android/CHANGELOG.md
@@ -1,3 +1,7 @@
+## 0.9.4
+
+* 16 KB memory page support for Android 15+ (by [@ReYaNOW](https://github.com/ReYaNOW)).
+
 ## 0.9.3
 
 * Fix: Hidden files in site-packages are skipped when building macOS app.
diff --git a/src/serious_python_android/android/build.gradle b/src/serious_python_android/android/build.gradle
index 52c5bb08..1c38c434 100644
--- a/src/serious_python_android/android/build.gradle
+++ b/src/serious_python_android/android/build.gradle
@@ -1,5 +1,5 @@
 group 'com.flet.serious_python_android'
-version '0.9.3'
+version '0.9.4'
 
 def python_version = '3.12'
 
diff --git a/src/serious_python_android/pubspec.yaml b/src/serious_python_android/pubspec.yaml
index e668e498..90adfe9c 100644
--- a/src/serious_python_android/pubspec.yaml
+++ b/src/serious_python_android/pubspec.yaml
@@ -2,7 +2,7 @@ name: serious_python_android
 description: Android implementation of the serious_python plugin
 homepage: https://flet.dev
 repository: https://github.com/flet-dev/serious-python
-version: 0.9.3
+version: 0.9.4
 
 environment:
   sdk: ">=3.0.0 <4.0.0"
diff --git a/src/serious_python_darwin/CHANGELOG.md b/src/serious_python_darwin/CHANGELOG.md
index 07cd93da..330b8328 100644
--- a/src/serious_python_darwin/CHANGELOG.md
+++ b/src/serious_python_darwin/CHANGELOG.md
@@ -1,3 +1,7 @@
+## 0.9.4
+
+* 16 KB memory page support for Android 15+ (by [@ReYaNOW](https://github.com/ReYaNOW)).
+
 ## 0.9.3
 
 * Fix: Hidden files in site-packages are skipped when building macOS app.
diff --git a/src/serious_python_darwin/darwin/serious_python_darwin.podspec b/src/serious_python_darwin/darwin/serious_python_darwin.podspec
index c73af73d..05f0de51 100644
--- a/src/serious_python_darwin/darwin/serious_python_darwin.podspec
+++ b/src/serious_python_darwin/darwin/serious_python_darwin.podspec
@@ -4,7 +4,7 @@
 #
 Pod::Spec.new do |s|
   s.name             = 'serious_python_darwin'
-  s.version          = '0.9.3'
+  s.version          = '0.9.4'
   s.summary          = 'A cross-platform plugin for adding embedded Python runtime to your Flutter apps.'
   s.description      = <<-DESC
   A cross-platform plugin for adding embedded Python runtime to your Flutter apps.
diff --git a/src/serious_python_darwin/pubspec.yaml b/src/serious_python_darwin/pubspec.yaml
index 1afc3908..655f04c3 100644
--- a/src/serious_python_darwin/pubspec.yaml
+++ b/src/serious_python_darwin/pubspec.yaml
@@ -2,7 +2,7 @@ name: serious_python_darwin
 description: iOS and macOS implementations of the serious_python plugin
 homepage: https://flet.dev
 repository: https://github.com/flet-dev/serious-python
-version: 0.9.3
+version: 0.9.4
 
 environment:
   sdk: ">=3.0.0 <4.0.0"
diff --git a/src/serious_python_linux/CHANGELOG.md b/src/serious_python_linux/CHANGELOG.md
index e4e42b45..0f06bba1 100644
--- a/src/serious_python_linux/CHANGELOG.md
+++ b/src/serious_python_linux/CHANGELOG.md
@@ -1,3 +1,7 @@
+## 0.9.4
+
+* 16 KB memory page support for Android 15+ (by [@ReYaNOW](https://github.com/ReYaNOW)).
+
 ## 0.9.3
 
 * Fix: Hidden files in site-packages are skipped when building macOS app.
diff --git a/src/serious_python_linux/pubspec.yaml b/src/serious_python_linux/pubspec.yaml
index f26b2c20..b2b22e82 100644
--- a/src/serious_python_linux/pubspec.yaml
+++ b/src/serious_python_linux/pubspec.yaml
@@ -2,7 +2,7 @@ name: serious_python_linux
 description: Linux implementations of the serious_python plugin
 homepage: https://flet.dev
 repository: https://github.com/flet-dev/serious-python
-version: 0.9.3
+version: 0.9.4
 
 environment:
   sdk: '>=3.1.3 <4.0.0'
diff --git a/src/serious_python_platform_interface/CHANGELOG.md b/src/serious_python_platform_interface/CHANGELOG.md
index c66601dd..bb1ffc8f 100644
--- a/src/serious_python_platform_interface/CHANGELOG.md
+++ b/src/serious_python_platform_interface/CHANGELOG.md
@@ -1,3 +1,7 @@
+## 0.9.4
+
+* 16 KB memory page support for Android 15+ (by [@ReYaNOW](https://github.com/ReYaNOW)).
+
 ## 0.9.3
 
 * Fix: Hidden files in site-packages are skipped when building macOS app.
diff --git a/src/serious_python_platform_interface/pubspec.yaml b/src/serious_python_platform_interface/pubspec.yaml
index 8e892462..a5428de2 100644
--- a/src/serious_python_platform_interface/pubspec.yaml
+++ b/src/serious_python_platform_interface/pubspec.yaml
@@ -2,7 +2,7 @@ name: serious_python_platform_interface
 description: A common platform interface for the serious_python plugin.
 homepage: https://flet.dev
 repository: https://github.com/flet-dev/serious-python
-version: 0.9.3
+version: 0.9.4
 
 environment:
   sdk: ">=3.0.0 <4.0.0"
diff --git a/src/serious_python_windows/CHANGELOG.md b/src/serious_python_windows/CHANGELOG.md
index 64dde934..a29364f5 100644
--- a/src/serious_python_windows/CHANGELOG.md
+++ b/src/serious_python_windows/CHANGELOG.md
@@ -1,3 +1,7 @@
+## 0.9.4
+
+* 16 KB memory page support for Android 15+ (by [@ReYaNOW](https://github.com/ReYaNOW)).
+
 ## 0.9.3
 
 * Fix: Hidden files in site-packages are skipped when building macOS app.
diff --git a/src/serious_python_windows/pubspec.yaml b/src/serious_python_windows/pubspec.yaml
index 9042d100..823f9799 100644
--- a/src/serious_python_windows/pubspec.yaml
+++ b/src/serious_python_windows/pubspec.yaml
@@ -2,7 +2,7 @@ name: serious_python_windows
 description: Windows implementations of the serious_python plugin
 homepage: https://flet.dev
 repository: https://github.com/flet-dev/serious-python
-version: 0.9.3
+version: 0.9.4
 
 environment:
   sdk: '>=3.1.3 <4.0.0'

From 41c8c51db18329986a525dcf0e12143208ecdbf8 Mon Sep 17 00:00:00 2001
From: Feodor Fitsner <feodor@appveyor.com>
Date: Mon, 20 Oct 2025 10:39:53 -0700
Subject: [PATCH 3/3] Increase minSdkVersion to 21 in build.gradle

Updated the Android project's minimum SDK version from 16 to 21 to ensure compatibility with newer APIs and libraries.
---
 src/serious_python_android/android/build.gradle | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/serious_python_android/android/build.gradle b/src/serious_python_android/android/build.gradle
index 1c38c434..35d43607 100644
--- a/src/serious_python_android/android/build.gradle
+++ b/src/serious_python_android/android/build.gradle
@@ -54,7 +54,7 @@ android {
     }
 
     defaultConfig {
-        minSdkVersion 16
+        minSdkVersion 21
 
         ndk {
             abiFilters 'arm64-v8a', 'armeabi-v7a', 'x86_64'