Skip to content

变更记录 ​

只记录会影响生成项目或升级方式的变更;逐条实现细节看 git log。 框架自己的版本号唯一来源是 package.json,生成项目里对应 app.config.json 的 frameworkVersion。

v0.3.0(2026-11-17) ​

本版只动框架自身的工具链与文档,生成的项目无需改代码。

新增 ​

  • 文档站:docs/ 用 VitePress 渲染,内容就是仓库里的 Markdown,不再另存一份。 pnpm docs:dev 本地预览、docs:build 出静态文件、docs:deploy 直传 Cloudflare Pages (AtomGit 没有 Pages,但 Pages 只认静态文件,不用把仓库搬走)。
  • CHANGELOG 门禁:发版要求目标版本在 CHANGELOG.md 有段落且不是自动草稿; 缺失时按 git log 生成分组草稿后退出,逼着人整理一遍再发。
  • docs/changelog.md 由根 CHANGELOG.md 单向同步,pnpm docs:check 与发版都会拦截漂移。
  • CI 补 shell 语法(bash -n)、版本一致性(release --check)、文档站构建与同步检查。

修复 ​

  • 生成项目的 wifi-web/ 前端包此前不在 workspace 里,pnpm -r typecheck/build 根本不检查它们; 现已纳入,Vue 版包名改为 <slug>-wifi-web-vue,避免与 React 版重名。

升级 ​

无破坏性变更,照常替换框架副本即可:

bash
node scripts/update-core.mjs --ref v0.3.0
pnpm install

v0.2.0(2026-11-17) ​

破坏性变更:项目结构 ​

core/ 与 build/ 合并为 framework/,build/ 里的项目配置移到项目根 config/。 框架代码与项目资产彻底分开:升级框架只替换 framework/,不再碰版本、签名、商店配置。

旧位置新位置
core/crates、core/packages、core/README.mdframework/core/*、framework/README.md
build/scripts/framework/build/scripts/
build/env/config/env/
build/version.jsonconfig/version.json
build/stores.json、build/metadata/config/store/
build/config/{android,ios,harmony}/config/signing/{android,ios,harmony}/
build/dist/、build/out/dist/、dist/out/
Rust 依赖 ../core/crates/*../framework/core/crates/*
前端依赖 file:../core/packages/*file:../framework/core/packages/*
  • schemaVersion 升到 3。低于 3 的旧结构直接报错,不做静默回退——不确定读到的是新值还是旧值, 比报错更难排查。旧布局项目请用最新框架重新生成,或按上表手工迁移。
  • package.json 的脚本入口统一改为 framework/build/scripts/*。

新增 ​

  • app.config.json 的 JSON Schema:core 模式生成时装配到 framework/config.schema.json, 并在首行写入 "$schema": "./framework/config.schema.json",编辑器可补全与标红非法字段。 link 模式两者都不带。
  • 生成器金丝雀扩到 5 种组合(默认 / 全关 / 仅 wifi-bridge / 仅 privacy-consent / link 模式), 新增断言:$schema 写入策略、依赖引用完整性(path 与 file: 依赖目标必须存在)、 默认组合跑一次 update-core 再严格校验。
  • CI 补齐:bash -n 全量 shell 语法、release --check 版本一致性、Schema 与配置字段交叉校验。
  • wifi-bridge 的失败有明确契约:所有接口出错返回 { ok:false, error },端口被占是 409, 超出单次上限是 413 + 可读文案;/status 增加 max_upload_bytes。

修复 ​

  • update-core.mjs 写入 lastUpgrade 后,pnpm config:check 会因「未知字段」直接失败(会拦住发版)。
  • update-core.mjs 重建 framework/core/Cargo.toml 时把版本写死成旧值,升级后 workspace 版本不对。
  • release.mjs 发版时漏提交 Cargo.lock,拉下 tag 后第一次 cargo build 就把工作区改脏。
  • 传输页把后端字段 reason 读成 error,上传失败永远只显示「1 个失败」。
  • 同名文件并发上传会互相覆盖(exists() 检查与 create 之间有竞态)。

升级 ​

bash
# core 模式项目:整体替换 framework/,config/ 与业务代码不受影响
node scripts/update-core.mjs --ref v0.2.0
pnpm install
pnpm --dir frontend typecheck
cargo check --manifest-path rust/Cargo.toml

旧布局(配置在 build/)的项目不能直接升级,需用最新框架重新生成。

v0.1.0 ​

首个可用版本:ReactLynx 4.2 + Rust 微内核、三端壳模板、Bridge 路由、设置与存储基座、 dev/prod 双环境打包、上架打包体系(AAB / IPA / App Pack / 上传包)、wifi-bridge 可选能力。

lynx-aura · 跨平台本地应用开发框架