【万能转换器|01】HarmonyOS ArkTS 单位换算引擎实战:用基准单位避免链式换算误差
【万能转换器|01】HarmonyOS ArkTS 单位换算引擎实战:用基准单位避免链式换算误差
证据边界:本文基于
D:\huawei\one3(万能转换器)当前源码进行静态核对。“当前事实”来自 UnitData、UnitConverter、ConvertPage 与 UnitConverter.test;“历史证据”仅指原草稿及其既有平台记录;“建议实现”和“验收设计”均明确标注。本轮未执行 Hypium、项目构建、模拟器、真机、极端值脚本或性能采样。

单位换算看似只是“乘一个系数”,真正放进 HarmonyOS 应用后,却很容易变成一张难以维护的关系网:米到厘米写一条公式,厘米到英寸再写一条公式,后来增加码、英尺和英里,转换组合数迅速膨胀;温度又不是纯比例关系,不能继续套用乘除法;页面还要同时展示所有目标单位,一旦把显示精度提前混进计算,用户点击结果切换输入单位时,误差会继续被放大。
本文不造一个脱离项目的示例,而是拆解“万能转换器”真实源码中的 UnitData.ets、UnitConverter.ets、ConvertPage.ets 与 UnitConverter.test.ets。工程面向 HarmonyOS 5.0 及以上版本,使用 ArkTS 类型、ArkUI 状态驱动页面和 Hypium 用例。当前实现支持长度、重量、面积、体积、温度、时间、速度、数据存储八类单位;线性单位使用 factor,温度使用 toBase/fromBase,所有转换统一经过类目基准单位。
convertAll 的单基准流程
引擎先定位源单位并计算一次 base,再遍历所有目标单位生成 raw value 与 display。所有目标共享同一中间值,不发生目标到目标的链式换算。

基准单位换算引擎的职责边界
UnitData 声明线性 factor 与非线性函数,UnitConverter 负责纯计算,ConversionResult 隔离原始值与展示值,ConvertPage 只消费结果模型,Hypium 当前仅覆盖部分边界。

一、先看问题本质:单位数量增长,公式数量不能跟着平方增长
假设一个类目有 n 个单位。如果为每一对方向都保存独立公式,最多需要维护 n × (n - 1) 条有向关系。长度类当前有毫米、厘米、分米、米、千米、英寸、英尺、码、英里九个单位,按两两直接换算就是 72 条关系。以后增加海里,关系数会立刻增加到 90 条。
这还只是维护成本。更隐蔽的问题是不同关系可能来自不同精度的常量。例如“英寸到厘米”写成 2.54,“厘米到英尺”又写成 0.0328084,用户从英寸换到厘米,再点击结果切换成英尺,实际上走过两份精度口径。页面如果还把每步结果截成固定小数位,往返换算就不再接近原值。
当前工程没有保存单位之间的完整关系图,而是给每个类目确定一个基准:
| 类目 | 基准单位 | 代表定义 |
|---|---|---|
| 长度 | 米 m | 英寸 factor = 0.0254 |
| 重量 | 千克 kg | 斤 factor = 0.5 |
| 面积 | 平方米 m² | 亩 factor = 666.666... |
| 体积 | 升 L | 美制加仑 factor = 3.785411784 |
| 温度 | 摄氏度 °C | 华氏、开尔文使用函数 |
| 时间 | 秒 s | 小时 factor = 3600 |
| 速度 | 米每秒 m/s | 千米每小时 factor = 1 / 3.6 |
| 数据存储 | 字节 B | 1 KB = 1024 B |
任意转换都只有同一种结构:
source value
-> source unit toBase
-> value in category base
-> target unit fromBase
-> raw numeric result
这样新增一个线性单位只需提供“它与基准单位的关系”,不会修改其它单位。关系数从平方级降为线性级,公式来源也集中到一个位置。
二、真实数据模型:Unit、UnitGroup 和 ConvertType 各自只负责一件事
源码在 entry/src/main/ets/common/Routes.ets 中把可路由的换算类型收敛成联合类型:
export type ConvertType =
| 'length' | 'weight' | 'area' | 'volume'
| 'temperature' | 'time' | 'speed' | 'data';
这不是为了好看。它让 getUnitGroup(type)、页面路由参数和默认单位设置共享同一组合法值,避免页面传入任意字符串后才在运行期发现类目不存在。ArkTS 比松散 JavaScript 更强调可静态检查的结构,这种联合类型非常适合表达“有限且明确的业务枚举”。
单位本身由 Unit 描述:
export interface Unit {
key: string;
symbol: string;
name: string;
factor?: number;
toBase?: (v: number) => number;
fromBase?: (v: number) => number;
}
export interface UnitGroup {
type: ConvertType;
title: string;
baseKey: string;
units: Unit[];
}
四个字段承担不同职责:
key是稳定身份,用于查找、路由参数、持久化默认值和ForEachkey。symbol是结果行的短标签,例如m/s、°F。name是面向用户的中文说明,例如“米每秒”“华氏度”。factor或函数描述数学规则,不负责展示格式。
UnitGroup 则建立类目边界。长度单位绝不能拿去和重量单位换算,因此引擎接收的是一个完整 group,查找范围天然被限制在该类目。当前 getUnitGroup 对未知类型直接抛错,也比悄悄退回长度类更安全:
export function getUnitGroup(type: ConvertType): UnitGroup {
switch (type) {
case 'length': return LENGTH;
case 'weight': return WEIGHT;
case 'area': return AREA;
case 'volume': return VOLUME;
case 'temperature': return TEMPERATURE;
case 'time': return TIME;
case 'speed': return SPEED;
case 'data': return DATA;
default:
throw new Error(`Unknown convert type: ${type}`);
}
}
三、线性单位的 factor 到底表示什么
项目对 factor 的约定非常明确:
value_in_base = value * factor
所以长度基准是米时,厘米的 factor 为 0.01,千米为 1000,英寸为 0.0254。把 3 km 转成米:
base = 3 × 1000 = 3000 m
再把 3000 m 转成英里,英里的 factor 是 1609.344:
target = 3000 ÷ 1609.344 ≈ 1.8641136 mi
这个方向约定必须在代码注释、数据审查和测试里保持一致。最常见的错误是有人把某个系数理解成“1 个基准单位等于多少目标单位”,于是对部分单位填写倒数。项目的 toBase 与 fromBase 正好把方向固化:
function toBase(group: UnitGroup, unit: Unit, value: number): number {
if (unit.toBase) {
return unit.toBase(value);
}
if (unit.factor !== undefined) {
return value * unit.factor;
}
throw new Error(`Unit ${unit.key} in group ${group.type} has neither factor nor toBase`);
}
function fromBase(group: UnitGroup, unit: Unit, baseValue: number): number {
if (unit.fromBase) {
return unit.fromBase(baseValue);
}
if (unit.factor !== undefined) {
return baseValue / unit.factor;
}
throw new Error(`Unit ${unit.key} in group ${group.type} has neither factor nor fromBase`);
}
对于正常线性单位,源单位乘系数进入基准,目标单位除系数离开基准。无论源和目标如何组合,核心代码都不变。
四、温度为什么必须走函数,而不能硬塞进 factor
长度、重量和速度都满足过原点的比例关系,温度不满足。华氏温度转摄氏温度不仅要缩放,还要平移:
C = (F - 32) × 5 / 9
F = C × 9 / 5 + 32
如果只设计一个 factor,就无法表达 -32 和 +32。当前温度定义因此使用函数:
const TEMPERATURE: UnitGroup = {
type: 'temperature',
title: '温度',
baseKey: 'C',
units: [
{ key: 'C', symbol: '°C', name: '摄氏度', factor: 1 },
{
key: 'F',
symbol: '°F',
name: '华氏度',
toBase: (f: number) => (f - 32) * 5 / 9,
fromBase: (c: number) => c * 9 / 5 + 32,
},
{
key: 'K',
symbol: 'K',
name: '开尔文',
toBase: (k: number) => k - 273.15,
fromBase: (c: number) => c + 273.15,
},
],
};
这套模型实际支持的并不只是温度,而是“可逆的一维映射”。将来如果出现带偏移量、分段或业务定义的单位,只要能可靠提供 toBase 与 fromBase,引擎主体就无需改写。
但这里要守住一个契约:自定义转换最好成对出现。当前类型允许只定义 toBase 或只定义 fromBase,运行到缺失方向时才抛错。更严格的后续实现可以把线性单位与函数单位做成可辨识联合类型,让编译器阻止“不完整单位”进入表中:
interface LinearUnit {
key: string;
symbol: string;
name: string;
factor: number;
}
interface FunctionalUnit {
key: string;
symbol: string;
name: string;
toBase: (v: number) => number;
fromBase: (v: number) => number;
}
type StrictUnit = LinearUnit | FunctionalUnit;
这是基于现有实现的增强建议,不是对当前源码能力的冒充。
五、核心 convert 为什么只保留原始 number,不提前四舍五入
当前单值转换函数只有四步:
export function convert(
group: UnitGroup,
fromKey: string,
toKey: string,
value: number,
): number {
if (!Number.isFinite(value)) {
return NaN;
}
const from = findUnit(group, fromKey);
const to = findUnit(group, toKey);
const base = toBase(group, from, value);
return fromBase(group, to, base);
}
这里故意没有 toFixed(2)。计算层如果提前把 1 inch 截成 0.03 m,再切换成厘米就会得到 3 cm,而正确值应是 2.54 cm。格式化应当是显示策略,不应该污染可继续参与运算的原始值。
页面的结果对象同时保存 value 与 display:
export interface ConversionResult {
unit: Unit;
value: number;
display: string;
}
value 用于后续切换输入单位,display 用于界面。两者分开后,既能给用户可读结果,也能避免把千分位逗号、科学计数法或截断后的小数重新送入数学引擎。
项目还对非法数值统一返回 NaN。这使一对多转换能够稳定生成完整列表,只是在展示时统一输出 -,而不是输入框短暂为空就抛异常、打断 ArkUI 重组。
六、convertAll 只计算一次基准值,避免重复工作和口径漂移
换算页不是只显示一个目标,而是显示该类目下除当前输入单位外的所有单位。低效做法是遍历目标单位,每次都调用完整 convert,重复查找源单位、重复计算基准值。
当前 convertAll 先查一次源单位,只计算一次 base,再映射所有目标:
export function convertAll(
group: UnitGroup,
fromKey: string,
value: number,
): ConversionResult[] {
const from = findUnit(group, fromKey);
const base = Number.isFinite(value) ? toBase(group, from, value) : NaN;
return group.units.map((u: Unit) => {
const v = Number.isFinite(base) ? fromBase(group, u, base) : NaN;
return {
unit: u,
value: v,
display: formatNumber(v),
} as ConversionResult;
});
}
当前每组最多九个左右单位,性能压力本身不大,但这个结构有两个工程价值:
- 所有目标结果共享同一份基准值,数学口径一致。
- 页面只调用一个公开接口,不需要理解线性与非线性分支。
- 非法输入仍返回与单位列表等长的结果,UI 结构稳定。
- 将来增加单位时,结果列表自然扩展,不需要修改页面循环。
这也是“数据驱动”在 ArkUI 中真正有价值的地方:不是把数组写得很长,而是让新增数据不迫使业务流程增加分支。
七、显示精度是独立策略:科学计数法、有效数字和千分位
单位转换的数值跨度非常大。1 PB 等于 1125899906842624 B,而毫米换千米可能产生很小的小数。全部固定两位小数会把小量直接显示为 0,全部展开又会让结果行溢出。
当前 formatNumber 采用三段策略:
export function formatNumber(value: number): string {
if (!Number.isFinite(value)) return '-';
if (value === 0) return '0';
const abs = Math.abs(value);
if (abs >= 1e15 || abs < 1e-6) {
return value.toExponential(6);
}
let str = value.toPrecision(8);
if (str.indexOf('.') >= 0 && str.indexOf('e') < 0) {
str = str.replace(/0+$/, '').replace(/\.$/, '');
}
const parts = str.split('.');
parts[0] = parts[0].replace(/\B(?=(\d{3})+(?!\d))/g, ',');
return parts.join('.');
}
其规则是:
| 输入范围 | 展示策略 |
|---|---|
NaN、Infinity | - |
| 0 | 0 |
绝对值大于等于 1e15 | 6 位科学计数法 |
绝对值小于 1e-6 | 6 位科学计数法 |
| 其它 | 最多 8 位有效数字并加千分位 |
注意,“8 位有效数字”不是“8 位小数”。1234567.891 会展示为 1,234,567.9,因为整数部分已经占用了多数有效位。这种策略适合通用工具,但不是所有业务的唯一答案。测量、财务或科研应用可能需要用户选择精度、保留不确定度,甚至使用十进制定点库。本文只描述当前工程的真实策略。
八、ArkUI 页面怎样消费引擎,而不把公式塞进组件
ConvertPage.ets 没有自己计算米、英寸或华氏度。页面只持有类目、源单位、输入文本和结果:
@State convertType: ConvertType = 'length';
@State group: UnitGroup = getUnitGroup('length');
@State @Watch('onStateChanged') fromKey: string = '';
@State @Watch('onStateChanged') inputText: string = '1';
@State results: ConversionResult[] = [];
@State displayResults: ConversionResult[] = [];
输入文本或源单位改变时,@Watch 回调触发重算:
onStateChanged(): void {
this.recomputeResults();
}
private recomputeResults(): void {
const value = parseFloat(this.inputText);
this.results = convertAll(
this.group,
this.fromKey,
Number.isFinite(value) ? value : NaN,
);
this.displayResults = this.results.filter(
(r: ConversionResult) => r.unit.key !== this.fromKey,
);
}
这形成了清晰边界:
- ArkUI 页面负责把文本解析为有限数、驱动状态和渲染列表。
UnitData负责声明单位事实。UnitConverter负责数学计算和展示格式。- 历史服务负责持久化摘要,不参与公式。
页面点击结果行时,会把结果的原始 value 重新格式化为可输入字符串,再切换 fromKey。它没有把带逗号的 display 直接填入输入框:
this.fromKey = r.unit.key;
this.inputText = Number.isFinite(r.value)
? formatForInput(r.value)
: '';
这正是计算值和展示值分离带来的收益。与此同时,结果 Text 使用 layoutWeight(1)、constraintSize({ minWidth: 0 })、maxLines(1) 和省略策略,降低长数字破坏手机布局的风险。
九、点击任一结果切换输入单位,为什么仍不构成链式换算
用户可能先输入 1 in,再点击 cm 结果,把厘米设为新的输入单位,然后点击 ft。从交互上看像连续换算,但当前实现保存的是结果对象中的高精度 value,而每次重算仍然重新执行:
current source -> category base -> every target
它不会调用“英寸到厘米的显示字符串”,再调用“厘米到英尺的显示字符串”。因此没有依赖任意中间单位的专属公式,也没有把千分位文本当作输入。
不过 JavaScript/ArkTS 的 number 本质上仍是 IEEE 754 双精度浮点数,不能宣称“绝对无误差”。“避免链式换算误差”准确含义是:
- 避免多份两两公式的常量口径差异。
- 避免每一步展示舍入后再继续计算。
- 把单次转换固定为至多一次进入基准、一次离开基准。
- 让误差可以通过统一容差进行测试。
若业务要求十进制精确,例如货币计费,就应使用明确的最小单位整数或经过评估的高精度方案,而不是把通用单位引擎的 number 结果直接当结算金额。
十、现有 Hypium 用例验证了哪些事实
工程的 entry/src/ohosTest/ets/test/UnitConverter.test.ets 已经覆盖多类代表值:
1 m = 100 cm1 km = 1000 m1 in = 0.0254 m1 kg = 1000 g1 斤 = 0.5 kg100 °C = 212 °F0 °C = 273.15 K1 KB = 1024 B1 h = 3600 s1 m/s = 3.6 km/hconvertAll结果数量与单位数量一致NaN在结果值中继续为NaN,显示为-- 大数和极小数进入科学计数法
浮点断言没有直接比较 ===,而是使用容差:
const EPS = 1e-9;
function nearlyEqual(
a: number,
b: number,
eps: number = EPS,
): boolean {
return Math.abs(a - b) < eps;
}
这是正确方向,因为 0.1 + 0.2 一类浮点结果不适合直接等值断言。但固定绝对误差也有边界:当结果非常大时,1e-9 可能过严;当结果接近零时,相对误差又不稳定。更稳健的测试辅助可以同时考虑绝对误差和相对误差:
function almostEqual(
actual: number,
expected: number,
absTol: number = 1e-9,
relTol: number = 1e-9,
): boolean {
const diff = Math.abs(actual - expected);
const scale = Math.max(Math.abs(actual), Math.abs(expected));
return diff <= Math.max(absTol, relTol * scale);
}
这同样是测试增强建议,不代表当前源码已经使用该函数。
十一、针对“基准单位模型”最值得补的四组测试
现有用例证明了代表性转换,但要专门防链式误差和数据表错误,还可以加入四组性质测试。
第一组是恒等性。每个单位转换到自身,有限输入应近似保持:
for (const unit of group.units) {
const actual = convert(group, unit.key, unit.key, sample);
expect(almostEqual(actual, sample)).assertTrue();
}
第二组是往返性。A -> B -> A 应在容差内回到起点:
const b = convert(group, 'in', 'cm', 123.456);
const a = convert(group, 'cm', 'in', b);
expect(almostEqual(a, 123.456)).assertTrue();
第三组是基准一致性。对任意源目标,直接转换结果应与显式“源到基准、基准到目标”的结果一致。当前生产代码本来就是这样实现,测试的价值在于防止未来优化时绕开规则。
第四组是数据表完整性:
baseKey必须能在units中找到。- 基准线性单位的
factor必须为 1,或函数映射应为恒等。 key不能重复。factor必须是有限正数。- 函数单位必须同时提供两个方向。
这些测试不需要启动页面,执行速度快,非常适合作为提交前的回归门槛。
十二、边界值不能只靠 Number.isFinite
当前引擎对 NaN 与无穷值有明确处理,但业务边界还要按类目决定。
温度方面,开尔文理论上不应低于 0 K。当前定义会正常把负开尔文换成摄氏度,这是数学函数允许、物理语义不合理的输入。是否拦截应由业务校验层决定,不应偷偷夹在通用 fromBase 中,否则同一引擎难以复用。
时间方面,“月(30天)”和“年(365天)”是工程中明确写出的约定,不是自然月与公历年的精确换算。页面或帮助文案需要保留这个限定,不能宣传为日期计算。
数据存储方面,当前采用二进制口径 1 KB = 1024 B。这与十进制 SI 的 1 kB = 1000 B 不是同一标准。项目已经在注释和测试中固定 1024,后续如果支持两种口径,应拆成不同单位或模式,不能静默改变现有常量。
面积里的亩使用循环小数近似,速度中的节也使用有限小数常量。这些都说明“统一基准”解决的是架构一致性,不会自动提高来源常量的权威性。发布前仍需为每个换算因子建立来源、精度和变更记录。
十三、性能优化重点不在乘除法,而在状态与渲染
九个单位做十几次浮点运算几乎不是性能瓶颈。换算页面更值得关注的是输入期间的状态更新和列表重组。
当前代码已经做了两件有效的事:
convertAll只计算一次基准值。ForEach的 key 带上unit.key与
`display`,输入变化时确保结果文本刷新。
第二点是一种明确的正确性选择:
ForEach(
this.displayResults,
(r: ConversionResult, index: number) => {
this.ResultRow(r, index === this.displayResults.length - 1);
},
(r: ConversionResult) => `${r.unit.key}:${r.display}`,
)
它会让显示值变化时节点 key 变化,从而重新生成节点,避免旧文本复用。但如果单位很多、输入频率极高,这也会增加重建成本。当前数据规模很小,正确刷新比微小的节点复用收益更重要。以后若做更大列表,应先用真实性能工具观察,再决定是否改为稳定 key 并调整状态传递,不能只凭“key 应稳定”的通用经验机械重构。
还要注意 TextInput 使用 InputType.NUMBER_DECIMAL 不等于所有输入都天然合法。负号、科学计数法、不同输入法行为仍需真机确认。页面现在用 parseFloat 与 Number.isFinite 做最终门槛,这比依赖键盘类型可靠,但 parseFloat('12abc') 会得到 12;若允许粘贴任意文本,后续可采用完整字符串校验。
十四、从真实源码提炼出的可复用实现清单
把这一套方案迁移到另一个 HarmonyOS 5.0+ ArkTS 项目时,可以按以下顺序落地:
- 为每个类目选择一个稳定、易理解的基准单位。
- 定义
Unit和UnitGroup,把身份、展示和数学规则分开。 - 线性单位只保存到基准的单向
factor。 - 非线性单位成对提供
toBase/fromBase。 - 核心引擎只返回原始
number,不提前舍入。 - 一对多场景先计算一次基准值,再遍历目标单位。
- 展示格式单独实现,并明确科学计数法阈值和有效数字。
- ArkUI 页面只管理输入、选择和结果状态,不复制换算公式。
- 用
layoutWeight、最小宽度约束和溢出策略承接长结果。 - 用 Hypium 覆盖代表值、非法值、恒等性、往返性和数据表完整性。
这份清单的核心不是“所有转换都乘除一次”,而是建立一个稳定契约:数据负责事实,算子负责数学,页面负责交互,测试负责证明。
十五、把基准模型落成六组可执行断言
基准单位模型解决的是公式组织和路径一致性,不是浮点数天然无误差。要验证引擎,至少同时观察输入 value、源单位定义、base 中间值、目标 raw value、display 与页面回填值。只断言“1 米等于 100 厘米”只能覆盖一个样例,无法证明单位表结构、非线性函数、错误分支和极端数量级都遵守同一契约。
第一组是 UnitGroup 结构校验。每个 group 的 baseKey 必须能在 units 中找到,单位 key 必须唯一;线性单位的 factor 应为有限非零值,基准单位通常应为 1;非线性单位需要同时提供 toBase 与 fromBase。当前 toBase 和 fromBase 会在既没有函数也没有 factor 时抛错,但 getUnitGroup 返回数据时没有集中执行完整模式校验。建议在开发期启动检查或单元测试中遍历全部组,尽早发现重复 key、缺失定义和错误 baseKey。这是建议实现,不是当前运行时已有保护。
第二组是规模与路径。假设一个类目有 n 个单位,直接为每一对方向维护公式,最多需要 n×(n-1) 个有向关系;基准模型只要求每个单位说明如何到达同一个 base,再由统一引擎组合。测试可以遍历每个 source 和 target,确认 convert 总是执行 source → base → target,而不是读取某个目标的 display 继续计算。这里的收益是减少公式数量与链式舍入机会,不是消除两次浮点运算产生的舍入。
第三组是往返。对每个组、每个源单位 A 和目标单位 B,执行 A → B → A,并将最后的 raw number 与原始值比较。样本至少包括 0、1、负数、普通小数、大值和小值。比较应采用绝对误差与相对误差组合,例如 abs(a-b) <= absTol + relTol * max(abs(a), abs(b)),避免固定 1e-9 在不同数量级上过严或过宽。display 只能单独测试格式,不能参与往返,否则千分位、八位有效数字或科学计数法会把展示舍入误当成计算误差。
第四组是非线性单位。温度组以摄氏度为 base,华氏度执行减 32 再乘 5/9,开尔文执行减 273.15;反向函数再从摄氏度恢复目标值。现有用例覆盖 100°C ↔︎ 212°F 与 0°C → 273.15K,但还应覆盖负温、F → K、K → F 和全单位往返。当前引擎只负责数学转换,没有限制低于绝对零度的输入;是否拒绝这类值属于业务校验,应在页面或领域服务中明确,不能假装纯算子已经处理。
第五组是失败与极端数值。未知 fromKey 或 toKey 会由 findUnit 抛错;非有限入口由 convert 返回 NaN;convertAll 在 base 非有限时为每个目标生成 NaN,并由格式化层显示 -。还要构造缺失 factor 和函数的测试 Unit、factor 为零的非法定义,以及乘法溢出、除法溢出和下溢。正式实现可选择抛出结构化错误或返回带状态结果,但不能让“找不到单位”“非法输入”“计算溢出”最终都只剩同一个横线而无法诊断。
第六组是页面消费。ConvertPage 调用 convertAll 后过滤当前源单位,列表读取 display;点击结果行则取 r.value,经 formatForInput 写回并把该单位设为新的 fromKey。因此新的换算仍从原始数值和新源单位出发,不是目标列表之间的连续换算。验收时应连续点击多个结果行,分别记录 fromKey、inputText、base 与最终 raw value,确认误差没有来自旧展示串。长结果被省略时还要验证复制、回填和历史摘要的内容边界。
本轮只核对 UnitData、UnitConverter、ConvertPage 与 UnitConverter.test 的静态源码,没有执行 Hypium、项目构建、模拟器、真机、极端值脚本或性能采样。测试文件存在常见线性、温度、二进制数据、NaN 与格式化断言,只能作为历史源码证据,不能描述为本轮已经通过。正式验收需要保存命令、环境、输入、base、raw value、display、误差和失败日志。
十六、结语:基准单位是架构边界,也是误差治理边界
“万能转换器”的单位引擎没有为 72 对长度关系写 72 条公式。它用 UnitGroup 划分类目,用 factor 表达线性关系,用 toBase/fromBase 接住温度,再由 convert 和 convertAll 统一执行“源单位进入基准、基准离开到目标”的路径。
这套设计避免了两两公式不断扩张,也避免显示舍入结果被反复送回计算链。它不能消灭 IEEE 754 浮点误差,也不能替代换算常量的来源审查,但它把误差发生的位置压缩到少数可测试边界,让新增单位、页面实时刷新和回归验证都更可控。
对 HarmonyOS 工具应用而言,这比堆叠更多单位更重要:用户看到的是一个数字,工程需要交付的是一条可解释、可复核、可扩展的计算路径。
参考资料
- 华为开发者文档:ArkTS 概述
- 华为开发者文档:ArkUI 概述
- 本文核对的真实源码:
entry/src/main/ets/common/UnitData.ets - 本文核对的真实源码:
entry/src/main/ets/common/UnitConverter.ets - 本文核对的真实源码:
entry/src/main/ets/pages/ConvertPage.ets - 本文核对的真实测试:
entry/src/ohosTest/ets/test/UnitConverter.test.ets
更多推荐



所有评论(0)