Buildozer构建KivyMD项目APK时PyAudio编译错误求助

问题根源 #

bits/libc-header-start.h 找不到是因为Android NDK API级别过低，或者PyAudio构建时未正确关联PortAudio依赖。PyAudio必须依赖PortAudio库，而默认Buildozer配置未处理好这个跨平台编译的环境问题。

解决步骤 #

1. 调整Buildozer配置（buildozer.spec） #

• 升级NDK API级别：找到或添加以下配置，确保API版本不低于24

  android.ndk_api = 24
  

  高版本NDK包含完整的libc头文件，可直接解决缺失问题。

• 修正依赖顺序：把requirements里的PyAudio和PortAudio一起声明，让Buildozer优先编译PortAudio

  requirements = python3,kivymd,portaudio,pyaudio
  

• 添加库打包配置：确保PortAudio的编译产物能被正确打包进APK

  android.add_libs_armeabi_v7a = portaudio
  

2. 自定义PyAudio配方（若上述步骤无效） #

如果默认的PyAudio配方适配有问题，可手动编写自定义配方：

• 在项目根目录创建recipes/pyaudio文件夹，新建__init__.py文件，内容如下：

  from pythonforandroid.recipe import PythonRecipe
  
  class PyAudioRecipe(PythonRecipe):
      version = '0.2.13'
      url = 'https://files.pythonhosted.org/packages/source/P/PyAudio/PyAudio-{version}.tar.gz'
      depends = ['portaudio', 'python3']
      call_hostpython_via_targetpython = False
  
  recipe = PyAudioRecipe()
  

• 在buildozer.spec中指定自定义配方路径：

  recipes_dir = recipes
  

3. 预处理Colab环境 #

在Colab中先安装PortAudio开发包，为交叉编译搭建基础环境：

!sudo apt-get update && sudo apt-get install -y portaudio19-dev

4. 重新执行构建命令 #

!buildozer -v android debug

验证方法 #

构建完成后，检查APK的lib/armeabi-v7a目录下是否存在libportaudio.so和lib_pyaudio.so文件，确认依赖已被正确打包。

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