将 Flet 应用编译并打包为独立的静态 Web 应用。

详细使用指南：https://flet.dev/docs/publish/web/static-website。

用法

flet publish [-h] [-v] [--pre] [--python-version PYTHON_VERSION]
                          [-a ASSETS_DIR] [--distpath DISTPATH]
                          [--app-name APP_NAME]
                          [--app-short-name APP_SHORT_NAME]
                          [--app-description APP_DESCRIPTION]
                          [--base-url BASE_URL]
                          [--web-renderer {auto,canvaskit,skwasm}]
                          [--route-url-strategy {path,hash}]
                          [--pwa-background-color PWA_BACKGROUND_COLOR]
                          [--pwa-theme-color PWA_THEME_COLOR] [--no-cdn]
                          [script]

位置参数

script

启动 Flet 应用的 Python 脚本路径。

默认值： .

选项

--app-description

应用的简短描述。用于 PWA 清单和元数据。

--app-name

应用的全名。用于 PWA 元数据，可能会出现在安装提示中。

--app-short-name

应用名称的较短版本，常用于主屏幕图标或安装提示中。

--assets

存放应用所用静态资源（例如图片、字体、图标）的目录路径。

环境变量： FLET_ASSETS_DIR

别名： -a

--base-url

应用提供服务的基础 URL 路径。如果应用托管在子目录中会很有用。

--distpath

发布后的 Web 应用所放置的目录。

默认值： dist

--help

显示此帮助信息并退出。

别名： -h

--no-cdn

禁止从 CDN 加载 CanvasKit、Pyodide 和字体。用于完全离线部署或隔离网络环境。

环境变量： FLET_WEB_NO_CDN

--pre

允许 micropip 安装预发布的 Python 包。如果你的应用依赖某个包的预发布版本，可使用此项。与 --python-version 无关（此标志针对的是 micropip 包，而非 Python 解释器本身）。

--pwa-background-color

Web 应用在加载阶段的初始背景色（用于启动画面）。

--pwa-theme-color

当应用作为 PWA 安装后，浏览器 UI（例如地址栏）的默认颜色。

--python-version

要打包的 Python 版本（例如 3.13）。默认为支持的最新版本，或从 project.requires-python 中解析。

--route-url-strategy

控制浏览器中路由的处理方式（默认：path）。

可选值： hash, path

环境变量： FLET_WEB_ROUTE_URL_STRATEGY

--verbose

启用详细输出。使用 -v 输出标准详细日志，使用 -vv 输出更详细的信息。

别名： -v

--web-renderer

要使用的 Flutter Web 渲染器，默认：canvaskit。

可选值： auto, canvaskit, skwasm

环境变量： FLET_WEB_RENDERER