packServer/.gitignore
liufumingren 77b5713d02 新增 MSI 安装包:安装即注册 yuncang:// 协议,卸载自动取消注册
需求:打包安装包;协议在**安装时**注册(不依赖先启动软件一次);卸载能清掉注册。

实现(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 提醒)。
2026-10-17 11:49:26 +08:00

66 lines
1.4 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# ============================================================
# 仓库根忽略规则(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-*