Buckle

Buckle 是 Buck2 的启动器。它按项目基础管理 Buck2。这使得项目或团队能够无缝升级他们的构建系统工具。

它被设计成最小侵入性。Buckle 只管理获取 Buck2 并确保预览同步升级。

安装

安装 buckle 二进制文件有多种方法。

预构建

在 GitHub (https://github.com/benbrittain/buckle/releases) 上提供了适用于 Linux、Windows 和 MacOS 的预构建版本。

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/benbrittain/buckle/releases/download/v0.2.0/buckle-installer.sh | sh

从源代码构建

cargo install buckle

如何使用

调用 buck2

Buckle 最基本的功能是调用 buck2 二进制文件。用法如下

buckle build //...

默认情况下，上述所有安装方法都将二进制文件安装为 buckle。您也可以将别名添加到您的 shell 中

alias buck2='buckle'

这可以防止您意外使用错误的 Buck2 版本。

指定 Buck2 版本

一个 .buckversion 文件允许您为所有下游用户固定 Buck2 安装。将其放在 Buck2 项目的根目录中。

latest 或 YYYY-MM-DD 格式的发布日期。请参阅 buck2 发布

示例 .buckversion

2023-07-15

buckle 支持一个环境变量，可以覆盖 .buckversion 文件。

USE_BUCK2_VERSION=latest buckle //...

预览检查

升级后，buck2 可能不再与标准预览同步。在这种情况下，Buckle 将通知预期的预览以及如何升级。

存在合理的场景，有人在积极构建系统上工作，可能会在标准的 buck2 预览上携带补丁。要禁用 Buckle 不匹配警告

export BUCKLE_PRELUDE_CHECK=NO

更改安装目录

扣子将 buck2 二进制文件存储在不同的位置，这取决于操作系统。

Linux: $XDG_CACHE_HOME/buckle 或 $HOME/.cache/buckle

MacOS: $HOME/Library/Caches/buckle

Windows %LocalAppData%/buckle

您也可以使用环境变量 BUCKLE_CACHE 来指定覆盖。

export BUCKLE_CACHE=/tmp