使用Briefcase(BeeWare)和PyQt5打包应用失败求助

核心原因 #

Briefcase在run阶段使用的是它自身构建的隔离环境，而非你手动创建的.venv虚拟环境——即使你的venv里装了PyQt5，也需要确保依赖被正确同步到Briefcase的专属环境中。

解决方案1：确认依赖配置正确 #

检查项目根目录的pyproject.toml文件，确保PyQt5已添加到应用的依赖列表：

[tool.briefcase.app.<你的应用名称>]
...
dependencies = [
    "PyQt5>=5.15.0",  # 替换为你实际使用的版本
    # 其他项目依赖
]

如果使用requirements.txt管理依赖，也要确保文件中包含PyQt5。修改配置后重新执行：

briefcase create --update
briefcase build
briefcase run

解决方案2：清理Briefcase缓存环境 #

Briefcase可能缓存了旧的依赖环境，删除后重新构建：

# 删除Briefcase生成的macOS应用环境
rm -rf .briefcase/macos/app
# 重新创建并构建应用
briefcase create
briefcase build
briefcase run

解决方案3：手动向Briefcase环境安装PyQt5 #

如果上述方法无效，直接进入Briefcase的虚拟环境安装依赖：

# 激活Briefcase的macOS应用环境
source .briefcase/macos/app/venv/bin/activate
# 安装PyQt5
pip install PyQt5
# 退出环境
deactivate
# 再次运行应用
briefcase run

额外检查 #

执行所有Briefcase命令前，确保你手动创建的.venv已激活：

source .venv/bin/activate

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