03-Python使用BeeWare打包EXE

官方教程在此处让我们开始吧！ - BeeWare Tutorial

0-准备工作

创建虚拟环境，创建Python虚拟环境的命令是：

conda create -n your_env_name   # your_env_name 为你虚拟环境名

然后激活这个环境

conda activate BeeWare

01-第一个应用程序

安装第三方库briefcase

pip install briefcase

创建默认模板

briefcase new

下面的设置先全部默认

打开的路径中生成了文件夹

文件结构如下

beeware-tutorial/
├── beeware-venv/
│   └── ...
└── helloworld/
    ├── CHANGELOG
    ├── LICENSE
    ├── pyproject.toml
    ├── README.rst
    ├── src/
    │   └── helloworld/
    │       ├── app.py
    │       ├── __init__.py
    │       ├── __main__.py
    │       └── resources/
    │           └── README
    └── tests/
        ├── helloworld.py
        ├── __init__.py
        └── test_app.py

移动到 helloworld 项目目录，告诉 Briefcase 以开发者（或 dev）模式启动项目：

cd helloworld

briefcase dev

弹出默认界面

02-打包

在 helloworld 目录中，运行:

briefcase create

报错

Unable to download support package; is your computer offline?

The reported cause of the problem was The read operation timed out

按照官网教程教程 3 - 打包与分发 - BeeWare Tutorial打包时，执行briefcase create时

briefcase create

会出现网络错误

02-01-联网超时问题解决

参考04-使用BeeWare打包下载嵌入版Python的解决方法

解决方法通过手动下载并指定路径，可以避免去官网线上下载导致超时

02-01-1-下载缺少的包

直接按住Ctrl点击对应链接

完成下载

02-01-2-移动到指定路径

将该文件移动到一个想要的路径上，并复制路径

C:\Users\PatTi\Desktop\BeeWare

02-01-3-修改pyproject.toml文件

打开项目的文件夹，找到其中的pyproject.toml文件

打开这个文件

按下Ctrl+F，输入tool.briefcase.app.helloworld.windows搜索

tool.briefcase.app.helloworld.windows

在其下方四行添加刚刚记下的路径加文件名

# 手动指定本地 support package，避免联网下载
support_package = "C:/Users/PatTi/Desktop/BeeWare/python-3.12.9-embed-amd64.zip"

注意要把斜杠改为反斜杠

保存

02-01-4-再次运行

再次执行briefcase create

briefcase create

成功识别并跳过下载

成功

02-02-构建应用程序

输入

briefcase build

出现错误

02-03-解决打包无法下载RCEdit的问题

02-03-1-下载RCEdit

打开浏览器，访问 RCEdit 的 GitHub 发布页： https://github.com/electron/rcedit/releases

下载与你的系统对应的版本（通常是 rcedit-x64.exe）

02-03-2-移动RCEdit

将下载好的rcedit-x64.exe文件放入以下路径：

C:\Users\<你的用户名>\AppData\Local\BeeWare\briefcase\Cache\tools\

如果该路径不存在，手动创建。

02-03-3-重新运行

重新运行：

briefcase build

成功

02-04-打包文件

[helloworld] Built build\helloworld\windows\app\src\Hello World.exe

上述就是输出的exe文件

打开对应目录

EXE文件能够运行

或使用

briefcase run

03-创建安装程序

使用 package 命令打包应用程序，以便发布。打包命令会执行将脚手架项目转换为最终可发布产品所需的编译工作。根据平台的不同，这可能涉及编译安装程序、执行代码签名或执行其他发布前任务。

输入

briefcase package

出现问题，无法下载WiX

03-1-下载WiX

打开浏览器，访问WiX的 GitHub 发布页：Releases · wixtoolset/wix

下载与你的系统对应的版本（如wix-cli-x64.msi）

03-2-移动WiX

将下载好的文件放入以下路径：

C:\Users\<你的用户名>\AppData\Local\BeeWare\briefcase\Cache\tools\

如果该路径不存在，手动创建。

03-3-重新运行

重新运行：

briefcase package

成功