需求:打包安装包;协议在**安装时**注册(不依赖先启动软件一次);卸载能清掉注册。
实现(desktop/installer/):
- Product.wxs(WiX 5):
- Scope=perUser(免管理员、无 UAC),安装到 %LOCALAPPDATA%\Programs\YuncangTrace;
- Component 里写 HKCU\Software\Classes\yuncang(默认值 / URL Protocol / shell\open\command),
注册表项属于 MSI 组件 → **卸载时自动删除**,即「取消注册」;
- 开始菜单快捷方式(RemoveFolder On=uninstall);
- MajorUpgrade(升级替换、拒绝降级);用户数据 settings/session.json 不在安装目录,卸载保留。
- 版本号用 $(var.Version) 由构建命令注入,避免和 csproj 两处维护。
- build.ps1:读取 csproj 的 <Version> → dotnet publish(自包含单文件)→ wix build
→ out\YuncangTraceSetup-<版本>.msi。
⚠️ 脚本保存为 UTF-8 with BOM:PowerShell 5.1 读无 BOM 脚本会按 GBK 解析,中文注释会让语法报错。
- 工具链:`dotnet tool install --global wix --version 5.0.2`
(WiX v7 会要求接受 OSMF 付费维护费协议,改用 v5)。
实测(perUser 静默安装 → 协议 → 唤起 → 卸载):
- 安装:文件落到 %LOCALAPPDATA%\Programs\YuncangTrace,HKCU 协议立即指向安装目录
(安装前指向 desktop\publish,安装后被正确覆盖),开始菜单快捷方式已创建;
- **不启动软件**,直接 Start-Process "yuncang://open?code=INSTALLTEST":
进程路径 = 安装目录 exe,日志显示 "已恢复登录:管理员 → 收到启动协议 → 查询:INSTALLTEST";
- 卸载:安装目录删除、HKCU 协议删除、开始菜单删除,均无残留;
- build.ps1 完整跑通,产物 54.1 MB(cab 压缩)。
.gitignore:忽略 desktop/installer/out/ 与 *.wixpdb。
desktop/README.md:新增「打安装包(MSI)」章节(构建命令、安装范围、协议注册/卸载行为、
perMachine 改法、BOM 提醒)。
66 lines
1.4 KiB
Plaintext
66 lines
1.4 KiB
Plaintext
# ============================================================
|
||
# 仓库根忽略规则(backend / frontend / extension 通用)
|
||
# 只在这一处维护;各子项目不必再各写一份(不带斜杠的规则对任意层级都生效)
|
||
# ============================================================
|
||
|
||
# ---------- 依赖 ----------
|
||
node_modules/
|
||
.pnpm-store/
|
||
|
||
# ---------- 构建产物 ----------
|
||
dist/
|
||
build/
|
||
release/
|
||
coverage/
|
||
.nyc_output/
|
||
.vite/
|
||
*.tsbuildinfo
|
||
|
||
# ---------- .NET / WPF(desktop/) ----------
|
||
bin/
|
||
obj/
|
||
publish/
|
||
artifacts/
|
||
.vs/
|
||
*.user
|
||
*.suo
|
||
|
||
# 安装包产物(installer/build.ps1 生成)
|
||
desktop/installer/out/
|
||
*.wixpdb
|
||
|
||
# ---------- 运行期 / 日志 ----------
|
||
# backend 的 logs/、多实例自测时的 logs-test/、脚本产出的 run/
|
||
logs/
|
||
logs-*/
|
||
run/
|
||
tmp/
|
||
*.log
|
||
*.pid
|
||
|
||
# ---------- 环境变量与本地配置(含数据库/Redis 密码,绝不提交) ----------
|
||
.env
|
||
.env.*
|
||
!.env.example
|
||
config.local.js
|
||
config.local.*.js
|
||
|
||
# ---------- Egg 自动生成的类型声明(typings/ 由 egg-ts-helper 生成) ----------
|
||
typings/
|
||
|
||
# ---------- 编辑器 / 系统 ----------
|
||
.vscode/*
|
||
!.vscode/extensions.json
|
||
!.vscode/settings.json
|
||
.idea/
|
||
.DS_Store
|
||
Thumbs.db
|
||
desktop.ini
|
||
|
||
# ---------- 临时文件 ----------
|
||
*.tmp
|
||
*.bak
|
||
* - 副本.*
|
||
# 联调用的临时脚本(如 .tmp-reset-probe.js / .tmp-css-audit.cjs),跑完就删,别提交
|
||
.tmp-*
|