AndroidStation(原中控改造为纯设备端) - 只做三件事:UDP 48899 被桌面端发现、TCP 8087 推送 USB 扫码结果、离线语音播报 - 扫码不再经过 UI:去掉逐键重绘,50ms 自动提交,同一码重复扫码也一律上报 - 离线语音种子(数字/字母/“开始打包”/欢迎语)随包安装,MediaPlayer 播放,启动把音量拉满 - 启动播报「欢迎使用溯源系统,初始化已经完成,扫码即可开始打包」 - 移除 Device Owner / 设备管理员 / lock task / 网络与 IP 设置等非普通应用能力(仅保留开机自启) - 正式签名 keystore + release 签名配置,versionName/versionCode 可由打包脚本覆盖 发布脚手架 - backend/android_client:Android 正式包构建(build.ps1 + package.config.json) - backend/scripts/deploy/publish-android.cjs + npm run android:build / android:publish - 桌面端安装包改为 download/desktop,Android 为 download/android_client; version.json 仍走 /download/version.json(老客户端写死),新增 /download/android_client/version.json - 谷歌插件随桌面端 MSI 安装到 <安装目录>\extension,工具菜单新增「复制谷歌插件地址」 - git-safety-check 增加仓库级禁区(keystore.properties / *.jks / local.properties) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
64 lines
2.5 KiB
JavaScript
64 lines
2.5 KiB
JavaScript
'use strict';
|
||
|
||
const fs = require('fs');
|
||
const path = require('path');
|
||
const { Controller } = require('egg');
|
||
|
||
/**
|
||
* 安装包分发:版本信息(软件自动更新用)
|
||
*
|
||
* ⚠️ **为什么不放在 egg-static 的目录里**:
|
||
* `koa-static` 命中文件后**不会再调用 next()**,任何「后置中间件」都改不了它的响应头;
|
||
* 而 egg-static 生产默认强缓存一年 → 软件永远拿旧的 version.json,永远检测不到更新。
|
||
*
|
||
* 所以:
|
||
* - 版本信息放在 `app/public/version/<平台>/version.json`(不在静态 prefix 下),由本控制器读文件:
|
||
* desktop → app/public/version/desktop/version.json
|
||
* (更早的版本放在 app/public/version/version.json,仍作为兜底读一次)
|
||
* android_client → app/public/version/android_client/version.json
|
||
* - 安装包本体仍走 egg-static(`/download/desktop/*.msi`、`/download/android_client/*.apk`),
|
||
* 文件名带版本号,可以长缓存。
|
||
*
|
||
* 缓存策略:no-store + no-cache + Expires 0,且不产生 ETag/Last-Modified(不走 304)。
|
||
* 生产前面若还有 nginx/CDN,也要对这些 version.json 关缓存(见 deploy-lib.cjs 的 buildFrontConf)。
|
||
*/
|
||
class DownloadController extends Controller {
|
||
/** GET /download/version.json(桌面端;路径不能改:老客户端写死了这个地址) */
|
||
async version() {
|
||
return this.sendVersion('desktop', [
|
||
'app/public/version/desktop/version.json',
|
||
'app/public/version/version.json',
|
||
]);
|
||
}
|
||
|
||
/** GET /download/android_client/version.json */
|
||
async androidVersion() {
|
||
return this.sendVersion('android_client', [
|
||
'app/public/version/android_client/version.json',
|
||
]);
|
||
}
|
||
|
||
/** 按候选路径顺序取第一个存在的 version.json,null 缓存直出 */
|
||
sendVersion(label, candidates) {
|
||
const { ctx, app } = this;
|
||
const file = candidates
|
||
.map(item => path.join(app.baseDir, item))
|
||
.find(item => fs.existsSync(item));
|
||
|
||
if (!file) {
|
||
ctx.status = 404;
|
||
ctx.body = { ok: false, message: `${label} version.json 不存在(还没打包过?)` };
|
||
return;
|
||
}
|
||
|
||
ctx.set('Cache-Control', 'no-store, no-cache, must-revalidate, max-age=0');
|
||
ctx.set('Pragma', 'no-cache');
|
||
ctx.set('Expires', '0');
|
||
ctx.set('X-Content-Type-Options', 'nosniff');
|
||
ctx.type = 'application/json; charset=utf-8';
|
||
ctx.body = fs.readFileSync(file); // 几百字节,直接读最省事
|
||
}
|
||
}
|
||
|
||
module.exports = DownloadController;
|