本文说明 VS Code 扩展 fcdev 的打包、检查与发布。登录市场与 vsce publish 由用户执行,不在代码或文档里记录任何凭据。
vscode/,包名 fcdev,发布者 sungbin,扩展 ID sungbin.fcdev;版本取 vscode/package.json 的 version。win32-x64;engines.vscode 为 ^1.101.0(扩展宿主的 Node 要达到 22,调试客户端用全局 WebSocket)。vscode/CHANGELOG.md:标题 ## <版本号>,只写面向使用者的功能性变化,按功能分组,一条一句话;已发布版本的一节不修改,新版本在顶部新增一节,只放本次的改动。Ember 自己的更新记录在它的帮助文档里,与扩展无关。vscode/ 里 npm run build:toolchain,输出到 vscode/toolchain/。npm run build:libs;SB2000 的生成文档已更新:npm run gen:docs。npm run check 通过(类型检查、lint、测试、构建、工具测试)。CHANGELOG.md 里已经写好本版本的更新说明,package.json 的版本已升。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/。
npm run check:package(vscode/tools/check/check-package.mjs)核对 .vsix 的内容,只检查,不修改任何文件:
out/bootstrap/extension.js,package.json 的 main 指向它。toolchain/manifest.json 记录的每个文件都在,且 SHA-256 一致,没有清单之外的文件。targets/<名>/lib/*.lib)、目标定义(target.json)、四个项目模板与 _common。docs/topics.json 登记的每份文档都在。debug/openrpc.json。node_modules、源码 src/、.env、密钥与证书文件、.tgz、.vsix。.vsix 里没有 Ember 与任何 BIOS、ROM 文件。在 vscode/ 里用发布脚本 vscode/tools/release/release.mjs:
npm run release # 只检查与打包,不上传
npm run release -- --publish # 检查、打包并上传到市场
CHANGELOG.md 里有当前版本的一节;运行 npm run check(含编译);运行 npm run package;核对 .vsix(同第 4 节)。加 --publish 时还要求仓库里没有未提交的改动,再用 vsce publish 上传刚打好的 .vsix。VSCE_PAT;文档仓库的 01-文档/密钥/vscode-publish-token.txt;没有时提示输入(输入不显示)。令牌只用于本次运行,脚本不输出内容。令牌由用户保管,不写进本仓库。也可以在市场的管理页面上传 .vsix。发布后在一台干净的 VS Code 里安装,核对:打开含 fcdev.json 的文件夹能构建;设置 fcdev.emulator.path 后能运行与调试运行;Copilot 里能看到全部工具。这部分是手动验证。
.vsix 的体积主要来自 toolchain/(五个可执行文件与两个库)与各目标的运行库;以实际 npm run package 的输出为准。