Skip to content

0.2 Alpha:可选安装与边界 ​

0.2 Alpha 发布运行发布了八个 0.2.0-alpha.0 包: @vooya/vite、@vooya/vue、@vooya/react、@vooya/build-core、 @vooya/provider-rust、@vooya/preset、@vooya/rspack、@vooya/webpack。 @vooya/core、@vooya/compiler 保持 0.1.0-beta.0;Solid、Svelte adapter 保持 0.1.0-beta.2,本次没有这两个 adapter 的 Alpha 包。不要强制所有包同版。 Octane 仍是延期的私有实验。

原发布工作流在发布完成后失败;独立 registry 恢复验收及 GitHub 预发布核对已完成。 证据与限制见发布记录。

默认快速开始继续使用 Beta。托管工具链、具名 Vite 8/Vite+ 与 Rust bundler 路径、 SSR 安全客户端岛需要主动选择 Alpha,见包状态。 发布不等于所有框架或 SSR 组合都兼容;源码 fixture 也不等于独立 registry 消费验收。

在已有 Vite 应用中安装 ​

保留快速开始的宿主框架插件和 Rust 示例,按框架选择一个 adapter。

sh
npm install -D @vooya/vite@0.2.0-alpha.0
# Vue
npm install @vooya/vue@0.2.0-alpha.0
# 或 React
npm install @vooya/react@0.2.0-alpha.0
# 可选:固定版本的托管 Rust/WASM 工具
npm install -D @vooya/preset@0.2.0-alpha.0
npx vooya doctor --json
npm run dev
# 检查应用与生成声明后,按 Ctrl+C 停止开发服务器。
npm run build

Solid/Svelte 应用保留 0.1.0-beta.2 adapter,配合 @vooya/vite@0.2.0-alpha.0,不要安装不存在的 adapter Alpha。0.2.0-alpha.0 是 Vooya 插件版本,宿主 bundler 是 Vite 7 或 8。Node 与框架插件版本仍以兼容性矩阵为准。 未安装 preset 时继续准备系统 Rust target 与匹配的 wasm-bindgen CLI;安装 preset 后仍需宿主 SDK/linker。 普通应用不需要直接依赖 provider-rust。

托管 Rust 工具链 ​

Alpha 接入可发现应用或上级项目声明的可选 @vooya/preset 依赖,在隔离缓存中准备 固定版本的 Rust/WASM 工具。它仍在本机编译 Rust,适用平台仍需宿主 linker 和 SDK, 不等于无需 Rust 的组件运行时。

以下配置从 0.2.0-alpha.0 起可用:

配置Alpha 行为
toolchain.mode: "auto"(默认)有声明的 preset 时使用 preset,否则发现系统工具;显式 cargoPath 选择系统工具
toolchain.mode: "system"使用已安装的系统工具,不准备 preset
toolchain.mode: "managed"要求项目存在 preset;与显式 cargoPath 同用时报错
VOOYA_TOOLCHAIN配置 mode 为 auto 时选择工具链模式
vooya doctor --toolchain auto|system|managed诊断同一套 Alpha 选择策略

托管安装失败时,先检查下载或宿主依赖错误,修复后重试;不会静默回退到系统工具。 需要系统工具时应显式选择 system。缓存和平台细节见 preset 源码 README。 已发布 Beta 用户继续使用系统工具链诊断。

源码验收命令为 npm run test:preset-consumer:在独立 Vue 应用中安装七个匹配的 tarball,验证普通 npm run dev、浏览器 Component/Store 交互、Rust 修改、编译错误 恢复及 npm run build。用例屏蔽环境中的 Rust 命令,同时保留宿主 SDK/linker。 CI 在 Linux、macOS、Windows 上使用新的托管缓存执行同一用例;本地复用缓存通过 不代表重新验证了下载流程。

宿主集成 ​

接入能力具名 fixture 证据与限制
Vite 8.2.1Vue/React/Solid/Svelte 打包生产与开发用例、严格声明、Rust 错误恢复、连续保存与宿主文件修改
Vite+ 0.2.9按文档的 alias/overrides 使用正常 npm peer 解析;四框架的打包 dev/build 用例不代表全部工具或版本都兼容
Webpack/Rspack .rsVue/React Component、Store、CSS 与声明;Vue watch 恢复和新增模块检查;其他 watch/框架组合仍未验证
SSR 安全岛Vue 惰性 Store 创建与 React 客户端边界;具名 Nuxt 生产及浏览器用例;Rust 内容仍在浏览器挂载,Next.js 尚未验证

具体用例见兼容性矩阵、实验性配置 和SSR 范围。按上方精确版本图安装。源码 fixture 表示具名覆盖,不代表任意后续 main 提交都已发布。

Octane 延后 ​

Octane adapter 保留为私有 workspace 实验和独立打包浏览器用例,不纳入本轮 0.2 Alpha 发布或公共发布门禁。目前没有可安装的 @vooya/octane 发布版本;后续转为 公开包需重新审查范围、提供首发 Changeset 并完成 registry 验收,不预先承诺日期。

Rust provider 抽离 ​

PR #148 将 Rust 构建实现拆到 @vooya/provider-rust,已通过 PR #149 合入 main;@vooya/build-core 保持兼容入口。该实现保留导出函数、 类型身份和构建产物,不新增公共多语言 provider 注册机制或产物协议。新包与这项 抽离均不属于已发布的 0.1 Beta。

复现源码证据 ​

仓库具名测试从已审查 checkout 构建匹配 tarball。报告时记录提交与命令;后续 main 可能包含 alpha.0 尚无的改动。应用安装应使用上面的精确 registry 版本。 发布与官网部署是独立步骤,文档合并本身不表示线上页面已经更新。

Vooya is a beta project. Check the compatibility matrix before relying on a path.