如何在Kotlin/Java开发的Android应用中嵌入Python运行环境

1. Android 适配 Python 二进制获取方式 #

不需要自行搜索零散的第三方二进制包，直接用成熟的工业级方案即可：

• 优先选择 Chaquopy 插件：这是专门为Android平台设计的Python集成工具，内置3.8~3.12全版本Python，原生支持arm64-v8a、armeabi-v7a、x86等全架构，无需手动处理二进制适配，在Gradle中完成配置后会自动打包对应架构的Python运行环境到APK中。
• 如果需要手动定制二进制，可以提取Termux官方维护的预编译arm64架构Python包，当前最新版本已经到3.12，提取二进制和关联动态库后放入assets目录即可，需要注意修改Python的默认路径指向Android应用的私有沙箱目录。

2. Windows 开发环境下的依赖管理方案 #

WSL2完全可以解决你的跨平台依赖问题，不建议直接转换Windows本地的虚拟环境，二进制兼容问题极多，推荐流程如下：

• 开启WSL2安装Ubuntu发行版，安装Android NDK交叉编译工具链，创建对应Python版本的虚拟环境。
• 把Windows本地虚拟环境导出的requirements.txt放到WSL环境中，如果是纯Python依赖直接安装即可；如果是带C扩展的依赖（比如numpy、pandas等），如果用Chaquopy可以直接在Gradle依赖中按pip "依赖名==版本号"格式声明，Chaquopy会自动拉取预编译好的Android架构版本，不需要自行交叉编译。

3. 集成流程简化 #

如果你用Chaquopy，完全不需要自己开发assets文件复制、运行时初始化的逻辑，插件会自动处理所有Python运行环境的部署，Kotlin侧调用仅需几行代码：

// 初始化Python实例
val python = Python.getInstance()
// 调用指定脚本的目标方法
val execResult = python.getModule("test_script").callAttr("calc", param1, param2)

注意：Python代码执行要放在子线程运行，避免阻塞Android主线程导致ANR。

4. 可参考的开源实现 #

目前大量离线OCR应用、本地机器学习推理应用、离线数据计算类Android应用都采用Chaquopy方案集成Python，你可以直接搜索带有Chaquopy标签的Android开源项目，就能找到大量可直接复用的实现逻辑。

内容的提问来源于stack exchange，提问作者Ben