feat(platform): Console 支持 Linux(arm64),Windows 行为逐字不变;版本 dev_0.5.10
需求:让积分榜能在飞腾 D2000(ARM64)的 Linux 上跑起来,**同时不破坏 Windows**。
## 一、Go 服务端:交叉编译即可(**已实测**)
- SQLite 用的是 `modernc.org/sqlite`(纯 Go 驱动),全项目**没有一处 `import "C"`** → `CGO_ENABLED=0 GOOS=linux GOARCH=arm64 go build` 直接出;
- 产物是**静态链接**(`ELF 64-bit LSB executable, ARM aarch64, statically linked`)→ **不依赖 glibc 版本**,对国产系统友好;
- 本机(arm64)**实际启动验证**:数据目录、局域网地址探测、数据库迁移(0001/0002/0003)全部正常;
- 产物:`debug/服务端-arm64/scoreboard`(29 MB,`-s -w`)。
## 二、Console(Electron 宿主):平台差异收口到一个新文件
- **新增 `console/main/platform.js`**:平台差异集中在这 45 行里,其余代码不写平台判断。
⚠️ **`platform` 参数缺省按 Windows 解析** —— 漏传参数走的就是改动前那条老路(这比"改了再小心"更保守:**默认行为不变,新行为必须显式传参**)。
- `userpaths.js` / `datadir.js`:Windows 分支 `%LOCALAPPDATA%\ScoreboardConsole\` **逐字保留**;Linux 分支按 XDG(`$XDG_DATA_HOME`,缺省 `~/.local/share`)。两平台各自的"拿不到用户目录"提示文案分开写(免得现场去设一个本平台不存在的环境变量)。
- `config.js`:服务端文件名按平台取(Windows `scoreboard.exe` / Linux `scoreboard`)。
- **新增 `console/main/autostart.js`**:Linux 用 `~/.config/autostart/*.desktop`(开=写文件、关=删文件;Linux 没有"已注册但未启用"这个中间态)。
- 托盘与窗口行为:Linux 的通知区多数不派发 double-click,因此按平台分支成单击。
## 三、怎么保证没弄坏 Windows
1. **设计上**:平台差异集中 + 缺省值就是 Windows(见上);
2. **逐行核对 diff**:Windows 分支那几行原样未动;
3. **测试**:Console 由 **68 → 96 例**,新增全是平台分支用例,**既有断言一条没改**;
4. **真机验证**:构建机重打 Windows 包并跑(这一道才算收口)。
## 四、自检
全量自检两轮**全绿、`EXIT=0`**:服务端 14 包 / 前端 **944 例** / Console **96 例**。
## 版本
`dev_0.5.9` → **`dev_0.5.10`**;安装器素材同步重生成(照例只动 `brand.bmp` 两张)。
This commit is contained in:
1 parent
55051fd633
commit
efa049c827
19 files changed
+665
-58
No files matched your search
+28
-4
@@ -3,16 +3,21 @@
|
||||
const fs = require('fs')
|
||||
const path = require('path')
|
||||
|
||||
const { serverExeName } = require('./platform')
|
||||
|
||||
// 默认值写死在代码里:config.json 只覆盖要改的项。
|
||||
// 这样升级新增字段时老配置依然能用,现场也不容易配出半成品。
|
||||
// 注意 server.exe 这里写的是 **Windows** 的名字:它是历史上「随包发布的默认值」,
|
||||
// 也是 config.json 模板里的值。按平台换值发生在 loadConfig 里,见那里的注释。
|
||||
const DEFAULTS = {
|
||||
server: {
|
||||
exe: 'scoreboard.exe',
|
||||
// -config 只声明「有个配置文件参数」,值在拉起服务端时被换成解析出的绝对路径:
|
||||
// 打包态指向 <用户根>\config.yaml,开发态保持这里的相对值(见 userpaths.js)
|
||||
args: ['-config', 'config.yaml'],
|
||||
// 数据目录。空串 = 用 Console 选的默认位置(打包态是
|
||||
// %LOCALAPPDATA%\ScoreboardConsole\data,装在安装目录之外,覆盖安装不会丢数据);
|
||||
// 数据目录。空串 = 用 Console 选的默认位置(打包态在用户数据目录下、安装目录之外,
|
||||
// 覆盖安装不会丢数据:Windows 是 %LOCALAPPDATA%\ScoreboardConsole\data,
|
||||
// Linux 是 $XDG_DATA_HOME\ScoreboardConsole\data);
|
||||
// 填了就按它来,相对路径以安装目录为基准(详见 datadir.js)
|
||||
dataDir: '',
|
||||
host: '127.0.0.1',
|
||||
@@ -129,11 +134,30 @@ function stripRenamedKeys(values) {
|
||||
return values
|
||||
}
|
||||
|
||||
function loadConfig(configPath) {
|
||||
// platform 缺省按 Windows 解析(改动前的口径),生产调用点传 process.platform
|
||||
function loadConfig(configPath, platform = 'win32') {
|
||||
const { values, warning } = readJson(configPath)
|
||||
const merged = stripRenamedKeys(merge(DEFAULTS, values))
|
||||
|
||||
// 服务端可执行文件名按平台取:Windows 是 scoreboard.exe,Linux 是 scoreboard。
|
||||
// 判断「文件里写没写过」要看**文件里真实写了什么**(readJson 的原始值),
|
||||
// 与 deprecatedKeyNotices 同一套口径:merge 之后的值一律带 DEFAULTS,拿它判断会把
|
||||
// 每个键都当成「用户写过」。另外,文件里写的正好是 Windows 那个默认名(随包 config.json
|
||||
// 模板就是它,老机器上的用户配置也是从模板复制来的)时,在非 Windows 平台按「没写」处理——
|
||||
// 那不是现场改过的名字,照它去找一个不存在的 .exe 只会「未找到服务端程序」。
|
||||
// 与 RENAMED_KEYS 同一个道理:模板落进老文件里的值,光改默认值救不了。
|
||||
const configured = isPlainObject(values) && isPlainObject(values.server) ? values.server.exe : undefined
|
||||
const customized =
|
||||
typeof configured === 'string' &&
|
||||
configured.trim() !== '' &&
|
||||
!(platform !== 'win32' && configured.trim() === DEFAULTS.server.exe)
|
||||
// server 段被写成 null / 数组时(merge 会原样保留)不在这里报错:以前也是留到真正
|
||||
// 用它的时候才抛,别在这一步凭空多出一个崩溃点
|
||||
if (!customized && isPlainObject(merged.server)) merged.server.exe = serverExeName(platform)
|
||||
|
||||
return {
|
||||
path: configPath,
|
||||
values: stripRenamedKeys(merge(DEFAULTS, values)),
|
||||
values: merged,
|
||||
warning,
|
||||
// 提示按**文件里真实写了什么**算,所以传的是 readJson 的原始值,不是上面那份合并结果
|
||||
notices: deprecatedKeyNotices(values)
|
||||
|
||||
Reference in new issue
Block a user