famiclone

发布

本文说明 VS Code 扩展 fcdev 的打包、检查与发布。登录市场与 vsce publish 由用户执行,不在代码或文档里记录任何凭据。

1. 版本与元数据

2. 打包前提

  1. 所有改动已提交。
  2. 工具链已构建:在 vscode/ 里 npm run build:toolchain,输出到 vscode/toolchain/。
  3. 各目标的运行库已构建:npm run build:libs;SB2000 的生成文档已更新:npm run gen:docs。
  4. npm run check 通过(类型检查、lint、测试、构建、工具测试)。
  5. CHANGELOG.md 里已经写好本版本的更新说明,package.json 的版本已升。

3. 打包

cd vscode
npm run package

npm run package 运行 vsce package --target win32-x64 --allow-missing-repository --out ../build/vscode/,先经 vscode:prepublish 运行 npm run build,生成 build/vscode/fcdev-win32-x64-<版本>.vsix(*.vsix 已被 .gitignore 与 .vscodeignore 排除,不入库)。.vscodeignore 排除源码、测试、配置与 node_modules,保留编译产物 out/、toolchain/、targets/、templates/、docs/、debug/、chat/、syntaxes/、resources/。

4. 检查

npm run check:package(vscode/tools/check/check-package.mjs)核对 .vsix 的内容,只检查,不修改任何文件:

5. 发布到市场

在 vscode/ 里用发布脚本 vscode/tools/release/release.mjs:

npm run release              # 只检查与打包,不上传
npm run release -- --publish # 检查、打包并上传到市场

发布后在一台干净的 VS Code 里安装,核对:打开含 fcdev.json 的文件夹能构建;设置 fcdev.emulator.path 后能运行与调试运行;Copilot 里能看到全部工具。这部分是手动验证。

6. 包的体积

.vsix 的体积主要来自 toolchain/(五个可执行文件与两个库)与各目标的运行库;以实际 npm run package 的输出为准。