跳转至

二进制构建器(Binary builder)


该构建器使用 PyApp 来构建一个能够在运行时自我引导(bootstrap)的应用程序。

Note

这需要安装 Rust

配置

该构建器插件的名称为 binary

[tool.hatch.build.targets.binary]
[build.targets.binary]

选项(Options)

选项 默认值 描述
scripts 所有已定义项 要限制构建范围的 脚本 名称数组
python-version 最新兼容的 Python 次版本 要使用的 Python 版本 ID
pyapp-version 要使用的 PyApp 版本

构建行为(Build behavior)

如果定义了任何 脚本,则每个脚本都会被构建(受 scripts 选项限制)。否则,将根据项目名称构建一个可执行文件,前提是存在一个同名模块并包含 __main__.py 文件。

所有可执行文件都会被构建到 输出目录 下的 app 子目录中。

如果设置了 CARGO 环境变量,则构建过程将使用其指定的路径作为可执行程序。

如果设置了 CARGO_BUILD_TARGET 环境变量,其值将追加到文件名的主干部分。

如果设置了 PYAPP_REPO 环境变量,则构建过程将在该目录中本地执行,而不是从 crates.io 安装。请注意,如果 CARGO 环境变量指向的是 cross,那么这是必需的