主题
使用 PyInstaller 将 Flet 应用打包为独立的桌面可执行文件或应用包。
详细使用指南:https://flet.dev/docs/publish/using-pyinstaller。
用法
bash
flet pack [-h] [-v] [-i ICON] [-n NAME] [-D]
[--distpath DISTPATH] [--add-data [ADD_DATA ...]]
[--add-binary [ADD_BINARY ...]]
[--hidden-import [HIDDEN_IMPORT ...]]
[--product-name PRODUCT_NAME]
[--file-description FILE_DESCRIPTION]
[--product-version PRODUCT_VERSION]
[--file-version FILE_VERSION]
[--company-name COMPANY_NAME] [--copyright COPYRIGHT]
[--codesign-identity CODESIGN_IDENTITY]
[--bundle-id BUNDLE_ID] [--debug-console DEBUG_CONSOLE]
[--uac-admin]
[--pyinstaller-build-args [PYINSTALLER_BUILD_ARGS ...]]
[-y]
script位置参数
script
启动 Flet 应用的 Python 脚本路径。
必填: true
选项
--add-binary
要添加到可执行文件中的额外二进制文件。格式:source:destination[:platform]。
取值: ADD_BINARY*
--add-data
向包中添加额外的非二进制文件或文件夹。接受一个或多个 source:destination 形式的参数。
取值: ADD_DATA*
--bundle-id
应用的 bundle 标识符。用于 macOS 应用打包,在 Linux 上则作为应用的任务栏身份——请让它与桌面条目的 StartupWMClass 键保持一致。在 Linux 上默认使用可执行文件的名称。
--codesign-identity
用于对应用包进行代码签名的签名身份(仅 macOS)。
--company-name
Windows 可执行文件的公司名称元数据。
--copyright
嵌入可执行文件(Windows)或应用包(macOS)中的版权字符串。
--debug-console
显示 Python 调试控制台窗口(请确保 DEBUG 级别正确)。用于排查运行时错误。
--distpath
打包后的应用所放置的目录。
默认值: dist
--file-description
要嵌入可执行文件的文件描述(Windows)。
--file-version
可执行文件的文件版本,格式为 n.n.n.n(仅 Windows)。
--help
显示此帮助信息并退出。
别名: -h
--hidden-import
添加那些通过动态导入、无法被静态分析检测到的 Python 模块。
取值: HIDDEN_IMPORT*
--icon
可执行文件或应用包所用图标文件的路径。支持的格式:.ico(Windows)、.icns(macOS)和 .png(Linux,在 Linux 上它会与生成的桌面条目放在一起,而不是嵌入可执行文件)。
别名: -i
--name
生成的可执行文件(Windows)或应用包(macOS)的名称。
别名: -n
--onedir
创建单文件夹形式的包,而不是单文件可执行文件(仅 Windows)。
别名: -D
--product-name
要嵌入可执行文件(Windows)或应用包(macOS)的产品名称。
--product-version
可执行文件(Windows)或应用包(macOS)的产品版本。
--pyinstaller-build-args
传递给底层 pyinstaller build 命令的额外原始参数。
取值: PYINSTALLER_BUILD_ARGS*
--uac-admin
在应用启动时请求提升(管理员)权限(仅 Windows)。会向可执行文件添加 UAC 清单。
--verbose
启用详细输出。使用 -v 输出标准详细日志,使用 -vv 输出更详细的信息。
别名: -v
--yes
启用非交互模式。所有提示都会被跳过。
别名: -y