【万能转换器|05】HarmonyOS ArkTS 默认单位实战:按类别保存用户首选单位
【万能转换器|05】HarmonyOS ArkTS 默认单位实战:按类别保存用户首选单位
证据边界:本文基于
D:\huawei\one3(万能转换器)当前源码进行静态核对。“当前事实”来自 SettingsService、DefaultUnitsPage、ConvertPage、EntryAbility 与 UnitData;“历史证据”仅指原草稿及其既有平台记录;“建议实现”和“验收设计”均明确标注。本轮未执行构建、模拟器、真机、故障注入或性能采样。

单位转换工具有一个看似很小、实际很能影响效率的体验问题:用户每次进入长度转换都习惯从“厘米”开始,重量转换习惯用“千克”,数据存储则更常从“KB”输入。如果页面始终回到统一基准单位,用户就要反复切换源单位。所谓“默认单位”,本质不是给某个按钮换一次选中颜色,而是把“单位类别 → 用户首选源单位”保存成跨页面、跨启动可恢复的偏好。
“万能转换器”的真实实现把这条链路拆成四层:DefaultUnitsPage.ets 负责八类单位的选择交互,SettingsService.ets 使用 ArkData Preferences 持久化映射,AppStorage 向 ArkUI 页面广播最新 JSON,ConvertPage.ets 在进入时读取首选值,并在真正采用前确认该单位仍属于当前类别。它没有账号同步、云端配置或多设备分布式同步,本文也不会把这些未实现能力包装成现成功能。
本文面向 HarmonyOS 5.0 及以上版本,围绕真实源码讨论类型化偏好、Preferences 落盘、AppStorage 响应、损坏数据兜底、恢复默认和多设备验收。重点不是“如何画一个设置页”,而是如何让一个小偏好形成可复核的数据闭环。
默认单位的单向数据流
用户选择类别与单位后,SettingsService 合并当前 Map,等待 Preferences 持久化成功,再通过 AppStorage 广播;ConvertPage 最终还会校验单位是否属于当前 UnitGroup。

默认单位偏好的职责边界
设置页负责交互,服务负责解析与落盘,Preferences 和 AppStorage 分别承担跨启动与跨页面状态,转换页结合 UnitGroup 做消费端校验。

一、先定义数据语义:保存的是每个类别的源单位
项目中的默认单位不是单个全局字符串。长度的 m、重量的 kg、温度的 C 属于不同命名空间,必须和类别一起保存。真实服务用 Map<ConvertType, string> 表达这层关系:
// 逻辑形态,不是实际落盘格式
Map {
'length' => 'm',
'weight' => 'kg',
'temperature' => 'C',
'data' => 'KB'
}
这种建模有两个直接收益。第一,用户修改长度默认单位不会覆盖重量偏好;第二,转换页只需要拿自己的 ConvertType 查询,不必理解整个设置页。类型和单位键共同构成偏好契约。
DefaultUnitsPage 明确列出八个受支持的转换类别:
const CATEGORIES: CategoryRow[] = [
{ type: 'length', title: '长度' },
{ type: 'weight', title: '重量' },
{ type: 'area', title: '面积' },
{ type: 'volume', title: '体积' },
{ type: 'temperature', title: '温度' },
{ type: 'time', title: '时间' },
{ type: 'speed', title: '速度' },
{ type: 'data', title: '数据存储' },
];
这里值得注意:页面只覆盖通用单位转换的八类,不包含 BMI、贷款、税费、欧姆定律等实用计算器。后者有独立表单和输入语义,不应被塞进同一份默认单位映射。
二、源码注释写 ActionSheet,真实界面却是行内展开
DefaultUnitsPage.ets 顶部注释描述“点击展开 ActionSheet(半屏)”,但当前组件树没有调用 ActionSheet.show()。用户点击类别行时,页面只是切换 expandedType:
.onClick(() => {
this.expandedType =
(this.expandedType === row.type) ? '' : row.type;
})
随后由声明式条件渲染决定是否插入单位网格:
if (this.expandedType === row.type) {
this.UnitGrid(row.type)
}
所以准确说法是“类别行内展开 + 可换行单位芯片”,而不是半屏 ActionSheet。这类注释漂移很容易进入文章、测试用例和审核说明。技术文档应以真实组件树为准;如果未来真的改成半屏选择器,再同步更新注释和验收项。
当前交互还天然维持“同一时刻最多展开一个类别”:expandedType 只有一个字符串,而不是八个布尔值。再次点击同一类别会折叠,点击其他类别会直接切换目标,状态简单且不会产生多处展开后的长页面失控。
三、页面层只做选择,不直接碰 Preferences
单位芯片由 getUnitGroup(type).units 生成。页面拿到 Unit 后显示名称和符号,并根据当前偏好切换前景色与背景色:
Text(`${u.name} (${u.symbol})`)
.fontColor(this.isCurrent(type, u.key)
? $r('app.color.text_on_brand')
: $r('app.color.text_secondary'))
.backgroundColor(this.isCurrent(type, u.key)
? $r('app.color.brand_primary')
: $r('app.color.bg_input'))
.onClick(() => {
this.selectUnit(type, u.key);
})
这个页面没有调用 preferences.getPreferences(),也没有自己拼接 JSON。点击后只把 type 和 unitKey 交给 SettingsService:
private selectUnit(type: ConvertType, key: string): void {
SettingsService.get().setDefaultUnit(type, key)
.catch((err: Error) => {
console.error(`[DefaultUnits] set failed: ${err.message}`);
});
}
页面与存储之间有明确边界:UI 决定用户选择了什么,服务决定数据如何序列化、何时 flush、怎样广播。将来若存储格式迁移,页面无需跟着改写。
四、为什么使用 Preferences,而不是关系型数据库
默认单位是典型的轻量偏好数据:
- 数据量固定且很小,最多八组键值。
- 查询方式简单,只按类别取一个字符串。
- 不需要排序、联表、分页或统计。
- 生命周期跟随应用设置,需要跨启动恢复。
因此 ArkData Preferences 比关系型数据库更合适。真实服务把主题、字号和默认单位放在同一个名为 app_settings 的 Preferences 实例中:
const PREF_NAME = 'app_settings';
const KEY_DEFAULT_UNITS = 'defaultUnits';
这不代表所有设置都应该塞进一个超大 JSON。当前默认单位是一组紧密相关、整体很小的映射,序列化为一个值是可接受的;如果未来每类偏好出现独立版本、最近使用记录、同步状态或复杂检索,再考虑拆键或引入结构化存储。
五、初始化阶段把持久化值桥接进 AppStorage
SettingsService.init() 在 EntryAbility.onCreate() 中启动。服务先取得 Preferences,再读取主题、字号和默认单位,最后用 AppStorage.setOrCreate() 建立应用级响应状态:
svc.store = await preferences.getPreferences(context, PREF_NAME);
const defaultUnitsJson =
await svc.store.get(KEY_DEFAULT_UNITS, '') as string;
AppStorage.setOrCreate<string>(
APPSTORE_DEFAULT_UNITS,
defaultUnitsJson
);
SettingsService.instance = svc;
这一步把“磁盘中的偏好”变成“ArkUI 可以订阅的状态”。页面不需要每次出现都重新访问 Preferences,也不需要自己维护事件总线。
真实 EntryAbility 以异步调用加 catch 的方式初始化服务:
SettingsService.init(this.context).catch((err: Error) => {
hilog.error(
DOMAIN,
'testTag',
'SettingsService init failed: %{public}s',
err.message
);
});
这里必须区分事实和改进建议:当前代码确实在启动时发起初始化,但 onCreate() 没有等待初始化完成。SettingsService.get() 在实例尚未建立时会抛错。通常用户到达设置页前初始化已经结束,但自动化测试、冷启动直达深链或极慢 I/O 都可能扩大这个时间窗口。更稳妥的产品级方案,是让路由入口等到服务就绪,或让页面显式呈现加载/失败状态,而不是假设初始化总会抢先完成。
六、Map 为什么序列化成二维数组
Preferences 最终保存的是字符串,而 ArkTS 的严格类型规则也不鼓励随意构造动态属性对象。真实实现把 Map 序列化为二维数组:
[
["length", "cm"],
["weight", "kg"],
["data", "KB"]
]
序列化函数遍历 Map,把每个条目放进 Array<Array<string>>:
function serializeDefaultUnits(
map: Map<ConvertType, string>
): string {
const arr: Array<Array<string>> = [];
map.forEach((v: string, k: ConvertType) => {
arr.push([k, v]);
});
return JSON.stringify(arr);
}
这种格式没有依赖对象的动态键,也保留了“键和值都为字符串”的清晰约束。它不追求可读性最大化,而是优先保证 ArkTS 类型和 JSON 存储之间的转换简单、稳定。
七、解析失败为什么返回空 Map,而不是让页面崩溃
parseDefaultUnits() 对空字符串、非法 JSON、非数组结构都采取容错策略:返回空 Map。
export function parseDefaultUnits(
json: string
): Map<ConvertType, string> {
const map = new Map<ConvertType, string>();
if (!json) return map;
try {
const arr = JSON.parse(json) as Array<Array<string>>;
if (Array.isArray(arr)) {
for (const pair of arr) {
if (
Array.isArray(pair) &&
pair.length >= 2
) {
const k = pair[0];
const v = pair[1];
if (
typeof k === 'string' &&
typeof v === 'string' &&
v.length > 0
) {
map.set(k as ConvertType, v);
}
}
}
}
} catch (e) {
// 返回空 map,后续走内置默认值
}
return map;
}
对偏好设置来说,“回退到内置默认值”通常比“启动或页面崩溃”更合理。损坏数据不会直接进入换算公式,而是被空 Map 截断,defaultUnitOf() 再提供默认值。
不过当前解析只校验“两个元素都是字符串且值非空”,并未验证类别一定属于 ConvertType,也未确认单位键属于对应 UnitGroup。as ConvertType 只是编译期断言,不是运行时校验。现有页面写入来源受控,消费端也有二次验证,但如果未来增加导入、云同步或版本迁移,服务层应加入类别白名单与单位成员校验。
八、写入顺序是先持久化,再广播 UI
setDefaultUnit() 的真实顺序很关键:
async setDefaultUnit(
type: ConvertType,
unitKey: string
): Promise<void> {
if (!this.store) return;
const current = parseDefaultUnits(
AppStorage.get<string>(APPSTORE_DEFAULT_UNITS) ?? ''
);
current.set(type, unitKey);
const json = serializeDefaultUnits(current);
await this.store.put(KEY_DEFAULT_UNITS, json);
await this.store.flush();
AppStorage.set<string>(APPSTORE_DEFAULT_UNITS, json);
}
服务先基于当前 AppStorage 恢复 Map,只替换一个类别,再 put + flush,最后更新 AppStorage。这样页面看见新选中态时,数据已经完成落盘。若先广播、后 flush,写盘失败会让界面短暂显示一个无法跨启动保存的成功状态。
“按类别保存”也体现在合并策略里:current.set(type, unitKey) 只改一个条目,其他类别仍留在 Map 中。长度从米切到厘米时,不会清掉温度的摄氏度或数据存储的 KB。
需要诚实指出当前边界:当 store 为空时,方法直接 return,Promise 会以成功状态完成,但没有真正保存。结合初始化时序,这种静默返回不利于诊断。更严格的实现可以在未初始化时抛出明确错误,或暴露统一的 ready Promise,让调用方不可能把“未执行”误判为“保存成功”。
九、@StorageProp 让选中态跟随服务广播
设置页通过常量键订阅 AppStorage:
@StorageProp(APPSTORE_DEFAULT_UNITS)
defaultUnitsJson: string = '';
isCurrent() 每次用当前 JSON 查询该类别的有效默认键:
private isCurrent(
type: ConvertType,
key: string
): boolean {
return defaultUnitOf(
type,
this.defaultUnitsJson
) === key;
}
当服务完成 flush 并调用 AppStorage.set(),@StorageProp 收到新值,ArkUI 重新计算芯片颜色和行尾名称。页面不需要手工执行 this.selectedKey = key,也不会维护第二份容易漂移的选中状态。
这里的状态分工很清楚:
expandedType是页面临时交互状态,使用@State。defaultUnitsJson是跨页面共享偏好投影,使用@StorageProp。- Preferences 是跨启动持久化真源,由服务管理。
这种分层比“所有东西都放 AppStorage”更稳。展开哪一行不值得持久化,也不应影响其他页面。
十、内置默认值不等于换算基准单位
服务内置八类默认源单位:
const FALLBACK_DEFAULT_UNIT =
new Map<string, string>([
['length', 'm'],
['weight', 'kg'],
['area', 'm2'],
['volume', 'L'],
['temperature', 'C'],
['time', 's'],
['speed', 'mps'],
['data', 'KB'],
]);
前七类与 UnitData 中各组的 baseKey 一致,而数据存储是一个有意值得关注的例外:UnitData 的基准键是 B,服务默认源单位却是 KB。基准单位服务于换算公式,默认源单位服务于用户进入页面时的便利,两者不必强行相同。
这也是为什么不能把“默认单位”直接写死成 group.baseKey。如果产品认为 KB 比 B 更常用,就应该允许默认偏好与内部换算基准分离。
defaultUnitOf() 的优先级是“用户自定义优先,否则服务 fallback”:
export function defaultUnitOf(
type: ConvertType,
json: string
): string {
const map = parseDefaultUnits(json);
const u = map.get(type);
if (u && u.length > 0) return u;
return FALLBACK_DEFAULT_UNIT.get(type) ?? '';
}
十一、转换页采用偏好前还有一道存在性校验
仅从 JSON 读出字符串还不够。单位列表可能在新版本中调整,旧数据也可能被破坏。ConvertPage.aboutToAppear() 会确认首选键仍在当前组中:
this.group = getUnitGroup(type);
const preferred = defaultUnitOf(
type,
this.defaultUnitsJson
);
const exists = this.group.units.find(
(u: Unit) => u.key === preferred
);
this.fromKey = exists
? preferred
: this.group.baseKey;
这是很重要的消费端防线。即使 Preferences 中出现 ["length", "not-exist"],转换页也不会把不存在的键交给后续换算,而是退回该组 baseKey。
同时要看到设置页的表现差异:currentLabel() 找不到单位时返回 -,而 isCurrent() 不会选中任何合法芯片。也就是说,损坏值不会被悄悄显示成某个错误单位,但用户可能看到行尾短横线。若要进一步提升自愈能力,可以在解析或读取时清理无效条目,并把修正后的映射重新持久化。
十二、恢复默认不是写回八组值,而是清空覆盖层
页面的“恢复默认”先显示 AlertDialog,避免误触直接清除偏好。用户确认后,服务把 Preferences 和 AppStorage 都设为空字符串:
async resetDefaultUnits(): Promise<void> {
if (!this.store) return;
await this.store.put(KEY_DEFAULT_UNITS, '');
await this.store.flush();
AppStorage.set<string>(
APPSTORE_DEFAULT_UNITS,
''
);
}
这是一种“默认值 + 用户覆盖层”模型。内置默认值保留在代码中,存储只记录用户覆盖。恢复默认只需删除覆盖层,不必复制八组默认值。
页面在 Promise 成功后才提示:
SettingsService.get()
.resetDefaultUnits()
.then(() => {
promptAction.showToast({
message: '已恢复默认',
duration: 1500
});
})
确认弹窗、落盘完成、成功 Toast 的顺序是合理的。当前失败分支只写 console.error,没有用户可见错误提示;因此不能把“恢复失败可重试”写成现有能力。产品级增强可以在失败时保留当前选择并展示“恢复失败,请重试”,同时防止连续点击产生并发写入。
十三、选择失败时,界面为什么不会先产生假成功
单位选择没有单独显示 Toast。用户主要通过芯片颜色变化确认结果。由于服务是先 flush 再 AppStorage.set(),写入失败时共享 JSON 不会更新,选中态理论上仍保持旧值。这避免了“界面显示已选中、重启后却消失”的明显假成功。
但失败体验仍不完整:
selectUnit()的失败分支只有日志。- 页面没有保存中状态。
- 芯片没有禁用,连续点击可能启动多个异步写入。
- 用户看不到失败原因或重试入口。
这些是基于当前代码可复核出的改进空间,不是已经实现的能力。若补齐,可增加 @State savingType,写入期间禁用对应类别芯片,成功后由 AppStorage 驱动选中态,失败时显示 Toast,并始终在 finally 中恢复交互。
十四、运行时校验应该放在服务边界
当前页面传入的单位来自 getUnitGroup(type).units,正常交互不会构造非法键;转换页消费时也有存在性兜底。因此现有链路对普通用户是可控的。
但服务 API 本身接受任意 unitKey: string:
async setDefaultUnit(
type: ConvertType,
unitKey: string
): Promise<void>
如果未来别的页面、导入功能或测试工具直接调用服务,非法键仍可能写入。推荐把不变量集中在服务边界,而不是依赖每个调用者自律:
function ensureUnitBelongsToType(
type: ConvertType,
unitKey: string
): void {
const exists = getUnitGroup(type).units
.some((unit: Unit) => unit.key === unitKey);
if (!exists) {
throw new Error(
`Invalid unit ${unitKey} for ${type}`
);
}
}
这段是演进建议,并非当前源码。它的价值在于让写入、导入、迁移都共享一条规则,减少无效偏好进入持久化层。
十五、性能关键点:不要在每次重组时反复读磁盘
设置页的状态更新走 AppStorage,currentLabel() 和 isCurrent() 解析的是内存字符串,而不是每个芯片都查询 Preferences。一次选择只执行一次 put + flush,页面重组不触发磁盘 I/O。
当前映射最多八项,反复 JSON.parse() 的成本很小,优先保持代码清楚即可。如果未来类别增长到数百项,或者同一帧大量组件都调用 defaultUnitOf(),可以把解析后的 Map 缓存在服务中,再向 UI 暴露更窄的读取接口。但在目前规模下,为八组偏好引入复杂缓存反而会增加一致性负担。
另一个容易误解的点是 @StorageProp:它提供响应更新,不代表 Preferences 自动持久化。真正的持久化仍发生在 SettingsService 的 put() 和 flush()。文章、代码评审和测试应分别检查“当前会话同步”和“重启后恢复”,不能把二者当成一件事。
十六、针对这条链路最值得写的测试
项目当前搜索不到针对 SettingsService、parseDefaultUnits 或 defaultUnitOf 的专门测试。对于这类小而关键的偏好链路,测试不必从大规模 UI 自动化开始,先覆盖纯函数和边界更划算。
建议的纯函数用例如下:
用例 1:空字符串
输入:''
期望:空 Map,length 返回 m
用例 2:合法二维数组
输入:[['length','cm'],['data','MB']]
期望:length=cm,data=MB
用例 3:非法 JSON
输入:'{broken'
期望:不抛异常,回退内置默认
用例 4:空 unitKey
输入:[['weight','']]
期望:忽略该条,weight 返回 kg
用例 5:未知单位键
输入:[['length','unknown']]
期望:服务增强后拒绝;现有 ConvertPage 消费时退回 baseKey
服务集成测试还应验证:
- 修改 length 后,weight 的已有覆盖仍保留。
- flush 失败时 AppStorage 不更新。
- 重启初始化后能够恢复持久化 JSON。
- reset 后 JSON 为空,八类重新使用内置默认。
- 初始化未完成时调用
get()的行为有明确预期。
UI 测试则关注类别展开、芯片选中、长名称换行、恢复默认确认、返回后再进入转换页,以及屏幕旋转或窗口缩放后控件是否仍可达。
十七、多设备与审核验收不能只看手机竖屏
真实设置页使用根容器全尺寸、内部 Scroll、单位区域 FlexWrap.Wrap,这些设计对小窗和宽屏都有帮助。单位名称如“千米每小时 (km/h)”或“液体盎司 (US)”可能较长,芯片通过内容宽度和换行容器适应,而不是固定成容易截断的列。
面向 HarmonyOS 5.0+ 的多设备验收至少要覆盖:
手机竖屏:八类可滚动,恢复默认可达
手机横屏/小窗:长单位芯片不越界、不遮挡
平板横屏:内容不过度拉伸,点击目标仍清晰
2in1 窗口缩放:展开与折叠不导致布局跳出可视区
深色模式:选中芯片文字与品牌背景保持可读
大字体:类别名、当前单位、箭头不互相挤压
系统返回:CommonNavBar 返回和系统返回行为一致
当前滚动内容底部 padding 为 24vp。在有系统手势区或底部导航避让要求的设备上,应实机检查“恢复默认”是否留有足够安全距离;如果目标规范要求至少 28vp 或动态避让区,就应使用系统安全区数据修正,而不是仅凭模拟器截图判断。
十八、隐私、迁移与版本演进
从本文核验的源码看,默认单位保存在本地 Preferences,内容只是类别和单位键,不涉及账号、联系人、位置或支付数据。文章不能据此推断整个应用绝对没有网络能力,但这条功能本身不需要新增敏感权限,也不需要上传用户偏好。
版本演进时,最需要防的是单位键变更。例如把 kmph 改成 km_h,旧 Preferences 仍保存旧键。当前 ConvertPage 会安全回退到 baseKey,但用户偏好会丢失。更好的迁移方式是在服务初始化时识别旧键、转换成新键、完成一次 flush,并记录存储版本:
v1: [["speed","kmph"]]
↓ migration
v2: [["speed","km_h"]]
同样,若删除某个类别,应清理对应条目;若新增类别,不必立刻写盘,FALLBACK_DEFAULT_UNIT 可以先提供缺省值。覆盖层模型让新增类别的兼容成本较低。
十九、可复用的默认偏好架构清单
把这套实现迁移到语言、货币展示、日期格式或排序方式时,可以复用以下检查顺序:
- 用类型化类别定义偏好作用域。
- 页面只提交业务键,不直接操作存储。
- Preferences 保存小型、跨启动设置。
- 持久化成功后再更新 AppStorage。
- 页面用
@StorageProp订阅共享偏好。 - 消费端对持久化值做成员校验。
- 内置默认与用户覆盖分离。
- 恢复默认清除覆盖层,并提供确认。
- 损坏数据回退,但保留可观测日志。
- 为初始化失败、写入失败和并发点击设计可见状态。
最重要的不是某个 API 名称,而是保持单向数据流:用户操作进入服务,服务落盘后广播,页面根据共享状态重组,业务页面验证后消费。只有这样,“默认设置”才不只是当前页面的一次视觉变化。
二十、把“保存偏好”拆成四个运行时检查
静态源码能够证明接口、键名、调用顺序和回退分支存在,却不能自动证明目标设备上的每一次操作都成功。默认单位链路至少涉及设置页局部状态、AppStorage 中的 JSON、Preferences 文件以及转换页最终采用的 fromKey。运行时验收要同时观察这四处状态,不能只看芯片换了颜色就宣布完成。
第一项是类别和单位键校验。为 length 依次提交 m、cm 和不存在的 unknown,正常键应写入并在重新进入页面后恢复;非法键在当前实现中仍可能进入 Preferences,因为 setDefaultUnit 只更新 Map,并未查询 UnitGroup。ConvertPage 会在消费时发现 unknown 不属于当前 units,随后回退 baseKey,所以页面通常不会崩溃,但无效数据依然残留。这说明“消费端安全回退”与“存储数据有效”是两件事。建议实现是在 SettingsService 接收请求时调用 getUnitGroup(type),确认 unitKey 属于该类别后再写入;迁移旧数据时也复用同一校验器。
第二项是失败提交顺序。将 Preferences 的 put 或 flush 替换为可控失败,预期 AppStorage 仍保持旧 JSON,设置页选中态不应提前变化。当前 setDefaultUnit 的顺序是读取 AppStorage、构造新 Map、put、flush、最后 AppStorage.set,因此静态路径符合“持久化成功后再广播”。不过页面 catch 只记录 console.error,没有失败提示。正式产品应增加可见反馈和重复点击保护,并记录失败后再次进入页面、杀进程重启后的实际值,避免把日志存在误当成用户知道失败。
第三项是初始化时序。EntryAbility.onCreate 调用 SettingsService.init,但没有 await 阻塞后续窗口加载;SettingsService.get 在实例未创建时会抛出异常。多数设备上 Preferences 初始化可能很快,这仍不是时序契约。测试应通过延迟注入让初始化明显变慢,检查用户立即点击默认单位入口时是否出现崩溃、空白或不可恢复状态。建议实现可以在应用级暴露 initializing、ready、error 三态,由路由入口在 ready 后开放交互,并提供重试,而不是依赖“通常来得及”。
第四项是恢复默认和版本迁移。恢复默认当前写入空字符串,相当于删除用户覆盖层,八类重新读取 FALLBACK_DEFAULT_UNIT;它不是把八组缺省值逐条写回。验收时应先为至少两个类别设置非默认值,确认取消对话框不修改数据,再确认执行恢复后 AppStorage 为空、页面显示缺省值、重启后结果一致。随后模拟旧版本单位键,例如速度键被重命名,检查旧键是否被识别、转换、重新 flush,并记录存储版本。仅依赖 ConvertPage 回退虽然能保住页面可用性,却会悄悄丢掉用户选择。
本轮没有执行项目构建、模拟器、真机、故障注入或性能采样,因此上述内容属于依据当前源码制定的测试设计与改进建议,不是已经通过的运行结果。正式验收记录应包含初始 Preferences、操作步骤、预期 JSON、实际 JSON、AppStorage 值、转换页 fromKey、重启结果和设备形态。把这些证据放在一起,才能证明“按类别记住默认单位”真正形成了跨页面、跨启动且可恢复的数据闭环。
二十一、结语:小偏好也要有完整数据闭环
“万能转换器”的默认单位功能没有复杂算法,却把 HarmonyOS 应用中常见的几个工程问题放在了一条短链路里:Preferences 负责跨启动持久化,AppStorage 负责跨页面响应,@State 只保留局部交互,转换页负责消费前验证,恢复默认通过清除覆盖层回到内置值。
真实源码也留下了清晰的演进方向:让初始化状态可见、拒绝非法单位键、为写入失败提供用户反馈、增加并发保护与迁移测试。把这些边界说清楚,比简单宣称“支持记住默认单位”更有技术价值,也更利于后续多设备适配和上架审核。
更多推荐



所有评论(0)