iOS模拟器中Kivy应用NumPy导入及Foundation dlopen错误排查

问题描述 #

Kivy应用在Android平台运行正常，但移植到iOS模拟器启动时崩溃，核心报错为NumPy的C扩展导入失败，具体错误如下：

ImportError: cannot import name '_ArrayFunctionDispatcher' from 'numpy.core._multiarray_umath'

同时日志附带提示：

Error importing numpy: you should not try to import numpy from its source directory; please exit the numpy source tree, and relaunch your python interpreter from there.

环境信息：

• 本地Python版本：3.12.1
• NumPy版本：1.26.3
• 操作系统：macOS Monterey 12.7.2
• 打包方式：使用Kivy官方toolchain，遵循iOS打包流程

核心问题分析 #

• Python版本不匹配：日志显示iOS模拟器中运行的Python是3.10.10，但本地开发环境使用3.12.1。Kivy iOS toolchain默认的Python版本与本地环境不一致，导致依赖库编译时的版本兼容性问题。
• NumPy适配问题：NumPy的C扩展需要针对iOS模拟器平台重新编译，直接使用本地pip安装的NumPy无法适配iOS环境，且1.26.3版本与Python 3.10存在兼容性冲突。

解决步骤 #

1. 统一Python版本 #

使用版本管理工具将本地Python切换为与iOS模拟器一致的3.10.10：

# 安装Python 3.10.10（若未安装）
pyenv install 3.10.10
# 切换当前目录到该版本
pyenv local 3.10.10

2. 重新编译适配iOS的NumPy #

清理旧缓存并通过toolchain编译兼容的NumPy版本（推荐1.24.x，对Python 3.10支持更稳定）：

cd kivy-ios
# 清理之前的NumPy构建缓存
./toolchain clean numpy
# 编译指定版本的NumPy
./toolchain build numpy==1.24.3

3. 重新打包应用 #

• 清理Xcode旧构建产物：

  xcodebuild clean -project myapp.xcodeproj
  

• 重新生成iOS项目并打包：

  ./toolchain create myapp /path/to/your/application
  cd myapp-ios
  open myapp.xcodeproj
  

• 在Xcode中选择iOS模拟器，重新构建运行。

4. 额外检查 #

• 确保项目requirements.txt中指定的NumPy版本与toolchain编译的版本一致
• 排查代码中是否存在从NumPy源码目录直接导入的情况，确保导入路径正确

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