跳到正文
本页内容

框架发布

通过 CI 发布版本一致的 crates、npm 包、CLI 二进制与 GitHub Release。

Vesty 使用 tag 驱动发布。一个 release tag 必须把框架 SDK 与 CLI 作为一组兼容产物发布；只有 CLI 二进制、没有对应 Rust 与 npm 依赖的发布是不完整的。

当前分发状态

目前框架通过源码仓库提供，框架 crates、vesty-plugin-ui npm 包和预编译 CLI GitHub Release 均尚未发布。可用的本地路径流程见快速开始。

正式分发包含三个版本一致的渠道：

渠道提供内容发布后的用户流程
GitHub Releases各平台 CLI 压缩包、校验和与来源证明安装 CLI，再执行 vesty templates / vesty new
crates.io同版本框架 crates 与 vesty-cli生成项目固定精确版本；也可 cargo install vesty-cli --locked
npm带框架适配器的 vesty-plugin-ui在生成的 ui/ 目录安装依赖

用户完成插件后，应分发各平台的 .vst3 包，不需要把插件工程发布到 crates.io。首个版本发布后，再把快速开始切换到发布版安装流程、移除本地路径覆盖，并使用公共 registry 实测无界面和带 UI 的完整上手流程。

下方是维护者发布操作流程，不表示这些产物已经存在。

配置仓库环境

第一次 crates.io 与 npm 发布需要手动完成。两个 registry 都要求包已经存在，owner 才能添加 trusted publisher。包建立后，在 GitHub 中创建两个不保存 registry secret 的受保护环境：

  • crates-io 保护 publish-crates job。为每个 Vesty crate 添加 GitHub trusted publisher：repository owner 填 backrunner，repository name 填 vesty，workflow filename 填 release.yml，environment 填 crates-io。
  • npm 保护 publish-npm job。为 vesty-plugin-ui 添加 GitHub Actions trusted publisher：repository owner 填 backrunner，repository name 填 vesty，workflow filename 填 release.yml，environment 填 npm。

两个环境都应启用 reviewer approval。workflow 会申请 GitHub OIDC identity token，并换取短期 registry 凭据，不读取 crates.io 或 npm 发布 secret。

配置 publisher 前，GitHub 仓库必须已经存在于 backrunner/vesty。如果最终 repository owner 发生变化，应同步修改文档，并在 14 条 publisher 记录中使用准确 owner。

准备版本

[workspace.package].version、所有 Vesty crate 和 packages/plugin-ui/package.json 必须使用同一个 SemVer。

例如，alpha 版本可以使用 v0.1.0-alpha.1，稳定版使用 v0.1.0。release tag 不要携带 build metadata。

创建 tag 前运行：

Bash
node scripts/release/verify-version.mjs v0.1.0-alpha.1cargo test --workspacecargo clippy --workspace --all-targets -- -D warningsnpm testcargo run -p vesty-cli -- publish-plan --out target/publish-plan.jsoncargo run -p vesty-cli -- crate-package --out target/crate-package.jsoncargo run -p vesty-cli -- npm-pack --out target/npm-pack.json

最终稳定版仍必须满足发布证据中列出的真实 DAW、平台 WebView、validator、签名和 notarization 要求。

通过 CI 发布

版本提交进入 main 后，创建并推送 annotated tag：

Bash
git tag -a v0.1.0-alpha.1 -m "Vesty v0.1.0-alpha.1"git push origin v0.1.0-alpha.1

release workflow 会依次完成：

  1. 验证所有 Rust 与 npm 包版本都与 tag 一致。
  2. 生成并检查 publish-plan、crate-package 与 npm-pack 证据。
  3. 构建 Linux x64、macOS universal 与 Windows x64 CLI 压缩包。
  4. 按依赖顺序发布 13 个 crate，并等待每个版本进入 crates.io 索引。
  5. 发布 vesty-plugin-ui，其中包含 React、Vue 与 Svelte 子路径 adapter。
  6. 使用各平台发布二进制创建 Rust 工程，并额外构建一个 React 模板工程。
  7. 生成 SHA256SUMS、构建来源证明和 GitHub Release。

registry 版本不可修改，也不能回滚。如果部分包发布后 workflow 失败，请修复问题并重新运行同一个 tag workflow。发布脚本会跳过 registry 中已有的版本，从第一个缺失包继续。只有全部冒烟测试通过后才会创建 GitHub Release。

预发布版本使用 SemVer channel 作为 npm dist-tag，例如 alpha、beta 或 rc；稳定版使用 latest。

验证发布结果

从完成的 workflow 或 GitHub Release 下载压缩包，使用 SHA256SUMS 校验后运行：

Bash
vesty --versionvesty templatesvesty new release-smoke --template gaincargo check --manifest-path release-smoke/Cargo.toml

测试预发布版本安装脚本时，显式传入 tag：

Bash
curl --proto '=https' --tlsv1.2 -LsSf \  https://raw.githubusercontent.com/backrunner/vesty/main/scripts/install.sh \  | VESTY_VERSION=v0.1.0-alpha.1 sh