【万能转换器|05】HarmonyOS ArkTS 默认单位实战:按类别保存用户首选单位

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

HarmonyOS ArkTS 默认单位偏好封面

单位转换工具有一个看似很小、实际很能影响效率的体验问题:用户每次进入长度转换都习惯从“厘米”开始,重量转换习惯用“千克”,数据存储则更常从“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,而不是关系型数据库

默认单位是典型的轻量偏好数据:

  1. 数据量固定且很小,最多八组键值。
  2. 查询方式简单,只按类别取一个字符串。
  3. 不需要排序、联表、分页或统计。
  4. 生命周期跟随应用设置,需要跨启动恢复。

因此 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 不会更新,选中态理论上仍保持旧值。这避免了“界面显示已选中、重启后却消失”的明显假成功。

但失败体验仍不完整:

  1. selectUnit() 的失败分支只有日志。
  2. 页面没有保存中状态。
  3. 芯片没有禁用,连续点击可能启动多个异步写入。
  4. 用户看不到失败原因或重试入口。

这些是基于当前代码可复核出的改进空间,不是已经实现的能力。若补齐,可增加 @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

服务集成测试还应验证:

  1. 修改 length 后,weight 的已有覆盖仍保留。
  2. flush 失败时 AppStorage 不更新。
  3. 重启初始化后能够恢复持久化 JSON。
  4. reset 后 JSON 为空,八类重新使用内置默认。
  5. 初始化未完成时调用 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 可以先提供缺省值。覆盖层模型让新增类别的兼容成本较低。

十九、可复用的默认偏好架构清单

把这套实现迁移到语言、货币展示、日期格式或排序方式时,可以复用以下检查顺序:

  1. 用类型化类别定义偏好作用域。
  2. 页面只提交业务键,不直接操作存储。
  3. Preferences 保存小型、跨启动设置。
  4. 持久化成功后再更新 AppStorage。
  5. 页面用 @StorageProp 订阅共享偏好。
  6. 消费端对持久化值做成员校验。
  7. 内置默认与用户覆盖分离。
  8. 恢复默认清除覆盖层,并提供确认。
  9. 损坏数据回退,但保留可观测日志。
  10. 为初始化失败、写入失败和并发点击设计可见状态。

最重要的不是某个 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 只保留局部交互,转换页负责消费前验证,恢复默认通过清除覆盖层回到内置值。

真实源码也留下了清晰的演进方向:让初始化状态可见、拒绝非法单位键、为写入失败提供用户反馈、增加并发保护与迁移测试。把这些边界说清楚,比简单宣称“支持记住默认单位”更有技术价值,也更利于后续多设备适配和上架审核。

Logo

讨论HarmonyOS开发技术,专注于API与组件、DevEco Studio、测试、元服务和应用上架分发等。

更多推荐