【万能转换器|07】HarmonyOS ArkTS 收藏工具实战:同步首页、工具页和收藏列表

证据边界:本文基于 D:\huawei\one3(万能转换器) 当前源码做静态核对。“当前事实”来自 FavoriteToolsService、EntryAbility、HomePage、ToolsPage、FavoriteToolsPage 与 ToolsData;“建议实现”和“验收方法”均明确标注。本轮未执行构建、真机、模拟器、故障注入或性能采样。

ArkTS 收藏工具同步封面

收藏工具最容易出现的故障,不是“星标画得不好看”,而是三个页面各自维护一份布尔状态:用户在首页收藏长度转换,工具页仍显示空心星;切到收藏 Tab 看不到新项目;从收藏页取消后,返回首页又重新亮起。根因不是 ArkUI 不会刷新,而是应用没有明确谁才是收藏状态的唯一来源。

“万能转换器”的真实实现只持久化工具 key 集合。FavoriteToolsService.ets 用 ArkData Preferences 保存 JSON 数组,写入成功后通过 AppStorage 的 favoriteTools 键广播;HomePage.ets、ToolsPage.ets 和 FavoriteToolsPage.ets 都用 @StorageProp('favoriteTools') 读取同一字符串,再投影为星标或收藏网格。任一入口切换一次,三个页面都从同一状态重组。

本文面向 HarmonyOS 5.0 及以上版本,基于真实源码解释 Set 去重、Preferences 持久化、AppStorage 响应、事件冒泡阻断、废弃 key 过滤和页面跳转,同时指出并发点击、无效 key、重复解析、错误反馈和多设备四列网格的真实边界。不会把账号同步、云收藏、跨设备漫游或平台收藏量写成现有能力。

收藏切换的真实数据流

星标点击只提交稳定 key。服务完成 Preferences 写入与 flush 后才更新 AppStorage,随后首页、工具页和收藏页从同一个共享值重算视图。

收藏切换的数据流

收藏工具的职责分层

页面负责交互与投影,服务负责读改写,Preferences 保存跨启动偏好,AppStorage 负责广播,ToolsData 则把收藏 key 还原为当前工具元数据。

收藏工具的职责分层

一、先分清两种“收藏”:工具收藏不等于历史收藏

项目中存在两种名字相近但语义不同的收藏:

工具收藏:
  FavoriteToolsService
  保存工具 key
  展示在独立“收藏”Tab
历史收藏:
  HistoryService.toggleFavorite
  修改 HistoryItem.favorite
  展示在记录页“收藏”子 Tab

本文讨论的是第一种:收藏一个工具入口,例如长度、BMI、角度计算。它不会收藏某一次“1 米换算成厘米”的结果。

把两种收藏拆开是正确的领域建模。工具收藏的身份是稳定工具 key;历史收藏的身份是 HistoryItem ID。若强行共用一个布尔字段或同一份列表,就无法清楚回答“收藏的是入口还是一次计算结果”。

二、工具收藏最小模型为什么只需要 Set<string>

FavoriteToolsService 不保存完整工具标题、图标和路由参数,只保存 key:

Set<string> {
  'length',
  'bmi',
  'angle'
}

工具的标题、图标、背景和路由仍由 ToolsData、HomeData 等静态目录管理。收藏只表达“这个 key 是否属于用户集合”。

最小化持久化模型有三个好处:

  1. 工具标题改名时不需要迁移收藏数据。
  2. 图标或颜色升级时收藏页自动使用新目录配置。
  3. Set 天然去重,同一个 key 不会出现两次。

代价是 key 必须稳定。已发布版本一旦把 length 改成 len,旧收藏就找不到对应工具。版本演进时必须提供 key 迁移,不能把展示名称当身份。

三、三页面同步的核心是单一 AppStorage 键

服务导出收藏状态键:

export const APPSTORE_FAVORITES =
  'favoriteTools';

三个页面都订阅同一个字面量:

@StorageProp('favoriteTools')
favoritesJson: string = '';

为什么页面源码没有统一写 @StorageProp(APPSTORE_FAVORITES)?项目注释给出了实际约束:装饰器要求 key 是字面量,所以页面直接使用 'favoriteTools'。

数据流不是页面互相通知:

HomePage ─┐
ToolsPage ├─ toggle(key) → FavoriteToolsService
Favorites┘                       ↓
                         Preferences flush
                                ↓
                     AppStorage.set(JSON)
                                ↓
              三个 @StorageProp 页面重新计算

首页不知道收藏页是否存在,工具页也不需要持有收藏页实例。共享状态替代了页面间直接耦合。

四、启动时先恢复 Preferences,再发布服务单例

FavoriteToolsService.init() 在 EntryAbility.onCreate() 中启动。服务取得名为 app_favorites 的 Preferences,读取 favoriteList:

const PREF_NAME = 'app_favorites';
const KEY_FAV_LIST = 'favoriteList';
svc.store = await preferences.getPreferences(
  context,
  PREF_NAME
);
const json = await svc.store.get(
  KEY_FAV_LIST,
  ''
) as string;
AppStorage.setOrCreate<string>(
  APPSTORE_FAVORITES,
  json
);
FavoriteToolsService.instance = svc;

持久化值先进入 AppStorage,随后服务实例可由页面取得。get() 在未初始化时会抛出明确错误:

if (!FavoriteToolsService.instance) {
  throw new Error(
    'FavoriteToolsService not initialized; ' +
    'call FavoriteToolsService.init(context) ' +
    'in EntryAbility.onCreate'
  );
}

页面调用处用同步 try/catch 捕获“服务尚未就绪”,再用 Promise .catch() 捕获写入失败。这反映了两个不同错误边界。

真实 EntryAbility 发起异步初始化但没有等待完成。普通启动通常来得及,但冷启动直达、自动化测试或慢 I/O 仍可能撞上窗口。更完善的架构应提供 ready 状态或初始化屏障,而不是把日志当成用户体验。

五、JSON 数组如何恢复成去重 Set

Preferences 保存字符串,真实解析函数把 JSON 数组恢复成 Set:

export function parseFavorites(
  json: string
): Set<string> {
  const set = new Set<string>();
  if (!json) return set;
  try {
    const arr = JSON.parse(json) as Array<string>;
    if (Array.isArray(arr)) {
      for (const k of arr) {
        if (
          typeof k === 'string' &&
          k.length > 0
        ) {
          set.add(k);
        }
      }
    }
  } catch (e) {
    // 返回空 set
  }
  return set;
}

即使存储数组里重复出现 "length",Set 也只保留一份。空字符串、非法 JSON、非数组结构都安全回退为空集合,不会让首页因为收藏损坏而崩溃。

序列化则遍历 Set,生成字符串数组:

function serializeFavorites(
  set: Set<string>
): string {
  const arr: Array<string> = [];
  set.forEach((k: string) => {
    arr.push(k);
  });
  return JSON.stringify(arr);
}

Set 保留插入顺序,所以收藏页通常按用户第一次收藏的先后展示;取消后再次收藏会把 key 加到末尾。源码没有按标题、类别或最近收藏时间排序,文章不能虚构“智能排序”。

六、一次 toggle 的真实顺序

核心方法先从 AppStorage 读取当前 JSON,再切换 Set 成员:

async toggle(key: string): Promise<boolean> {
  if (!this.store) return false;
  const cur = parseFavorites(
    AppStorage.get<string>(
      APPSTORE_FAVORITES
    ) ?? ''
  );
  let nowFav: boolean;
  if (cur.has(key)) {
    cur.delete(key);
    nowFav = false;
  } else {
    cur.add(key);
    nowFav = true;
  }
  const json = serializeFavorites(cur);
  await this.store.put(KEY_FAV_LIST, json);
  await this.store.flush();
  AppStorage.set<string>(
    APPSTORE_FAVORITES,
    json
  );
  return nowFav;
}

顺序是“计算下一状态 → Preferences put → flush → AppStorage 广播”。这比先点亮星标、再异步保存更一致:页面看到新 JSON 时,偏好已经落盘。

方法还返回切换后的布尔值,但当前 HomePage、ToolsPage、FavoriteToolsPage 调用者没有使用返回值。视觉状态完全由 AppStorage 驱动,而不是调用者手工赋值。

七、为什么页面不应该再维护 selectedKeys

首页的星标判断直接从共享 JSON 得到:

Image(
  parseFavorites(this.favoritesJson)
    .has(item.key)
    ? $r('app.media.ic_tab_favorite_filled')
    : $r('app.media.ic_tab_favorite')
)

工具页使用完全相同的规则。收藏页则把同一 JSON 投影成工具数组。

如果每个页面再增加:

@State selectedKeys: string[] = [];

就会形成第二真源。页面切换、返回栈恢复、服务写入失败时,这份局部数组都可能与 AppStorage 不一致。当前实现没有这样做,选中态始终从 favoritesJson 推导,这是同步能成立的关键。

@StorageProp 在这里适合“服务写、页面读”的模式。页面本身不直接修改 JSON,而是调用 Service 完成持久化。

八、星标点击为什么要阻断外层工具点击

首页和工具页的每个卡片同时有两个交互:

  1. 点击卡片主体,进入工具。
  2. 点击右上角星标,切换收藏。

星标显式设置:

.hitTestBehavior(HitTestMode.Block)
.onClick(() => {
  this.toggleFavorite(item.key);
})

外层卡片还有:

.onClick(() => {
  this.handleTap(item);
})

HitTestMode.Block 用来阻断事件继续命中外层,避免用户想收藏却被同时导航到详情页。收藏页里的填充星也采用同样模式,点击星标只取消收藏,不触发卡片跳转。

这是收藏交互里很容易漏掉的真实细节。只看 Service 会以为数据同步已经完成,但没有事件边界,用户每次点星都会被带走,功能仍然难用。

九、首页和工具页为什么都调用同一个服务

首页:

private toggleFavorite(key: string): void {
  try {
    FavoriteToolsService.get()
      .toggle(key)
      .catch((err: Error) => {
        console.error(
          `[Home] toggleFavorite failed: ${err.message}`
        );
      });
  } catch (e) {
    console.warn(
      `[Home] FavoriteToolsService not ready: ` +
      `${(e as Error).message}`
    );
  }
}

工具页和收藏页只有日志前缀不同。三处都没有自己拼 JSON,也没有直接访问 Preferences。

这种重复是可接受的薄适配:每个页面处理自己的日志上下文,核心规则仍集中在 Service。如果未来补充统一 Toast、节流和 loading 状态,可以抽成共享交互适配器,但不应把业务存储再复制到组件。

十、收藏页不是直接渲染 key,而是做有效工具投影

收藏 JSON 只有 key,页面必须回到工具目录查找实际 GridItem:

static itemsOf(
  favoritesJson: string
): GridItem[] {
  const set = parseFavorites(favoritesJson);
  if (set.size === 0) return [];
  const out: GridItem[] = [];
  set.forEach((k: string) => {
    const it = findToolByKey(k);
    if (it) out.push(it);
  });
  return out;
}

如果旧版本收藏了一个已经删除的工具,findToolByKey(k) 返回空,页面不会渲染坏卡片,也不会在点击时进入未知路由。顶部数量同样基于 itemsOf(),因此只统计当前仍存在的工具。

这是一道消费端防线,但不是持久化自愈:失效 key 仍可能留在 JSON 中,下一次 toggle 会把它继续序列化。更完善的初始化或迁移流程应清理无效 key,并把规范化结果写回 Preferences。

十一、收藏页的空状态来自有效投影

页面判断:

if (
  FavoriteToolsPage
    .itemsOf(this.favoritesJson)
    .length === 0
) {
  this.EmptyState()
}

空状态文案明确告诉用户操作入口:

还没有收藏的工具
在首页或工具页点击工具右上角的 ☆ 即可收藏

即使 JSON 中只有废弃 key,itemsOf() 结果也为空,页面会进入空状态,而不是显示计数 1 却没有卡片。这让 UI 以“当前可用工具”作为展示真相。

真实源码的 Header 注释写“计数 / 全部清空”,但组件只渲染计数,没有清空按钮,也没有调用 FavoriteToolsService.clear()。服务层确实提供 clear(),收藏页当前却不暴露“全部清空”交互。因此不能把注释中的计划能力写成已实现功能。

十二、收藏卡片如何复用真实工具路由

收藏页点击卡片主体时,按工具种类分发:

private handleTap(item: GridItem): void {
  if (
    item.kind === 'convert' &&
    item.convertType
  ) {
    pushConvert(
      item.convertType,
      this.fullTitle(item)
    );
  } else if (
    item.kind === 'calc' &&
    item.calcType
  ) {
    pushCalc(
      item.calcType,
      this.fullTitle(item)
    );
  }
}

网格短标题会在跳转时补全:

if (item.kind === 'convert') {
  return `${item.title}转换`;
}
if (item.kind === 'calc') {
  return `${item.title}计算`;
}

收藏页没有重新维护一套路由表,而是复用 GridItem 中的 kind、convertType、calcType。这样首页、工具页和收藏页进入的是同一套 ConvertPage/CalcPage。

十三、收藏工具页与历史收藏页不能混用

Index.ets 把 FavoriteToolsPage() 作为独立底部 Tab。与此同时,HistoryPage 内还有“收藏”子 Tab,过滤的是:

this.history.filter(
  (x: HistoryItem) => x.favorite
)

两者界面都可能显示星标,但数据源完全不同:

FavoriteToolsPage:
  AppStorage key = favoriteTools
  Preferences = app_favorites
  item identity = tool key
HistoryPage favorite tab:
  AppStorage key = recentHistory
  Preferences = app_history
  item identity = history id

测试和产品文案必须区分“收藏工具”和“收藏记录”。清空历史记录不会清空收藏工具;调用 FavoriteToolsService.clear() 也不会删除历史收藏。

十四、持久化成功后广播,仍需补用户可见失败反馈

三个页面对 toggle 失败都只写 console.error,服务未就绪则写 console.warn。当前没有:

  • 收藏保存中状态。
  • 写入失败 Toast。
  • 点击禁用或防重复。
  • 自动重试。

因此真实能力是“正常写入时三页同步”,不是“失败时可见并可恢复”。若 Preferences flush 失败,AppStorage 不会更新,星标通常保持旧状态;这一点避免了明显假成功。但用户只看到“没有变化”,不知道是点击未命中还是保存失败。

建议让共享交互层处理 savingKeys,失败时显示“收藏失败,请重试”,并保证 finally 恢复按钮。该建议不能冒充现有源码。

十五、快速连续点击存在丢失更新风险

toggle() 每次都从 AppStorage 读取当前 JSON,然后异步 put/flush。服务没有互斥锁或串行队列。

假设初始集合为空,用户极快地收藏 A 和 B:

toggle(A) 读取 {}
toggle(B) 也读取 {}
toggle(A) 计算 {A}
toggle(B) 计算 {B}
最后写入者覆盖前者

最终可能只剩 A 或 B,而不是 {A, B}。同一 key 连续点两次也可能都基于旧集合执行“添加”,不能稳定实现“先收藏再取消”。

普通手动操作通常被 UI 动画和事件节奏拉开,但这不是并发正确性的保证。更稳妥的 Service 应串行执行修改,或维护内存 Set 作为唯一可变状态,并为每次写入排队。测试也要主动模拟未完成 Promise 下的第二次点击。

十六、服务接受任意 key,运行时校验在页面消费端

真实接口是:

async toggle(key: string): Promise<boolean>

它没有确认 key 一定存在于 ALL_TOOLS。HomePage、ToolsPage 和 FavoriteToolsPage 的调用源都来自受控 GridItem,正常用户路径不会提交随机字符串;收藏页消费时还会用 findToolByKey() 过滤。

但服务边界仍允许无效 key 写入。未来若增加导入、快捷卡片、深链或测试工具,错误 key 可能永久占据 JSON。推荐在 Service 写入前调用工具目录验证:

const tool = findToolByKey(key);
if (!tool) {
  throw new Error(
    `Unknown favorite tool key: ${key}`
  );
}

这段是改进建议,不是当前实现。把校验放在 Service 可以保护所有调用入口,而不只保护收藏页展示。

十七、parseFavorites 的重复调用目前可接受,但可优化

首页每个工具卡片在构建星标时都调用一次 parseFavorites(this.favoritesJson);工具页也是如此。收藏页的 build、Header、GridSection 又多次调用 itemsOf(),每次都会 JSON.parse 和目录查找。

当前工具数量有限,收藏 JSON 很短,性能成本通常不高。优先保证实现清楚是合理的。不过在低端设备、频繁重组或工具数量增长后,可以把派生数据集中计算:

private favoriteSet(): Set<string> {
  return parseFavorites(this.favoritesJson);
}
private favoriteItems(): GridItem[] {
  return FavoriteToolsPage.itemsOf(
    this.favoritesJson
  );
}

更进一步,可由 Service 暴露规范化内存 Set,但要避免把可变 Set 直接交给页面,否则引用变化和越权修改又会破坏响应性。

性能优化的目标不是消灭一次 JSON.parse,而是减少同一轮构建中无意义的重复工作,并保持状态来源唯一。

十八、固定四列网格需要多设备实测

收藏页网格写死:

.columnsTemplate('1fr 1fr 1fr 1fr')
.rowsGap(16)
.columnsGap(8)

手机竖屏下四列与首页、工具页视觉一致,图标 52vp、标题单行省略,结构紧凑。但 HarmonyOS 5.0+ 面向小窗、平板和 2in1 时,固定四列不一定是最佳选择:

窄小窗:
  单元格变窄,标题大量省略,星标触点靠近
平板横屏:
  四列单元格过宽,信息密度偏低
大字体:
  单行标题可能只剩极短前缀
鼠标输入:
  星标和卡片主体要有清晰悬停/焦点反馈

更稳妥的多设备方案是根据断点选择 3/4/6 列,或使用自适应网格最小单元宽度。当前源码没有这些断点,文章只能把它列为验收与演进项。

十九、底部 Tab 与滚动安全区也要验收

收藏页位于 Index.ets 的底部 Tab 容器内。页面 Scroll 尾部有 Blank().height(24),Column 还有 bottom padding 12,但没有在这段代码中显式读取系统底部导航/手势避让区。

多设备验收至少覆盖:

  1. 手机竖屏最后一行卡片不被底部 Tab 遮挡。
  2. 系统手势导航下星标仍可点击。
  3. 横屏和小窗滚动到底后保留足够空隙。
  4. 深色模式空心星、填充星、卡片背景对比清晰。
  5. 收藏数量达到多行时滚动稳定。
  6. 取消最后一个收藏后立即进入空状态。
  7. 从收藏页取消后,首页和工具页星标同步变空。

若目标规范要求至少 28vp 或动态系统避让,应使用安全区数据计算,而不是只依赖固定 24+12 的视觉空白。

二十、最值得写的单元与集成测试

当前项目测试目录中没有检索到针对 FavoriteToolsService 的专门测试。这条链路很适合先测纯函数,再测服务顺序。

纯函数用例:

空字符串 → 空 Set
非法 JSON → 空 Set
非数组 JSON → 空 Set
重复 key → Set 去重
空字符串 key → 忽略
混合类型数组 → 只保留非空字符串
isFavoriteOf → 正确判断成员

Service 用例:

空集合 toggle(A) → {A}, 返回 true
{A} toggle(A) → {}, 返回 false
{A} toggle(B) → {A,B}
flush 成功后才更新 AppStorage
flush 失败时 AppStorage 保持旧 JSON
clear 后 Preferences 和 AppStorage 都为空
两个并发 toggle 不应丢失任一更新

页面集成用例:

首页收藏 A → 工具页星标填充
工具页取消 A → 收藏页移除 A
收藏页点星 → 不触发工具跳转
收藏页点卡片 → 进入正确 Convert/Calc 页面
JSON 只有废弃 key → 显示空状态且计数不显示

这些测试直接对应真实数据契约,比只截一张星标亮起的截图更有价值。

二十一、收藏清空能力的真实状态

Service 已经实现:

async clear(): Promise<void> {
  if (!this.store) return;
  await this.store.put(KEY_FAV_LIST, '');
  await this.store.flush();
  AppStorage.set<string>(
    APPSTORE_FAVORITES,
    ''
  );
}

但当前检索到的 FavoriteToolsPage Header 只显示“X 个”,没有可点击清空命令,也没有 AlertDialog。首页和工具页同样只提供逐个 toggle。

所以可以准确说“底层支持清空收藏集合”,不能说“用户可在收藏页一键清空”。如果未来增加按钮,应遵循:

有收藏时才显示
点击后显示不可撤销确认
flush 成功后再显示成功 Toast
失败时保持当前列表并提示重试

收藏清空虽然不像删除用户文档那样高风险,仍属于批量不可逆偏好操作,确认会更稳妥。

二十二、隐私与上架说明

本文核验的工具收藏只在本地 Preferences 保存工具 key 列表,例如 ["length","bmi"]。它没有在这些文件中使用账号、网络、位置、联系人或支付能力。

因此这条功能本身不需要敏感权限,也不应在上架材料中描述为“云收藏”或“多端同步”。隐私说明可以准确写成“收藏的工具入口保存在本地,可通过再次点击星标取消”。

仍需强调:单个服务文件不能证明完整应用绝对没有网络。正式上架要以完整包权限、SDK 和真实行为为准。文章只对当前收藏链路作可复核结论。

二十三、可复用的跨页面收藏清单

将这套模式迁移到常用功能、快捷入口、最近筛选器时,可以复用以下检查:

  1. 用稳定业务 key 做身份,不保存重复展示数据。
  2. Set 负责成员去重。
  3. Preferences 保存小型本地偏好。
  4. 写盘成功后再广播 AppStorage。
  5. 所有页面从同一个 @StorageProp 派生视图。
  6. 星标点击阻断外层导航事件。
  7. 收藏页用真实目录把 key 投影成 UI 模型。
  8. 消费端过滤废弃 key,服务端负责写入校验。
  9. 并发 toggle 必须串行化,避免最后写入覆盖。
  10. 错误要有用户可见反馈。
  11. 固定列数需要按设备断点验收。
  12. 区分工具收藏与历史记录收藏。

这份清单的核心不是“把 Set 存成 JSON”,而是让身份、持久化和响应投影保持同一条单向数据流。

二十四、从静态源码走到运行时验收

到这里可以得到两类结论。第一类是静态源码已经证明的事实:收藏身份是工具 key,跨启动数据落在名为 app_favorites 的 Preferences 中,页面共享值是 AppStorage 的 favoriteTools 字符串,三个页面都从这一个值派生星标或收藏列表。第二类是尚不能只靠阅读源码宣布完成的结果:冷启动是否一定没有短暂空星、快速连点是否会丢更新、磁盘写入失败时用户能否理解、平板和 2in1 的四列网格是否仍然好用。这两类结论必须分开。

建议把验收分成四层,每一层回答不同问题:

验收层最小操作可以证明什么不能替代什么
纯函数输入空串、非法 JSON、重复 key、混合类型数组解析容错与 Set 去重符合契约不能证明 Preferences 可写
服务集成使用可控 Preferences,执行 toggle、clear 和 flush 失败分支写入顺序、返回值、失败时是否广播不能证明页面会重组
页面联动首页收藏 A,切到工具页和收藏页,再从收藏页取消三页面确实订阅同一状态,星标事件没有误触导航不能证明重启后仍保留
启动与设备杀进程后重启,并覆盖手机、小窗、平板、深浅色模式恢复时序、布局、安全区和真实交互可用不能由静态截图代替

运行时检查应记录可复现步骤,而不是只记录“看起来正常”。例如先清空收藏,首页点击长度工具右上角星标,确认没有进入详情页;切到工具页确认长度星标填充;切到收藏页确认只出现一张长度卡片;点击填充星取消,确认收藏页进入空状态;回到首页与工具页确认星标同时恢复为空心。随后重新收藏长度和 BMI,结束进程并重新启动,确认两个 key 都被恢复。这个流程分别覆盖事件边界、状态广播、有效目录投影和跨启动持久化。

故障注入同样重要。让 Preferences 写入或 flush 失败时,源码当前会记录日志,AppStorage 因为位于 flush 之后而不会更新,这能避免页面显示“已经收藏”的假成功;但界面也没有提示,用户只能看到星标没有变化。验收报告应如实写成“失败时保持旧状态,缺少用户可见反馈”,而不是笼统写“异常处理完善”。快速连续点击 A、B 时还应观察最终集合是否同时保留两个 key;如果只能留下最后一次写入,说明读改写需要串行队列、互斥或版本校验。

本文没有在本轮执行构建、真机、模拟器、故障注入或性能采样,因此这里只给出可执行验收方法,不把这些结果写成已经通过。真正交付时,应把构建命令、设备型号、系统版本、初始数据、操作序列、最终 Preferences 值和页面截图放进同一份记录,才能把“源码结构合理”推进为“运行行为已验证”。

二十五、结语:同步来自单一状态,不来自页面互相喊话

“万能转换器”的收藏工具实现已经建立了清晰闭环:页面提交稳定 key,FavoriteToolsService 用 Set 切换成员,Preferences 保证跨启动保存,AppStorage 把新 JSON 广播给首页、工具页和收藏页,收藏页再通过 findToolByKey() 过滤并还原真实工具卡片。

源码也暴露了明确的下一步:串行化快速点击、拒绝无效 key、清理废弃收藏、减少重复解析、补充失败提示、按设备宽度调整网格,并让服务已有的 clear 能力通过确认交互真正到达用户。把这些边界分清,才能准确解释 HarmonyOS ArkUI 跨页面状态同步,而不是把一次星标切换写成不存在的云端能力。

Logo

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

更多推荐