Windows10下Kivy用Buildozer打包APK提示buildozer命令未识别如何解决

核心原因 #

该报错是系统全局路径未包含buildozer可执行文件的存放目录，和你在Pycharm内的安装场景直接相关： #

修复步骤 #

场景1：你在Pycharm的项目虚拟环境中安装的buildozer #

直接打开Pycharm底部的「终端」面板，在终端中进入项目主文件所在目录，运行buildozer init即可。外部系统命令行没有加载虚拟环境的路径，默认找不到虚拟环境里安装的第三方命令。

场景2：你在全局Python环境中安装的buildozer #

需要手动把Python的Scripts目录添加到系统环境变量：

• 打开你的Python安装目录，找到同级的Scripts文件夹，默认路径格式为C:\Users\你的系统用户名\AppData\Local\Programs\Python\Python<版本号>\Scripts
• 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
• 在「系统变量」列表中找到Path项，点击「编辑」，将上述Scripts文件夹的完整路径添加到列表中
• 保存所有配置后完全重启命令行窗口，再次执行buildozer init即可被系统识别

后续打包注意事项 #

原生buildozer不支持直接在Windows系统运行，即便解决了命令识别问题，后续打包APK的流程依然会触发依赖缺失类报错，推荐采用两种稳定方案完成后续打包：

• 开启Windows的WSL2功能，安装Ubuntu子系统，在子系统环境内安装配置buildozer完成打包
• 使用Python-for-Android官方Docker镜像执行打包操作，无需手动配置环境依赖

内容的提问来源于stack exchange，提问作者Lion In A Box