diff --git a/client/electron/test/cross-client-theme.test.mjs b/client/electron/test/cross-client-theme.test.mjs index 57ec842..9c2e5ea 100644 --- a/client/electron/test/cross-client-theme.test.mjs +++ b/client/electron/test/cross-client-theme.test.mjs @@ -37,12 +37,34 @@ const rawColors = src => code(src).match(RAW_COLOR) || []; * （来源必须是系统资源 / 品牌色必须是那个值），文档只做第三只手。 */ const plan = readFileSync(join(ROOT, 'docs/HARMONY-ALIGN-PLAN.md'), 'utf8'); +/** + * 取「有意差异」那一小节。 + * + * ⚠️ **按标题定位，不按关键词**（pi 读出来的第三条）： + * 原来写的是 `plan.indexOf('有意差异')` —— 只要别的段落正文里出现过这四个字， + * 切片就从**那一处**开始，后面的 `includes('圆角')`、行数断言全是在**别的段落**上判， + * 可能照样绿。这个坑在本仓库记过一次：`index.css` 的注释里写了深色选择器字面量， + * `theme.test.mjs` 的 `indexOf` 就被提前截断（那条注释现在还留着当教训）。 + */ const diffSection = () => { - const at = plan.indexOf('有意差异'); - assert.ok(at > 0, '文档里应有「有意差异」表（§7.12）'); - const rest = plan.slice(at); - const end = rest.search(/\n#{2,3} /); - return end === -1 ? rest : rest.slice(0, end); + const lines = plan.split('\n'); + const start = lines.findIndex(l => /^#{2,4}\s/.test(l) && l.includes('有意差异')); + assert.ok(start >= 0, '文档里应有「有意差异」小节（§7.12），且要是一行标题'); + const headLevel = (lines[start].match(/^#+/) || ['#'])[0].length; + /* + * 用**行**切，不用字符偏移。 + * + * 第一版是算偏移的（`acc += 每行长度`，再 `slice`），而偏移算术一旦差一个字符 + * 就会把最后一行**拦腰截断** —— 表现是"品牌色那一行只剩 57 个字符、找不到'不允许差异'" + * 这种看着像文案问题、其实是切片问题的怪现象。行切法没有这种自由度。 + */ + const body = []; + for (let i = start + 1; i < lines.length; i++) { + const h = lines[i].match(/^(#{1,6}) /); + if (h && h[1].length <= headLevel) break; + body.push(lines[i]); + } + return body.join('\n'); }; /** 递归收集鸿蒙源码（.ets / .ts） */ @@ -176,6 +198,72 @@ test('A｜系统拥有的维度，鸿蒙侧的唯一来源是系统资源（不 } }); +/** + * Theme.ets 里**允许自己写**的色值名单（与文件里的「手写色登记表」逐字一致）。 + * + * pi 读出来的真缺口：A 条只枚举了"**必须**来自系统资源"的 11 个名字， + * 于是新加一个手写色（`static readonly brandSecondary: string = '#123456'`） + * **三条判据都碰不到它** —— A（不在名单里）、B（六位、不是半透明）、 + * 裸色值那条（只管 `pages/` 目录）。 + * + * 「枚举挡实例，类才挡漂移」：这次的枚举单位是**名字**，所以名单本身就是防线。 + * 想加一个手写色 → 先登记在这里 + 在 `Theme.ets` 的登记表里写一行理由； + * 否则它本来就该走 `$r('sys.*')`。 + */ +const SELF_OWNED_COLORS = [ + // 品牌（跨客户端身份，必须与 WebUI 逐字一致的那一个 + 它的前景/浅底/深色变体） + 'accent', 'accentFg', 'accentSoft', 'accentStrong', + // 业务语义色：系统没有对应物（同意 / 拒绝 / 警示） + 'approve', 'danger', 'approveBg', 'approveFg', 'dangerBg', 'warnBg', 'warnFg', + // 权限档位与预算档位的胶囊配色（档位是产品语义，系统不认识"plan/workspace/full"） + 'chipNeutralBg', 'chipNeutralFg', 'chipSpentBg', 'chipSpentFg', 'chipWarnBg', 'chipWarnFg' +]; + +test('A2｜Theme.ets 里"自己写的色"必须**登记过**：新写死一个色不该默默通过', () => { + const themeSrc = code(harmony); + const declared = [...themeSrc.matchAll(/static readonly (\w+): string = '(#[0-9A-Fa-f]{6,8})'/g)].map(m => m[1]); + assert.ok(declared.length >= 10, `要从 Theme.ets 里读到那些手写色，实际读到 ${declared.length} 个`); + + // ① 未登记的手写色 → 红（这是补上的那一枪） + const extra = declared.filter(n => !SELF_OWNED_COLORS.includes(n)); + assert.deepEqual(extra, [], + `Theme.ets 里出现未登记的手写色：${extra.join('、')} —— ` + + '属于品牌/业务语义色就登记进 SELF_OWNED_COLORS 并在 Theme.ets 的登记表里写一行理由，否则该走 $r(\'sys.*\')'); + + // ② 名单不能烂成"曾经"的化石：登记了却已经不存在的名字 → 红 + const stale = SELF_OWNED_COLORS.filter(n => !declared.includes(n)); + assert.deepEqual(stale, [], `名单里这些名字在 Theme.ets 里已不存在（名单要跟着改）：${stale.join('、')}`); + + /* + * ③ 登记表本身要写在文件里（理由靠记忆是不可靠的，要靠登记）： + * 每个登记项都要在那一段**注释**里出现 —— 所以这里读**原文**（`harmony`）， + * 不是剥过注释的源码（剥注释会把登记表本身剥掉，第一版就踩了这个： + * `indexOf` 返回 -1，切片拿到一段不相干的东西）。 + */ + const regStart = harmony.indexOf('手写色**登记表**'); + assert.ok(regStart > 0, 'Theme.ets 里要有「手写色登记表」那一段'); + const regEnd = harmony.indexOf('品牌色：跨客户端身份', regStart); + assert.ok(regEnd > regStart, '登记表那一段要有明确的结束边界（下一个分节标题）'); + const registry = harmony.slice(regStart, regEnd); + assert.ok(registry.length > 200, `登记表太短，可能切错了段落（${registry.length} 字符）`); + for (const name of SELF_OWNED_COLORS) { + assert.ok(registry.includes(name), `登记表里要提到 ${name}（否则理由只存在于写它那个人的记忆里）`); + } + + /* + * 自检：把一个**新的**手写色塞进去，确认①真的抓得到。 + * 这条自检是"判据能判红"的证据（不依赖外部变异测试也能看出它有效）。 + */ + const mutated = themeSrc.replace( + "static readonly accent: string = '#2563EB';", + "static readonly accent: string = '#2563EB';\n static readonly brandSecondary: string = '#123456';" + ); + assert.notEqual(mutated, themeSrc, '自检：变异没打上'); + const mutatedNames = [...mutated.matchAll(/static readonly (\w+): string = '(#[0-9A-Fa-f]{6,8})'/g)].map(m => m[1]); + const mutatedExtra = mutatedNames.filter(n => !SELF_OWNED_COLORS.includes(n)); + assert.deepEqual(mutatedExtra, ['brandSecondary'], '自检：新加的手写色必须被判据抓到'); +}); + test('B｜旧机制不得回来：手写玻璃 alpha、替系统猜深色、与 WebUI 绑死的圆角数字', () => { const codeOnly = code(harmony); /* @@ -198,27 +286,148 @@ test('B｜旧机制不得回来：手写玻璃 alpha、替系统猜深色、与 assert.ok(!/radiusControl: number = 8/.test(codeOnly), 'radiusControl 又变回写死的 8 了'); }); -test('C｜玻璃位置必须用系统材质，而且只出现在一层', () => { +/** + * 允许出现玻璃的位置**名单**（改判据时一起改这里）。 + * + * pi 读出来的第二条：原来那条判据写的是 `assert.equal(glassCalls.length, 1)`， + * 断言的是"全仓一共一处 `backgroundBlurStyle`" —— 它**不是**"没有嵌套"： + * 同一页面上两个**并列**的玻璃面（不嵌套，没问题）会让它红，而真正的嵌套它没在判。 + * 现在只有导航条一处，所以红得对；但 P5 正是"悬浮玻璃导航"，很可能撞上第二处。 + * + * 到那时要**改判定形状**，不是把 1 改成 2 —— 改成 2 这条就退化成"最多两处"（等于不判）。 + * 所以现在就把形状改成它真正想说的两件事： + * ① **不许嵌套**（模糊叠模糊，视觉上互相打架、性能也白花）； + * ② 每一处玻璃都要**登记**（新开一处玻璃面必须显式过一道，而不是悄悄多出来）。 + */ +const GLASS_REGISTRY = [ + // 文件（相对 ets 根） + 组件/Builder 名：为什么这里可以有一层系统材质 + { file: 'pages/MainPage.ets', provider: 'TabBarBuilder', why: '底部导航栏要浮在内容之上（P5 的悬浮导航）' } +]; + +/** + * 往回找"这次材质作用在哪个组件块上"，返回块尾 `}` 的下标（找不到返回 -1）。 + * + * ⚠️ 这里**不能只看前一个字符是不是 `}`**：ArkUI 的修饰符是链式的， + * `Row() { ... }.backgroundColor(x).backgroundBlurStyle(A)` 里 `backgroundBlurStyle` 前面是 `)`。 + * 第一版就只看了一个字符，于是这种写法下"嵌套"检查**静默失效**（判 get 到 null 就放过去了）—— + * 这正是"断言形状和它声称的东西不是一回事"那一类毛病，判据自检把它抓了出来。 + * 现在往回扫时跳过成对的括号组（含修饰符参数），遇到 `}` 才算块尾。 + */ +const blockEndBefore = (src, at) => { + let i = at - 1; + let depth = 0; + while (i >= 0) { + const c = src[i]; + if (c === ')') { depth++; i--; continue; } + if (c === '(') { depth--; i--; continue; } + if (depth === 0) { + if (c === '}') return i; + if (c === '{' || c === ';') return -1; // 走到了别的结构：这次材质没作用在块上 + } + i--; + } + return -1; +}; + +/** 用花括号配对取 span（剥过注释的源码上做；字符串里的花括号在这份代码里不出现） */ +const braceSpans = (src) => { + const spans = []; + const stack = []; + for (let i = 0; i < src.length; i++) { + const c = src[i]; + if (c === '{') stack.push(i); + else if (c === '}' && stack.length) spans.push([stack.pop(), i]); + } + return spans; +}; + +test('C｜玻璃：位置用系统材质、不许叠、每一处都要登记（形状判据，不是数数）', () => { /* * 「用系统方案」里最容易被写歪的一处：`#B8FFFFFF` 看着也能出玻璃效果， - * 但它不跟随深色模式、也不跟随系统的模糊半径。所以钉两件事： - * ① 材质档次来自 `BlurStyle`（系统枚举），② 应玻璃化的位置真的调了 `backgroundBlurStyle`。 - * 另外**只许一层** —— 嵌套各加一层模糊是 pi 点名要避免的（视觉上会互相打架）。 + * 但它不跟随深色模式、也不跟随系统的模糊半径。所以钉三件事： + * ① 材质档次来自 `BlurStyle`（系统枚举）；② 该玻璃化的位置真的调了 `backgroundBlurStyle`； + * ③ **不许叠**（同一组件叠两次 / 套在另一层玻璃的子树里）+ 每一处都登记。 + * + * ③ 的形状是 pi 读出来的第二条：原来写的是 `assert.equal(glassCalls.length, 1)` —— + * 那断言的是"全仓一共一处"，**不是**"没有嵌套"：同一页面两个**并列**玻璃面会让它红 + * （并列本身没问题），而真正的嵌套它没在判。P5 正是"悬浮玻璃导航"，很可能撞上第二处； + * 到那时若把 1 改成 2，这条就退化成"最多两处"（等于不判）。所以现在就把形状改对。 */ const codeOnly = code(harmony); assert.match(codeOnly, /static readonly navMaterial: BlurStyle = BlurStyle\.[A-Z_]+/, '导航材质要声明成系统材质档次'); const navMaterial = codeOnly.match(/navMaterial: BlurStyle = BlurStyle\.([A-Z_]+)/)[1]; assert.notEqual(navMaterial, 'NONE', 'NONE 等于没有材质，"玻璃"就名存实亡'); - const ets = collectEts(join(ROOT, 'client/harmony/entry/src/main/ets')); - const glassCalls = []; - for (const f of ets) { + const etsRoot = join(ROOT, 'client/harmony/entry/src/main/ets'); + /** 每个调用点：哪一处（文件#组件）、调用下标、它作用的**组件块**（配对出来的） */ + const found = []; + for (const f of collectEts(etsRoot)) { const src = code(readFileSync(f, 'utf8')); - for (const m of src.matchAll(/backgroundBlurStyle\(/g)) glassCalls.push(f); + const spans = braceSpans(src); + for (const m of src.matchAll(/backgroundBlurStyle\(/g)) { + const at = m.index; + const bEnd = blockEndBefore(src, at); + const span = bEnd >= 0 ? spans.find(sp => sp[1] === bEnd) : undefined; + const owner = [...src.slice(0, at).matchAll(/(?:struct|@Builder\s+)\s*(\w+)/g)].pop(); + found.push({ + key: `${f.slice(etsRoot.length + 1)}#${owner ? owner[1] : '(未识别)'}`, + at, + block: span ? { start: span[0], end: span[1] } : null + }); + } } - assert.equal(glassCalls.length, 1, `玻璃应只出现在一处，实际 ${glassCalls.length} 处：${glassCalls.join('、')}`); + assert.ok(found.length > 0, '至少导航条要用系统材质（不是手写 alpha）'); + + /* + * 叠用判定（两种形态都判红）： + * · 同一组件：两处调用解析到**同一个块**（`X.blur(A).blur(B)` 就是这种，ArkUI 的修饰符链 + * 作用在同一个节点上 —— 注意它前面是 `)` 不是 `}`，所以按字符相邻判会漏）； + * · 子树：一处的调用点落在另一处的块**内部**。 + */ + const doubled = new Set(); + const nested = new Set(); + for (const c of found) { + for (const o of found) { + if (o === c) continue; + if (c.block && o.block && c.block.start === o.block.start && c.block.end === o.block.end) { + const pair = [c.at, o.at].sort((a, b) => a - b).join('-'); + doubled.add(`${c.key}@${pair}`); + } else if (c.block && o.at > c.block.start && o.at < c.block.end) { + nested.add(`${c.key}（内含 ${o.key} 的玻璃）`); + } + } + } + assert.deepEqual([...doubled], [], `同一个组件上不该叠多层模糊：${[...doubled].join('、')}`); + assert.deepEqual([...nested], [], `玻璃不该套在另一层玻璃的子树里：${[...nested].join('、')}`); + + // 每一处都要登记；名单里也不能有已经不存在的位置（否则名单会烂成化石） + const keys = found.map(c => c.key); + const registered = GLASS_REGISTRY.map(g => `${g.file}#${g.provider}`); + const unregistered = keys.filter(k => !registered.includes(k)); + assert.deepEqual(unregistered, [], + `这些位置开了玻璃但没登记：${unregistered.join('、')} —— ` + + '要开新的玻璃面就在 GLASS_REGISTRY 里登记（附一句为什么），否则该用普通系统背景色'); + const stale = registered.filter(k => !keys.includes(k)); + assert.deepEqual(stale, [], `名单里这些位置已经没有玻璃了（名单要跟着改）：${stale.join('、')}`); + for (const g of GLASS_REGISTRY) { + assert.ok(g.why && g.why.length >= 8, `GLASS_REGISTRY 里 ${g.file}#${g.provider} 要写一句为什么可以在这里开玻璃`); + } + + // 导航条那一处必须真的还在（形状判定之外，位置本身也要在） const main = code(readFileSync(join(ROOT, 'client/harmony/entry/src/main/ets/pages/MainPage.ets'), 'utf8')); assert.match(main, /\.backgroundBlurStyle\(Theme\.navMaterial\)/, '导航条要用系统材质（不是手写 alpha）'); + + /* + * 自检：造一次**链式叠用**（`X.blur().blur()`），确认上面的判定抓得到。 + * 这一枪放在判据里，是为了以后改这段扫描逻辑时它自己会被检验 —— + * 第一版只看"前一个字符是不是 }"，对这种写法**静默失效**，正是这条自检抓出来的。 + */ + const sample = 'Row() { Text("x") }\n .backgroundBlurStyle(Theme.navMaterial)\n .backgroundBlurStyle(Theme.navMaterial)'; + const sampleEnds = [...sample.matchAll(/backgroundBlurStyle\(/g)].map(m => blockEndBefore(sample, m.index)); + assert.ok(sampleEnds.every(e => e >= 0), '自检：链式写法要能解析出所作用的块'); + assert.equal(new Set(sampleEnds).size, 1, '自检：同一组件的两处调用必须解析到同一个块（否则叠用判不出来）'); + const sampleSpans = braceSpans(sample); + assert.ok(sampleSpans.some(sp => sp[1] === sampleEnds[0]), '自检：块的配对要能对上'); }); test('★ 品牌色防线：主操作色不得退化成系统强调色', () => { @@ -308,6 +517,23 @@ test('遮罩：交给系统的遮罩语义色（"随主题换向"这件事现在 // 不许再自己维护"色 + 透明度"两个常量（那正是系统已经替我们做掉的事） assert.ok(!/overlayColor: string/.test(code(harmony)), '遮罩色不该再由我们自己定'); assert.ok(!/overlayAlpha: number/.test(code(harmony)), '遮罩透明度不该再由我们自己定'); + + /* + * pi 读出来的第四条：判据只断言 `overlay` **存在**，没断言它**被用** —— + * 立一个没人用的令牌是自证（判据只能验"它还在"，验不了它有用）。 + * 所以这里补一条：它必须在 `Theme.ets` **之外**有真实使用点， + * 否则要么删掉、要么说明它为什么该留着。 + */ + const etsRoot = join(ROOT, 'client/harmony/entry/src/main/ets'); + const themePath = join(HARMONY_ETS, 'common/Theme.ets'); + const overlayUsers = collectEts(etsRoot) + .filter(f => f !== themePath) + .filter(f => /Theme\.overlay\b/.test(code(readFileSync(f, 'utf8')))) + .map(f => f.slice(etsRoot.length + 1)); + assert.ok(overlayUsers.length > 0, + 'Theme.overlay 声明了却没有任何使用点 —— 那就是个死令牌（要么删掉，要么写出它的使用处）'); + // 用它的必须是**自绘遮罩**的地方（系统自带遮罩的弹窗不需要它） + assert.ok(overlayUsers.every(f => f.endsWith('.ets')), `遮罩使用点应该是页面：${overlayUsers.join('、')}`); assert.ok(!/#[0-9A-Fa-f]{8}/.test(code(harmony)), '遮罩不该再写成色与透明度焊死的 #AARRGGBB 单值'); // WebUI 侧同构：颜色两套（浅/深，同一个变量名换向）+ 透明度独立 assert.match(web, /--bg-scrim: 255 255 255/, 'WebUI 浅色遮罩色'); @@ -328,7 +554,21 @@ test('C｜「有意差异」表列全了允许不同的维度，并点名品牌 for (const dim of ['圆角', '材质', '动效', '遮罩']) { assert.ok(section.includes(dim), `「有意差异」表里要列 ${dim}（它现在是"允许不同"的维度）`); } - assert.match(section, /品牌色[\s\S]{0,80}不允许差异/, '品牌色必须被点名"不允许差异"，否则下一个人会以为它也在表内'); + /* + * 品牌色那一行：**按行取**，不用"关键词 + 窗口"。 + * 原来写的是 `/品牌色[\s\S]{0,80}不允许差异/` —— 窗口宽度是在赌表格单元格的字符数 + * （品牌色行里"品牌色"与"不允许差异"隔着 WebUI/鸿蒙 两格，正好 > 80）。 + * 窗口型断言和 `indexOf` 是同一类毛病：看着断言了，其实在赌排版。 + */ + const brandRow = section.split('\n').find(l => /^\|\s*\**品牌色/.test(l)); + assert.ok(brandRow, '「有意差异」表里应有品牌色一行（它要显式写明"不允许差异"）'); + assert.match(brandRow, /不允许差异/, '品牌色必须被点名"不允许差异"，否则下一个人会以为它也在表内'); + // 表头列名要对（这也让"拿错段落"自己红出来：拿错段落时表头不会是这个形状） + const header = section.split('\n').find(l => l.startsWith('|') && !l.includes('---')); + assert.ok(header, '差异表要有表头'); + for (const col of ['WebUI', '鸿蒙', '为什么']) { + assert.ok(header.includes(col), `差异表表头要有「${col}」列，实际：${header}`); + } // 反向对照：表里必须真的写了"为什么允许不同"，不是只列个名字 const rows = section.split('\n').filter(l => l.startsWith('|') && !l.includes('---')); assert.ok(rows.length >= 5, `差异表应有表头 + 至少 4 行，实际 ${rows.length} 行`); diff --git a/client/electron/test/harmony-system-api.test.mjs b/client/electron/test/harmony-system-api.test.mjs index fa38149..41d60f9 100644 --- a/client/electron/test/harmony-system-api.test.mjs +++ b/client/electron/test/harmony-system-api.test.mjs @@ -173,3 +173,108 @@ test('替换成系统方案时要用的那批系统色，先在这里核过（ assert.equal(table.get(ghost), undefined, `${ghost} 竟然存在了？那这条边界要重新核一遍`); } }); + +/* + * ─────────── 废弃 API：**清单从 SDK 生成**，不手写 ─────────── + * + * pi 的建议（2026-09-14）：与其一条条手写"不得再用全局 `promptAction.showToast`"， + * 不如从 SDK 的 `@deprecated` 标记**生成**一份清单，再配一份人工 allow-list —— + * 新增一条默认判红，除非有人显式放行。这与 `$r('sys.*')` 名字表的做法是同一个套路。 + * + * 手写清单的死法是"只挡已经踩过的那一个"：这次修了 23 处，下一个人写个新的废弃 API + * 照样全绿 —— 而 SDK 自己知道哪些废弃了，问它就行。 + */ + +/** 递归收集 SDK 的 .d.ts（含 api/ 与 component/） */ +function sdkDtsFiles() { + const roots = [ + join(CLT, 'sdk/default/openharmony/ets/component'), + join(CLT, 'sdk/default/openharmony/ets/api') + ]; + const out = []; + const walk = (dir) => { + for (const e of readdirSync(dir, { withFileTypes: true })) { + const full = join(dir, e.name); + if (e.isDirectory()) walk(full); + else if (e.name.endsWith('.d.ts')) out.push(full); + } + }; + for (const r of roots) if (existsSync(r)) walk(r); + return out; +} + +/** + * 顶层（不在 namespace/class 里）被标 `@deprecated` 的 `declare function` 名字。 + * + * "顶层"这件事必须判：`declare namespace fileIo { declare function open(...) }` 里的 + * `open` 是**命名空间成员**，全局调 `open(...)` 并不会走到那个废弃实现 —— + * 把它算进来会造出一堆假红（这一版就是按花括号深度筛出来的）。 + */ +function deprecatedGlobalFunctions() { + const names = new Set(); + for (const f of sdkDtsFiles()) { + const src = readFileSync(f, 'utf8'); + // 先切出 depth == 0 的片段 + let depth = 0; + let segStart = 0; + const segs = []; + for (let i = 0; i < src.length; i++) { + const c = src[i]; + if (c === '{') { + if (depth === 0) segs.push([segStart, i]); + depth++; + } else if (c === '}') { + depth--; + if (depth === 0) segStart = i + 1; + } + } + if (depth === 0) segs.push([segStart, src.length]); + const top = segs.map(([a, b]) => src.slice(a, b)).join('\n'); + for (const m of top.matchAll(/\/\*\*((?:(?!\*\/)[\s\S])*?)\*\/\s*declare function (\w+)\s*\(/g)) { + if (m[1].includes('@deprecated')) names.add(m[2]); + } + } + return names; +} + +test('废弃 API：清单**从 SDK 生成**，源码里不得调用（新增一条默认判红）', () => { + if (missingSdk.length) return; // 没有 SDK：这一条无从判起（由文件顶部统一报） + const deprecated = deprecatedGlobalFunctions(); + assert.ok(deprecated.size > 20, `要从 SDK 读到一批废弃的全局函数，实际 ${deprecated.size} 个`); + // 清单真的抓到了我们关心的东西（否则"生成"这件事本身没生效） + for (const must of ['animateTo', 'getContext', 'px2vp']) { + assert.ok(deprecated.has(must), `清单里应该有 ${must}（它已被 SDK 标记废弃）`); + } + // 全局 showToast 不是 `declare function`（它是命名空间成员），由 harmony-logic 那条单钉 + + /** + * 允许的例外：**每条都要写理由**。 + * 空名单就是"一处都不许"—— 想加就得在这里写明为什么非用不可。 + */ + const ALLOW = []; + + const walk = (dir, acc = []) => { + for (const e of readdirSync(dir, { withFileTypes: true })) { + const full = join(dir, e.name); + if (e.isDirectory()) walk(full, acc); + else if (/\.(ets|ts)$/.test(e.name)) acc.push(full); + } + return acc; + }; + const files = walk(ETS_DIR); + const hits = []; + for (const f of files) { + const src = readFileSync(f, 'utf8').replace(/\/\*[\s\S]*?\*\//g, '').replace(/^\s*\/\/.*$/gm, ''); + for (const name of deprecated) { + // 只算**全局调用**：排除成员调用 `x.name(`（`.animateTo(` 是我们要求的新写法） + const re = new RegExp(`(? ALLOW.some(a => h.includes(a.name))); + const bad = hits.filter(h => !ALLOW.some(a => h.includes(a.name))); + assert.deepEqual(bad, [], + `这些地方调了 SDK 已标记废弃的**全局**函数：${bad.join('、')} —— ` + + '换成新写法（如 UIContext 上的同名方法），或把它登记进 ALLOW 并写明理由'); + assert.ok(allowed.length === ALLOW.length || allowed.length >= 0, 'allow-list 命中统计'); +}); diff --git a/client/harmony/entry/src/main/ets/common/Theme.ets b/client/harmony/entry/src/main/ets/common/Theme.ets index 19205d5..c0ec6cc 100644 --- a/client/harmony/entry/src/main/ets/common/Theme.ets +++ b/client/harmony/entry/src/main/ets/common/Theme.ets @@ -78,6 +78,48 @@ export class Theme { /** 控件圆角：系统"按钮"圆角 */ static readonly radiusControl: Resource = $r('sys.float.ohos_id_corner_radius_button'); + /* + * ─────────────── 手写色**登记表**（改这里要一起改判据） ─────────────── + * + * 为什么需要这张表：本文件里"自己写的色值"是有理由的（品牌身份 + 系统没有对应物的 + * 业务语义色），但**理由不能靠记忆**。判据（`cross-client-theme.test.mjs` 的 + * A2 条）会枚举本文件里所有 `static readonly X: string = '#……'`， + * 发现**未登记的名字就判红** —— 于是"新写死一个色"必须显式过一道： + * 要么登记在这里并写清理由，要么它本来就该走 `$r('sys.*')`。 + * + * 这条是 pi 读出来的真缺口：只枚举 11 个"必须是系统资源"的名字，挡不住 + * 第 12 个**新加的手写色**（它不在名单里，于是 A/B/裸色值三条都碰不到它）。 + * 「枚举挡实例，类才挡漂移」—— 这次枚举的是**名字**，所以要有名单。 + * + * 登记项（17 个，名字与判据里的 SELF_OWNED_COLORS 逐字一致 —— 逐个列出而不是缩写， + * 这样 grep 一个名字就能找到它的理由）： + * + * 品牌（跨客户端身份，系统给不了）： + * · accent #2563EB 与 WebUI 的 --c-blue-600 逐字一致 + * · accentFg #FFFFFF 品牌底上的文字 + * · accentSoft #EFF6FF 品牌浅底（选中态背景） + * · accentStrong #1D4ED8 品牌深色变体（选中文字/边框） + * + * 业务语义（系统只有 list/warning/alert 这一档，没有"同意/拒绝"）： + * · approve #15803D 同意（绿） + * · approveBg #F0FDF4 同意底 + * · approveFg #15803D 同意文字 + * · danger #B91C1C 拒绝/危险（红） + * · dangerBg #FEF2F2 拒绝底 + * · warnBg #FFFBEB 警示底（对应 WebUI --c-amber-50） + * · warnFg #B45309 警示文字（对应 WebUI --c-amber-700） + * + * 档位胶囊（档位是产品语义：系统不认识 plan / workspace / full）： + * · chipNeutralBg #F3F4F6 plan 档底（最宽档但不报警） + * · chipNeutralFg #5A6270 plan 档文字 + * · chipSpentBg #FEE2E2 预算耗尽底 + * · chipSpentFg #B91C1C 预算耗尽文字 + * · chipWarnBg #FFEDD5 预算紧张底 + * · chipWarnFg #C2410C 预算紧张文字 + * + * 不在这里的手写色只有一种合法去处：`$r('sys.*')`（跟随系统/深色模式）。 + */ + // ─────────────── 品牌色：跨客户端身份，必须自己写 ─────────────── /** diff --git a/docs/HARMONY-ALIGN-PLAN.md b/docs/HARMONY-ALIGN-PLAN.md index fa5be1c..37609b7 100644 --- a/docs/HARMONY-ALIGN-PLAN.md +++ b/docs/HARMONY-ALIGN-PLAN.md @@ -501,6 +501,21 @@ deb 也不必从 targets 里摘。已写进 `client/electron/BUILD.md`（含排 | 遮罩 | 自声明 `--bg-scrim` + `--bg-dim` 两段式 | 系统 `sys.color.ohos_id_color_mask_regular` | 遮罩要随主题换向（浅色洗白/深色压黑），这件事系统已经做了 | | **品牌色** | `--c-blue-600: 37 99 235` | `Theme.accent = '#2563EB'` | **不允许差异** —— 两个客户端是同一个产品 | +**关于 `overlayColor` / `overlayAlpha` 消失**（pi 要求把删除理由记在这里，否则下一个人会当成漏改补回来）： +鸿蒙这边的模态走**系统弹窗**（`bindSheet` / 自绘 `Stack` 只做位置，遮罩本身用系统遮罩色）， +所以"遮罩色 + 遮罩透明度"这两个自定值**整类**都不需要了 —— 系统遮罩色自带随主题换向 +（浅色洗白 / 深色压黑）。保留的是**一个** `Theme.overlay`（值 = `sys.color.ohos_id_color_mask_regular`）， +它是自绘弹层唯一还需要引用的那一个令牌；判据钉两件事：值来自系统、且**在 `Theme.ets` 之外确有使用点** +（只有声明没有使用 = 死令牌，pi 点过这条）。 + +**材质为什么是 `COMPONENT_THICK`**（pi 指出：判据只能钉"来自系统枚举"，钉不了"选对没选对"， +所以理由要写下来，免得后人以为随便挑的）：底部导航栏是**内容之上的一层**，要挡住滚动内容 +又不至于把内容糊没 —— `COMPONENT_*` 系列是"组件材质"（作用于一个组件表面）， +其中 THIN 在浅色壁纸上几乎看不出分层（导航条会像没浮起来）；BACKGROUND_* 系列是 +**整窗背景**用的（会把下方内容整体重绘，这里是叠一层而不是换背景，用它会与页面底色打架）； +ULTRA_THICK 会把导航条底下的内容糊成一块。所以取 COMPONENT_THICK。 +**这条只有真机能判**，见下面「模拟器起来后第一个要看的项」。 + ### 7.13 系统方案替换（第一批）+ 跨端判据从"取值"改"意图" **改了什么**（鸿蒙侧）： @@ -604,7 +619,7 @@ SDK 里写着：`@ohos.promptAction.d.ts` 的全局 `showToast` 标 `@deprecated `COMM_TABS[1.5]` → `undefined`（表现是"点哪都不亮"）。范围检查挡不住非整数， 已加 `Number.isInteger`。 -**未验**：底部/内部页签在真机上的观感、悬浮加号的位置、徽标与文字的排版 —— +**未验**（**模拟器起来后第一个要看的项**：§7.12 里那个材质档次 —— 间距是数字，材质是判断）：底部/内部页签在真机上的观感、悬浮加号的位置、徽标与文字的排版 —— 仍然只有真机（或模拟器，需人在命令行启动）能看。已验证：构建成功、28 条判据全绿、 六种变异都能判红。