一、打包配置(desktop/installer/package.config.json) - 两个环境各自的域名:Development = http://127.0.0.1:7300,Production = 占位正式域名(发布前替换)。 - keepVersions = 5。 - build.ps1 -Environment Production 自动用生产域名打 exe 与下载地址;-ServerBaseUrl 可临时覆盖。 二、build.ps1 - 新增 -Environment / -Version / -Keep / -ReleaseNotes;版本默认取 csproj,可覆盖, 通过 -p:Version 注入程序集(AssemblyVersion/FileVersion 一起变)。 - 打完后:算 MD5、写 version.json(version/downloadUrl/md5/size/publishedAt/buildId/environment/releaseNotes), 复制 MSI → backend/app/public/download/,version.json → backend/app/public/version/。 - 本地 out/ 与后端目录各只保留最近 5 个安装包(按版本号排序清理)。 - 补丁版保护:后端已有更高版本时,不覆盖 version.json(避免补打旧版把版本降回去)。 三、后端静态分发 + 缓存(关键) - Egg 的 static 生产默认强缓存一年,version.json 若走静态会**永远检测不到更新**。 且实测 koa-static 命中文件后**不再 next()**,后置中间件改不了它的响应头(先写了 middleware 验证不可行,已删)。 → version.json 放到 app/public/version/(不在静态目录),由路由 GET /download/version.json 提供: Cache-Control: no-store, no-cache, must-revalidate, max-age=0 + Pragma/Expires,且不产生 ETag/Last-Modified。 - MSI 仍走 egg-static(prefix /download/,maxAge 31536000),文件名带版本号可长缓存。 - middleware/frontend.js 放行 /download/*,否则会被 SPA 入口接管。 - 实测响应头:version.json 无 ETag/Last-Modified、cache-control: no-store…; MSI cache-control: public, max-age=31536000。 四、桌面端自动更新(Services/UpdateChecker.cs + App) - 启动登录后后台请求 {后端}/download/version.json?t=毫秒时间戳(带 no-cache 头), 比较程序集版本;有新版则弹窗(版本/说明/大小),点是 → 浏览器打开 downloadUrl。 - 失败静默(网络问题不打扰);日志记录发现新版本/已打开下载。 - 实测:安装 1.0.1 → version.json 1.0.1 不提示;改成 1.0.2 后重启 → 日志「发现新版本 1.0.2(当前 1.0.1.0)→ 已打开下载」。 五、.gitignore - 忽略后端分发产物:backend/app/public/{download,version}/* 但保留 .gitkeep。 ⚠️ backend/config/config.default.js 本次提交同时带入了该文件里已有的未提交改动 (后端默认端口 7001 → 7300 及注释),因为 static 配置必须写在同一个文件里; 其它 backend/extension/frontend 的未提交 WIP 未包含在本次提交中。
72 lines
1.6 KiB
Plaintext
72 lines
1.6 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
|
||
|
||
# 安装包分发目录(打包脚本复制到后端静态目录;只保留 .gitkeep)
|
||
backend/app/public/download/*
|
||
!backend/app/public/download/.gitkeep
|
||
backend/app/public/version/*
|
||
!backend/app/public/version/.gitkeep
|
||
|
||
# ---------- 运行期 / 日志 ----------
|
||
# 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-*
|