fa11db59ee
后端那个版本地板闸门只会把请求挡成 code 4012,客户端业务代码里没有任何 4012 分支:只拦、不推; 而桌面窗口直载 app-web(APP_URL = config.WEB_HOME_URL),做在页面上才吃得到已经装出去的机器。 判定落在 shared/client-force-update.ts(纯函数,17 例含"换地板结论就翻面"的反例):判不出来一律不拦 (浏览器形态、读不到本机版本、版本串解析不出数字、没有可下的包、线上包并不比本机新)。 遮罩挂 App.vue 根=登录页与首页一起覆盖,自动开始下载,失败只给"重试(断点续传)",不再等第二次确认。
75 lines
3.5 KiB
TypeScript
75 lines
3.5 KiB
TypeScript
/**
|
||
* 强制升级判定(纯函数,无 DOM、可 node --test 直跑)。
|
||
*
|
||
* 动机:桌面窗口的页面是线上 Web(app_client/main.py 的 APP_URL = config.WEB_HOME_URL),
|
||
* 所以"要不要升、不升能不能继续用"这件事只有发一次 app-web 才能覆盖存量装机;
|
||
* 服务端那个版本地板闸门(ClientVersionGuardFilter)只会把请求挡成 code 4012,
|
||
* 而客户端业务代码里没有任何 4012 分支——它只拦、不推。这里补的就是"推"那一半。
|
||
*
|
||
* 判定刻意保守:**任何"判不出来"的情况一律不拦**(浏览器形态、读不到本机版本、
|
||
* 版本串解析不出数字、没有可下载的更新包、最新包并不比本机新)。
|
||
* 挡在门外是拿用户当天的任务换他们的下一次启动,误判一次的代价比漏判大。
|
||
*/
|
||
import { compareVersions, normVersion } from './utils/version-compare.ts'
|
||
|
||
/** 强升地板:低于这个版本的桌面装机必须更新后才能继续用。 */
|
||
export const FORCE_UPDATE_TARGET = '4.0.52'
|
||
|
||
/** 不拦的理由。每个值都必须能在界面上被解释,不许拿空串当"没必要说"。 */
|
||
export type ForceSkipReason =
|
||
| 'not-desktop'
|
||
| 'no-local-version'
|
||
| 'unparsable-local-version'
|
||
| 'invalid-target'
|
||
| 'at-or-above-target'
|
||
| 'no-newer-package'
|
||
|
||
export type ForceDecision =
|
||
| { force: true; localVersion: string; targetVersion: string }
|
||
| { force: false; reason: ForceSkipReason; localVersion: string; targetVersion: string }
|
||
|
||
/**
|
||
* 点分数字版本:至少三段、每段都是非负整数。
|
||
*
|
||
* 需要它是因为 compareVersions 把解析不出的段当 0('4.0.52-beta' 会等于 '4.0.0'),
|
||
* 于是"带后缀的版本"会被判成更旧而误锁人。地板只认能算干净的形状。
|
||
*/
|
||
export function isDottedNumericVersion(value: string): boolean {
|
||
const parts = normVersion(value).split('.')
|
||
if (parts.length < 3) return false
|
||
return parts.every((part) => /^\d+$/.test(part))
|
||
}
|
||
|
||
export function decideForceUpdate(input: {
|
||
/** 有没有真实的桌面桥(能下载并自启更新程序);Web 降级桥不算。 */
|
||
desktopBridge: boolean
|
||
/** 本机 exe 版本(桥读不到就传空串)。 */
|
||
localVersion: string
|
||
/** 线上最新包版本(/api/version/latest 的 version)。 */
|
||
latestVersion: string
|
||
/** 最新包有没有可用下载地址。 */
|
||
hasPackage: boolean
|
||
targetVersion?: string
|
||
}): ForceDecision {
|
||
const target = normVersion(input.targetVersion ?? FORCE_UPDATE_TARGET)
|
||
const local = normVersion(input.localVersion)
|
||
const notForced = (reason: ForceSkipReason): ForceDecision => ({
|
||
force: false,
|
||
reason,
|
||
localVersion: local,
|
||
targetVersion: target,
|
||
})
|
||
|
||
if (!input.desktopBridge) return notForced('not-desktop')
|
||
if (!isDottedNumericVersion(target)) return notForced('invalid-target')
|
||
if (!local) return notForced('no-local-version')
|
||
if (!isDottedNumericVersion(local)) return notForced('unparsable-local-version')
|
||
if (compareVersions(local, target) >= 0) return notForced('at-or-above-target')
|
||
// 到了这一步才看包:没有地址、或线上包并不比本机新,那就拿不出"升上去更好"的东西,
|
||
// 不能把人锁在门外(灰度回滚期 latest 低于地板是真实存在的状态)。
|
||
if (!input.hasPackage) return notForced('no-newer-package')
|
||
const latest = normVersion(input.latestVersion)
|
||
if (!latest || compareVersions(latest, local) <= 0) return notForced('no-newer-package')
|
||
return { force: true, localVersion: local, targetVersion: target }
|
||
}
|