[已解决]termux中安装kivy时报错怎么解决

金子涵JL

1.       1 error generated. error: command '/data/data/com.termux/files/usr/bin/aarch64-linux-android-clang' failed with exit code 1 [end of output] note: This error originates from a subprocess, and is likely not a problem with pip. ERROR: Failed building wheel for kivy Failed to build kivy error: failed-wheel-build-for-install × Failed to build installable wheels for some pyproject.toml based projects ╰─> kivy

复制代码

        想学习python，但是家里没有电脑。所以一直是使用termux进行学习。这段时间准备用kivy写一个游戏，但是安装时一直报错，应该如何解决？
        环境：安卓系统
                   termux（使用的App）
                   python3.12.12

运行日志

环境

最佳答案

月排行榜 / 总排行榜

不二如是

2026-2-17 11:27:27

鱼油缺 X11 和 OpenGL 的开发库！

所以 X11/X.h 和 GL/gl.h 找不到，Kivy 编译失败。

一步解决（直接复制）：

1. pkg update && pkg upgrade -y
   
2. pkg install x11-repo
   
3. 
   
4. pkg install -y python clang make pkg-config git \
   
5. libffi freetype libjpeg-turbo libpng \
   
6. sdl2 sdl2-image sdl2-mixer sdl2-ttf \
   
7. xorgproto libx11 libxext libxrender libxrandr libxi libxcursor libxfixes \
   
8. mesa libglvnd

复制代码

然后再装 Kivy：

1. pip install -U pip setuptools wheel Cython
   
2. pip install --no-build-isolation --no-binary=:all: kivy

复制代码

跳转到最佳答案楼层

不二如是

鱼油缺 X11 和 OpenGL 的开发库！

所以 X11/X.h 和 GL/gl.h 找不到，Kivy 编译失败。

一步解决（直接复制）：

1. pkg update && pkg upgrade -y
   
2. pkg install x11-repo
   
3. 
   
4. pkg install -y python clang make pkg-config git \
   
5. libffi freetype libjpeg-turbo libpng \
   
6. sdl2 sdl2-image sdl2-mixer sdl2-ttf \
   
7. xorgproto libx11 libxext libxrender libxrandr libxi libxcursor libxfixes \
   
8. mesa libglvnd

复制代码

然后再装 Kivy：

1. pip install -U pip setuptools wheel Cython
   
2. pip install --no-build-isolation --no-binary=:all: kivy

复制代码

FishC

在 Termux 中通过 pip 直接安装 Kivy 通常会因为缺少编译环境或依赖而失败。以下是详细的解决步骤，请按顺序操作：

• 更新 Termux 和包管理器
  首先，确保您的 Termux 环境是最新的。在 Termux 中依次执行：
  
  1. pkg update && pkg upgrade
     
  2. pkg install -y python python-pip rust binutils

  复制代码
  
  
• 安装编译所需的工具和库
  Kivy 的编译依赖许多 C 库，需要先安装它们：
  
  1. pkg install -y make libffi clang python-dev libjpeg-turbo libpng mesa x11-repo freetype2 zlib

  复制代码
  
  注意：如果提示 x11-repo 已存在或更新失败，可以尝试 pkg install x11-repo -y。
• 安装 Kivy 的核心依赖
  安装一些 Python 端的构建和运行依赖：
  
  1. pip install --upgrade pip setuptools wheel cython

  复制代码
  
  
• 设置必要的环境变量（关键步骤）
  编译过程需要知道一些库的位置。在执行安装命令前，设置以下变量：
  
  1. export CFLAGS="-Wno-unused-result -Wsign-compare -DNDEBUG -g -fwrapv -O3 -Wall"
     
  2. export LDFLAGS="-L/data/data/com.termux/files/usr/lib"
     
  3. export CPPFLAGS="-I/data/data/com.termux/files/usr/include"

  复制代码
  
  为了后续方便，您可以将这些行添加到 ~/.bashrc 文件中。
• 尝试安装 Kivy
  现在，尝试使用 pip 安装 Kivy。建议从它的依赖开始，或者指定一个较旧的、可能兼容性更好的版本：
  
  1. pip install kivy==2.3.0

  复制代码
  
  安装过程会花费较长时间（可能超过10分钟），请保持网络连接稳定。
  

如果以上步骤后仍然出现编译错误，请尝试以下备选方案：

• 使用预编译的轮子文件
  这是最推荐的方法。访问 [url=https://github.com/Ghost-chu/termux-packages-python-wheels/releases（请在浏览器中手动输入地址访问，Termux]https://github.com/Ghost-chu/termux-packages-python-wheels/releases（请在浏览器中手动输入地址访问，Termux[/url] 内可能无法直接点击），查找与您的 Python 版本 (3.12) 和架构 (aarch64) 对应的 Kivy 轮子文件（.whl 文件）。
  下载到 Termux 后，使用 pip 安装该文件。例如，假设下载的文件为 kivy-2.3.0-cp312-cp312-android_21_aarch64.whl：
  
  1. pip install /path/to/downloaded/kivy-2.3.0-cp312-cp312-android_21_aarch64.whl

  复制代码
  
  
• 降级 Python 版本
  Python 3.12 可能太新，部分库的适配尚未完成。您可以尝试安装 Python 3.11：
  
  1. pkg install python=3.11.8
     
  2. # 安装后，使用 python3.11 和 pip3.11 命令。然后为新版本重复上述安装步骤。

  复制代码
  
  
• 考虑替代开发方案
  考虑到在 Android 上进行完整的 Kivy 应用开发（尤其是游戏）可能会遇到性能、调试和打包等更多挑战，您可以考虑以下替代方案：
  
  • 使用 Termux 学习 Python 核心语法和写命令行程序。
  • 对于图形界面和游戏学习，可以尝试使用更轻量级的库，如 curses（用于终端图形）。
  • 如果条件允许，利用一些提供在线编程环境的网站（如 Replit）进行 Kivy 的学习和原型开发。
  • 长期来看，攒一台便宜的二手电脑（如树莓派、旧笔记本电脑）是学习应用/游戏开发更理想的选择。
    
  
  

希望这些步骤能帮助您成功安装 Kivy。祝学习顺利！

以上回复来自 FishC AI 小助理，如未能正确解答您的问题，请继续追问。