Support Python 3.13 Android builds and packaging

Bump CI to Python 3.13.12 and add logic to handle CPython 3.13+ changes: only arm64-v8a and x86_64 ABIs are supported by the official Android/android.py flow, so build scripts and the GitHub workflow now compute a version_int and conditionally skip armeabi-v7a for 3.13+. build.sh was updated to use CPython's Android tooling for >=3.13, set ANDROID_HOME/ANDROID_API_LEVEL/NDK linkage as needed, and enforce supported ABIs. The legacy 3.13_pending patch was removed. Packaging scripts for Android, iOS and macOS now require a host pythonX.Y to compile stdlib bytecode with an isolated interpreter (-I -m compileall -b) to avoid importing from target dirs. README updated to note the new CPython Android build flow and ABI support.

Author: FeodorFitsner

.github/workflows/build-python.yml

@@ -7,8 +7,8 @@ on:
   workflow_dispatch:
 
 env:
-  PYTHON_VERSION: 3.12.12
-  PYTHON_VERSION_SHORT: 3.12
+  PYTHON_VERSION: 3.13.12
+  PYTHON_VERSION_SHORT: 3.13
   PYTHON_DIST_RELEASE: 20260203
 
 jobs:
@@ -71,8 +71,12 @@ jobs:
           mkdir -p dist
           tar -czf dist/python-android-mobile-forge-$PYTHON_VERSION_SHORT.tar.gz install support
           bash ./package-for-dart.sh install "$PYTHON_VERSION" arm64-v8a
-          bash ./package-for-dart.sh install "$PYTHON_VERSION" armeabi-v7a
           bash ./package-for-dart.sh install "$PYTHON_VERSION" x86_64
+          read version_major version_minor < <(echo "$PYTHON_VERSION" | sed -E 's/^([0-9]+)\.([0-9]+).*/\1 \2/')
+          version_int=$((version_major * 100 + version_minor))
+          if [ $version_int -lt 313 ]; then
+            bash ./package-for-dart.sh install "$PYTHON_VERSION" armeabi-v7a
+          fi
       - uses: actions/upload-artifact@v4
         with:
           name: python-android

android/README.md

@@ -3,24 +3,27 @@
 Scripts and CI jobs for building Python 3 for Android.
 
 * Can be run on both Linux and macOS.
-* Build Python 3.12 - specific or the last minor version.
+* Build Python 3.x - specific or the last minor version.
 * Installs NDK r29 or use pre-installed one with path configured by `NDK_HOME` variable.
 * Creates Python installation with a structure suitable for https://github.com/flet-dev/mobile-forge
+* Python 3.13+ uses CPython's official `Android/android.py` build flow.
 
 ## Usage
 
-To build the latest minor version of Python 3.12 for selected Android API:
+To build Python for a specific ABI:
 
 ```
-./build.sh 3.12 arm64-v8a
+./build.sh 3.13.12 arm64-v8a
 ```
 
 To build all ABIs:
 
 ```
-./build-all.sh 3.12
+./build-all.sh 3.13.12
 ```
 
+For Python 3.13+, official CPython Android tooling currently supports `arm64-v8a` and `x86_64`.
+
 ## Credits
 
 Build process depends on:

android/build-all.sh

@@ -2,7 +2,16 @@
 set -euo pipefail
 
 python_version=${1:?}
-abis="arm64-v8a armeabi-v7a x86_64 x86"
+read version_major version_minor < <(
+    echo "$python_version" | sed -E 's/^([0-9]+)\.([0-9]+).*/\1 \2/'
+)
+version_int=$((version_major * 100 + version_minor))
+
+if [ $version_int -ge 313 ]; then
+    abis="arm64-v8a x86_64"
+else
+    abis="arm64-v8a armeabi-v7a x86_64 x86"
+fi
 
 for abi in $abis; do
     bash ./build.sh $python_version $abi

android/build.sh

@@ -20,7 +20,11 @@ mkdir -p $downloads
 
 cd $script_dir
 . abi-to-host.sh
-. android-env.sh
+: ${api_level:=24}
+
+if [ $version_int -le 312 ]; then
+    . android-env.sh
+fi
 
 # Download and unpack Python source code.
 version_dir=$script_dir/build/$version
@@ -49,10 +53,6 @@ fi
 if [ $version_int -eq 312 ]; then
     patches+=" bldlibrary grp"
 fi
-if [ $version_int -eq 313 ]; then
-    # TODO: remove this once it's merged upstream.
-    patches+=" 3.13_pending"
-fi
 for name in $patches; do
     patch_file="$script_dir/patches/$name.patch"
     echo "$patch_file"
@@ -145,9 +145,43 @@ if [ $version_int -le 312 ]; then
 
 # Python 3.13 and later comes with an official Android build script.
 else
-    mkdir -p cross-build/build
-    ln -s "$(which python$version_short)" cross-build/build/python
+    case "$abi" in
+        arm64-v8a|x86_64)
+            ;;
+        *)
+            echo "Python $version_short official Android build supports only: arm64-v8a, x86_64"
+            exit 1
+            ;;
+    esac
+
+    # CPython's Android tooling expects ANDROID_HOME and ANDROID_API_LEVEL.
+    export ANDROID_API_LEVEL="$api_level"
+    if [ -z "${ANDROID_HOME:-}" ]; then
+        if [ -d "$HOME/Library/Android/sdk" ]; then
+            export ANDROID_HOME="$HOME/Library/Android/sdk"
+        elif [ -d "$HOME/Android/Sdk" ]; then
+            export ANDROID_HOME="$HOME/Android/Sdk"
+        else
+            export ANDROID_HOME="$script_dir/android-sdk"
+            mkdir -p "$ANDROID_HOME"
+        fi
+    fi
+
+    # Reuse NDK installed by this repo's older workflow by exposing it
+    # at the path expected by CPython's Android/android-env.sh.
+    if [ -z "${NDK_HOME:-}" ] && [ -d "$HOME/ndk/r29" ]; then
+        export NDK_HOME="$HOME/ndk/r29"
+    fi
+    cpython_ndk_version=$(sed -n 's/^ndk_version=//p' Android/android-env.sh | head -n1)
+    if [ -n "${NDK_HOME:-}" ] && [ -d "$NDK_HOME" ] && [ -n "${cpython_ndk_version:-}" ]; then
+        mkdir -p "$ANDROID_HOME/ndk"
+        if [ ! -e "$ANDROID_HOME/ndk/$cpython_ndk_version" ]; then
+            ln -s "$NDK_HOME" "$ANDROID_HOME/ndk/$cpython_ndk_version"
+        fi
+    fi
 
+    Android/android.py configure-build
+    Android/android.py make-build
     Android/android.py configure-host "$HOST"
     Android/android.py make-host "$HOST"
     cp -a "cross-build/$HOST/prefix/"* "$PREFIX"

android/package-for-dart.sh

@@ -13,6 +13,11 @@ script_dir=$(dirname $(realpath $0))
 # build short Python version
 read python_version_major python_version_minor < <(echo $python_version | sed -E 's/^([0-9]+)\.([0-9]+).*/\1 \2/')
 python_version_short=$python_version_major.$python_version_minor
+python_bin=$(command -v "python$python_version_short" || true)
+if [ -z "$python_bin" ]; then
+    echo "python$python_version_short is required to compile stdlib bytecode"
+    exit 1
+fi
 
 # create build dir
 build_dir=build/python-$python_version/$abi
@@ -39,8 +44,8 @@ mv $build_dir/lib/python$python_version_short/lib-dynload $bundle_dir/modules
 
 # stdlib
 # stdlib_zip=$bundle_dir/stdlib.zip
+"$python_bin" -I -m compileall -b "$build_dir/lib/python$python_version_short"
 cd $build_dir/lib/python$python_version_short
-python -m compileall -b .
 find . \( -name '*.so' -or -name '*.py' -or -name '*.typed' \) -type f -delete
 rm -rf __pycache__
 rm -rf **/__pycache__

android/patches/3.13_pending.patch

@@ -11,6 +11,11 @@ script_dir=$(dirname $(realpath $0))
 # build short Python version
 read python_version_major python_version_minor < <(echo $python_version | sed -E 's/^([0-9]+)\.([0-9]+).*/\1 \2/')
 python_version_short=$python_version_major.$python_version_minor
+python_bin=$(command -v "python$python_version_short" || true)
+if [ -z "$python_bin" ]; then
+    echo "python$python_version_short is required to compile stdlib bytecode"
+    exit 1
+fi
 
 # create build directory
 build_dir=build/python-$python_version
@@ -63,9 +68,9 @@ for arch in "${archs[@]}"; do
     rm -rf $stdlib_dir/$arch
 done
 
-# compile stdlib
+# compile stdlib with an isolated interpreter, without importing from target stdlib dir.
+"$python_bin" -I -m compileall -b "$stdlib_dir"
 cd $stdlib_dir
-python -m compileall -b .
 find . \( -name '*.so' -or -name "*.$dylib_ext" -or -name '*.py' -or -name '*.typed' \) -type f -delete
 rm -rf __pycache__
 rm -rf **/__pycache__

darwin/package-ios-for-dart.sh

@@ -9,6 +9,11 @@ script_dir=$(dirname $(realpath $0))
 # build short Python version
 read python_version_major python_version_minor < <(echo $python_version | sed -E 's/^([0-9]+)\.([0-9]+).*/\1 \2/')
 python_version_short=$python_version_major.$python_version_minor
+python_bin=$(command -v "python$python_version_short" || true)
+if [ -z "$python_bin" ]; then
+    echo "python$python_version_short is required to compile stdlib bytecode"
+    exit 1
+fi
 
 # create build directory
 build_dir=build/python-$python_version
@@ -34,9 +39,9 @@ rm $frameworks_dir/Python.xcframework/macos-arm64_x86_64/Python.framework/Header
 # copy stdlibs
 rsync -av --exclude-from=$script_dir/python-darwin-stdlib.exclude $python_apple_support_root/install/macOS/macosx/python-*/Python.framework/Versions/Current/lib/python$python_version_short/* $stdlib_dir
 
-# compile stdlib
+# compile stdlib with an isolated interpreter, without importing from target stdlib dir.
+"$python_bin" -I -m compileall -b "$stdlib_dir"
 cd $stdlib_dir
-python -m compileall -b .
 find . \( -name '*.py' -or -name '*.typed' \) -type f -delete
 rm -rf __pycache__
 rm -rf **/__pycache__