Skip to content

目录结构迁移检查清单(framework/ + config/) ​

依据 architecture.md §10.1 的规范。按顺序执行,每步都能独立验证。 目标:core/ + build/ → framework/,build/ 里的项目配置 → 根 config/。

0. 前置 ​

  • [x] main 与 origin/main 同步,工作区干净
  • [x] 基线通过:node scripts/generate-check.mjs
  • [x] 记录当前生成项目结构(迁移后用来对照)

1. 框架仓库内重组 ​

  • [x] 新建根 build/,迁入 templates/app/build/(P1-6 已完成)
  • [x] 新建 templates/config/,承接生成项目用的默认配置: env/{dev,prod}.json、version.json、store/{stores,listing,icon}.json、signing/*.example
  • [x] templates/wifi-web/ → features/wifi-bridge/web/{react,vue}/(P0-2 已完成)
  • [x] templates/app/ 只保留 frontend/、rust/、docs/ 与骨架文件(P1-6 已完成)
  • [x] 删除空的 templates/app/build/,确认没有残留引用(P1-6 已完成)

2. 脚本路径适配 ​

  • [x] templates/app/package.json 中 build/scripts/* → framework/build/scripts/*
  • [x] build/scripts/*.mjs 的 ROOT 再向上一层(dirname/../../..)
  • [x] 所有配置读取走 config.mjs 的 resolveProjectPaths(),禁止硬编码 build/env/...
  • [x] config.mjs 路径解析全部指向 config/,schemaVersion 升到 3(无旧项目,不留回退)
  • [x] scripts/update-core.mjs:替换范围从 core/ 扩到 framework/,不触碰 config/、platforms/

3. 生成器装配 ​

  • [x] create.mjs 组装 framework/{core,build}(core ← crates/ + packages/;build ← 根 build/)
  • [x] 项目配置写入根 config/(installProjectConfig():templates/config/ → config/)
  • [x] Rust 依赖路径:../core/crates → ../framework/core/crates
  • [x] 前端 @aura/*:file:../core/packages/* → file:../framework/core/packages/*
  • [x] 三端壳内的路径(keystore / signingConfigs / 图标 / privacy)同步到 config/
  • [x] core 模式写 app.config.json 的 $schema(./framework/config.schema.json),link 模式不写
  • [x] generate-check.mjs:新增 framework/、config/、旧路径不存在的断言(并补 link 模式组合)

4. 验证 ​

  • [x] node --check 覆盖 scripts/*.mjs、build/scripts/*.mjs;bash -n 覆盖全部 shell
  • [x] node scripts/generate-check.mjs 通过(5 种组合:4 feature 组合 + link 模式)
  • [x] 生成项目里 sync-config --check、load-env、doctor、preflight --no-artifacts 均正常
  • [x] 三端 DRY_RUN=1 build-*.sh 计划输出正确,产物落到 dist/
  • [x] 无旧布局项目,build/ 旧路径回退与旧 config 结构兼容分支已删除
  • [x] update-core.mjs --local 可整体替换 framework/

5. 文档同步 ​

  • [x] docs/architecture.md §8 的项目树、§10 的配置清单改为新结构;§10.1 标为已实施
  • [x] docs/quickstart.md、templates/app/README.md、build/README.md 路径更新
  • [x] 根 README.md 删除「待实施」标记
  • [x] docs/extraction-map.md 标记为历史文档(内容已部分过时)

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