Kivy应用Android打包与pyjnius编译错误分析
kivy是一个强大的python框架，用于快速开发多平台应用程序。当需要将kivy应用部署到android设备时，buildozer是常用的打包工具。然而，在打包过程中，开发者可能会遇到各种编译错误，其中pyjnius模块的编译失败是常见问题之一，尤其表现为c语言层面的expression is not assignable错误。
错误现象与日志解读
典型的pyjnius编译错误日志如下所示，主要特征是clang编译器在编译jnius/jnius.c文件时报告多个error: expression is not assignable错误，特别是针对++Py_REFCNT(o);和--Py_REFCNT(o);这样的语句。
[DEBUG]: /home/abr/.buildozer/android/platform/android-ndk-r25b/toolchains/llvm/prebuilt/linux-x86_64/bin/clang -target aarch64-linux-android21 ... -c jnius/jnius.c -o build/temp.linux-x86_64-3.10/jnius/jnius.o [DEBUG]: jnius/jnius.c:54433:5: error: expression is not assignable [DEBUG]: ++Py_REFCNT(o); [DEBUG]: ^ ~~~~~~~~~~~~ [DEBUG]: jnius/jnius.c:54435:5: error: expression is not assignable [DEBUG]: --Py_REFCNT(o); [DEBUG]: ^ ~~~~~~~~~~~~ ... (多个类似的错误) [DEBUG]: 3 warnings and 12 errors generated. [DEBUG]: error: command '/home/abr/.buildozer/android/platform/android-ndk-r25b/toolchains/llvm/prebuilt/linux-x86_64/bin/clang' failed with exit code 1
这个错误表明clang编译器在尝试修改Py_REFCNT(o)时失败，因为它被视为一个不可赋值的表达式。Py_REFCNT是Python C API中的一个宏，用于访问或修改Python对象的引用计数。这个错误通常发生在以下几种情况：
- Python C API版本不兼容：pyjnius生成的C代码（jnius.c）可能与Buildozer内部使用的Python版本或NDK提供的Python头文件之间存在C API定义上的不匹配。例如，某个Python版本可能将Py_REFCNT定义为一个函数调用或一个只读的宏，而不是一个可直接赋值的左值。
- NDK或编译器版本问题：Android NDK包含了一套交叉编译工具链（如clang）。不同的NDK版本可能对C语言标准或特定宏的解析方式有所不同，导致编译失败。
- Buildozer环境污染：之前的失败构建尝试可能遗留了不完整的或损坏的中间文件，干扰了后续的编译过程。
此外，日志中还提到了一个初始的clang-14: error: no such file or directory: 'jnius/jnius.c'错误，这通常是pyjnius第一次尝试编译前的预期行为，因为jnius.c文件需要通过Cython从jnius.pyx生成。真正的编译失败发生在Cython处理之后，即jnius.c文件已生成但编译时出错。
解决方案与步骤
针对上述问题，可以采取以下专业解决方案：
1. 检查并修正Buildozer命令拼写
首先，确保您输入的Buildozer命令是正确的。原始问题中提到了biuldozer -v android debug，这显然是一个拼写错误。正确的命令应该是：
buildozer -v android debug
即使是小的拼写错误也可能导致命令无法识别，从而引发后续的构建问题。
2. 审查buildozer.spec文件中的requirements
buildozer.spec文件是Buildozer配置的核心，其中的requirements字段指定了您的Kivy应用及其依赖在Android环境下的Python包。pyjnius是Kivy应用与Java层交互的关键桥梁，它的正确构建至关重要。
确保buildozer.spec文件中明确包含了所有必要的依赖，特别是python3和kivy，以及任何您应用直接或间接依赖的库。虽然pyjnius通常是kivy的内部依赖，但明确列出可能有助于Buildozer更好地管理其构建过程。
示例 buildozer.spec 片段：
[app] # (推荐) Python版本和主要框架/库 requirements = python3==3.9.12,kivy==2.1.0,hostpython3==3.9.12 # 如果您的应用依赖其他库，也请在此处添加 # requirements = python3,kivy,pillow,requests,sqlite3 # ... 其他配置
注意事项：
- 版本锁定：建议锁定python3和kivy的版本，以确保构建环境的稳定性。例如，python3==3.9.12,kivy==2.1.0。如果Buildozer默认选择的Python版本与pyjnius或NDK存在兼容性问题，手动指定一个已知稳定的版本可能会有帮助。
- Buildozer自动依赖：Buildozer通常会尝试自动解析和安装依赖，但手动指定可以避免潜在的版本冲突。
3. 执行彻底的Buildozer环境清理
由于编译失败可能由残留的构建文件引起，执行一次彻底的清理操作是解决此类问题的关键步骤。
buildozer android clean
此命令会删除Buildozer在.buildozer目录中生成的所有临时文件、下载的SDK/NDK、编译产物等。清理后，再重新执行打包命令：
buildozer -v android debug
这将强制Buildozer从头开始下载所有必要的组件并重新编译，确保一个干净的构建环境。
4. 更新Buildozer工具
确保您使用的Buildozer版本是最新的。Kivy和Buildozer项目都在不断发展，新版本通常会修复与NDK、Python版本兼容性相关的问题。
pip install --upgrade buildozer
更新后，再次尝试清理并构建。
5. 考虑NDK和Python版本兼容性
Py_REFCNT错误强烈暗示Python C API与编译环境（NDK/clang）之间的兼容性问题。虽然Buildozer通常会自行管理NDK版本，但如果问题持续存在，可以尝试以下高级排查：
- 检查Buildozer使用的NDK版本：在.buildozer/android/platform/目录下可以找到Buildozer下载的NDK。虽然不建议手动修改，但了解其版本有助于诊断。
- 尝试不同的Python版本：在buildozer.spec的requirements中尝试指定不同的小版本Python（例如，从python3==3.8.10尝试python3==3.9.x或python3==3.7.x），看是否有助于解决pyjnius的编译问题。
6. 系统环境依赖检查
确保您的Linux系统安装了Buildozer所需的所有基本构建工具和依赖项。虽然Buildozer通常会提示缺失的依赖，但可以提前检查：
sudo apt update sudo apt install -y git zip unzip openjdk-17-jdk autoconf libtool pkg-config zlib1g-dev libncurses-dev libsdl2-dev libsdl2-image-dev libsdl2-mixer-dev libsdl2-ttf-dev
请注意，openjdk-17-jdk是Android SDK/NDK构建推荐的Java版本，根据您的Buildozer版本和Android API级别要求，可能需要调整。
总结
当Kivy应用在Buildozer打包过程中遇到pyjnius的expression is not assignable编译错误时，首先应检查并纠正buildozer命令的拼写。随后，对buildozer.spec文件中的requirements进行审查和优化，确保所有依赖，特别是python3和kivy，版本兼容且配置正确。最关键的步骤是执行buildozer android clean进行彻底的环境清理，并确保Buildozer工具本身是最新版本。如果问题依然存在，可能需要进一步考虑NDK与Python C API之间的版本兼容性问题。通过系统性的排查和尝试，通常可以解决此类复杂的编译难题，成功将Kivy应用打包为Android APK。
