arkts

【寻迹校园 HarmonyOS NEXT 实战 41】用户照片、演示图与图标兜底：ReportMedia 的三层媒体策略本章导读：这是“寻迹校园 HarmonyOS NEXT 实战”系列第 41 篇。本文从 ReportMedia.ets 的正式代码出发，解释失物招领场景为什么需要“用户照片、受控演示图、品类图标”三层媒体策略，同时说明寻迹校园当前正式实现已经移除演示图片，只保留“用户照片优先、品类图标兜底”两层。三层是完整设计模型，不代表三层都应该进入生产包。

【中国方言题库｜19】HarmonyOS ArkTS 回归测试实战：覆盖启动、空数据、异常输入和重复点击HarmonyOS 应用的回归测试不能只验证“首页能打开”。真实故障往往出现在启动数据损坏、路由参数缺失、空题库、考试记录 JSON 非法、重复点击交卷、计时器离开页面后仍执行、窗口切换导致布局分支失效等边界。尤其是本地题库应用，主流程不依赖网络，稳定性重点更集中在状态初始化、页面路由、持久化、交互幂等和多设备布局上。

【寻迹校园 HarmonyOS NEXT 实战 36】深色模式不是反色：用语义 Token 管理品牌色与状态色本章导读：这是“寻迹校园 HarmonyOS NEXT 实战”系列第 36 篇。本文以 AppTheme.ets、Light/Dark 颜色资源、首页状态卡片、发布表单和治理进度页为证据，拆解 HarmonyOS NEXT 项目如何用语义 Token 同时管理品牌色、丢失/拾得状态、警告、错误、文本、边框与禁用态，并说明静态资源检查、视觉验收、量化对比度和屏幕阅读器验证之间的证据边界。

【寻迹校园 HarmonyOS NEXT 实战 38】34%/44%/22% 三栏工作台：超宽屏失物匹配的主从详情设计本章导读：这是“寻迹校园 HarmonyOS NEXT 实战”系列第 38 篇。本文以 HomePage.splitScreenHome()、ItemDetailPage、MatchResultsPage 和精确 1280vp 模拟器证据为主线，分析超宽屏为何采用 34% 查询列表、44% 中间详情、22% 匹配辅助的主从工作台，并说明 selectedReportId、previewReportId 与 sourceReportId 如何避免候选预览破坏原始查询上下文。

【中国方言题库｜15】HarmonyOS ArkTS 本地状态持久化实战：让保存、删除和页面返回后的数据即时一致本地应用最容易出现的状态问题，并不是“数据完全没保存”，而是两套状态不同步：用户刚收藏题目，当前按钮已经变色，但返回首页统计仍是旧数字；删除错题后列表消失，重新启动又回来；设置页显示了新考试时长，练习页却仍读取旧值。根因通常是页面状态与持久化存储各自维护一份数据，却没有明确谁负责写入、谁负责通知 UI。

【中国方言题库｜13】HarmonyOS ArkTS 应用启动链路实战：从 EntryAbility 到首屏加载保持窗口与路由稳定HarmonyOS 应用的首屏稳定性，不只取决于某个页面能否成功构建。系统如何找到入口 Ability、运行时状态何时恢复、断点监听何时注册、窗口避让区何时可读、启动页如何进入主页，以及销毁时是否解除监听，共同组成一条完整启动链路。任意一步顺序混乱，都可能表现为首屏白屏、数据闪烁、底部导航被遮挡、窗口变化后布局不更新，或者返回键又退回启动页。

【寻迹校园 HarmonyOS NEXT 实战 16】Preferences 还是 RelationalStore：HarmonyOS 本地存储选型实战这是“寻迹校园 HarmonyOS NEXT 实战”系列第 16 篇。本文不做抽象的 API 罗列，而是结合项目里的安全提醒、失物记录、认领交接和照片文件，说明 Preferences、RelationalStore 与应用沙箱文件系统各自应该保存什么，以及错误选型会给升级、查询和数据一致性带来什么问题。

【寻迹校园 HarmonyOS NEXT 实战 31】举报去重怎么做：同一记录的重复投诉不应制造多条处理中案件本章导读：这是“寻迹校园 HarmonyOS NEXT 实战”系列第 31 篇。本文结合 ModerationReportPage、ModerationService.submit()、ModerationRepository.findByReportId() 与本地状态机测试，拆解举报原因、敏感信息拦截、重复案件回执和数据库唯一约束之间的边界。

【中国方言题库｜11】HarmonyOS ArkTS 学习统计实战：计算地区学习进度与收藏数量摘要：中国方言题库的学习统计页没有维护一套额外计数器，而是从 bankProgress、examHistory、favoriteRecords 和 wrongRecords 四组本地事实数据实时汇总。StatService 负责全局答题数、加权正确率、考试次数、收藏数、错题数和已学习题库数，页面再按题库展示完成量与正确率，并在大屏断点下切换为三列布局。本文面向 HarmonyOS 5.0 及以上版本，基于真实 ArkTS 源码复核统计公式、Preferences 到 AppStorage 的数据链、近五次

HarmonyOS 日记类 App 的日期设计：本地自然日、月历与夏令时边界心情日记的核心问题看起来很简单：今天保存一条记录。但代码很快会遇到：如果没有统一日期规则，今日页、历史页和统计页很容易互相矛盾。

【中国方言题库｜12】HarmonyOS ArkTS 题库列表组件实战：减少多地区页面重复并保证点击反馈在方言学习应用中，题库入口看起来只是“把若干地区卡片排成列表”，真正落到工程里却会同时碰到数据排序、组件复用、学习进度回显、页面路由和多设备布局。若每个地区分别维护一套页面，四川话、粤语、东北话等入口很快会出现重复结构；如果只复用外观而没有统一数据与交互，点击目标、进度口径和大屏布局仍然会分叉。

【知律｜18】HarmonyOS ArkTS 权限与隐私实战：让 module.json5、功能说明和拒绝路径一致权限与隐私最容易出现的审核问题，往往不是“权限申请得太多”这么简单，而是代码、配置、页面文案和上架材料各说各话。module.json5 声明了网络权限，产品说明却写成完全离线；设置页显示“提醒已设置”，工程里却没有通知调度；页面提示数据已清除，持久化异常却被静默吞掉。这些细节单独看都不大，合在一起就会让审核人员无法判断应用真正做了什么。

【寻迹校园 HarmonyOS NEXT 实战 28】不交换手机号也能交接：固定校内交接点的隐私设计这是“寻迹校园 HarmonyOS NEXT 实战”系列第 28 篇。本文结合 HandoffLocation、HandoffService 与 HandoffPage 的真实实现，说明为什么校园失物招领应优先使用固定地点 ID 和有限时间段，而不是收集手机号、宿舍门牌或自由文本地址。

【中国方言题库｜09】HarmonyOS ArkTS 方言搜索实战：实现词语检索和无结果反馈摘要：中国方言题库的搜索页不是网络搜索，也没有模糊分词引擎，而是基于本地 BANKS 与题目集合完成确定性的子串检索。页面同时支持关键词入口和题型分类入口，通过 searched 明确区分搜索首页、无结果和结果列表三种界面状态，并在用户修改分类关键词时主动退出分类模式。本文面向 HarmonyOS 5.0 及以上版本，逐段复核 SearchPage.ets 的 ArkUI 状态建模、结果上限、题库与题目双通道检索、安全区适配和导航行为，也会指出“点击题目进入整库随机练习”等真实边界，避免把尚未实现的能力写

【中国方言题库｜03】HarmonyOS ArkTS 四川话分库实战：复用题库组件并保持地区参数清晰摘要：地区分库页面看起来简单，却承担着稳定身份、路由可达和共享组件复用三项关键职责。本文基于“中国方言题库”真实源码中的 SichuanBankPage.ets，沿着 BankCard -> SichuanBankPage -> BankDetailContent -> PracticePage 追踪 b_sichuan，说明如何用薄入口组件复用题库详情、学习进度、章节列表和多设备布局，同时避免复制业务代码、路由参数污染与地区数据串库。

【中国方言题库｜10】HarmonyOS ArkTS 语音播放实战：管理读音播放与页面生命周期摘要：中国方言题库的听音能力并不是播放预置方言音频文件，而是在 PracticePage 中调用 @hms.ai.textToSpeech，把题目的 audioHint 文本交给系统语音引擎合成。实现采用本地引擎优先、在线引擎回退的策略，用监听器同步开始、完成、停止和错误状态；点击播放时先打开文字兜底弹窗，再尽力启动 TTS；页面离开时停止并关闭引擎。本文面向 HarmonyOS 5.0 及以上版本，基于真实 ArkTS 源码复核引擎创建、重复点击、请求标识、状态恢复、底部弹窗和生命周期释放，并明确 zh

【中国方言题库｜06】HarmonyOS ArkTS 闽南语与客家话实战：统一分库页面导航与空状态摘要：两个地区分库如果分别编写导航、返回、详情和空状态，短期看只是多几十行 ArkTS，长期却会产生行为漂移。“中国方言题库”的闽南语与客家话入口都复用 BankDetailContent，由 BankCard 统一选择路由，main_pages.json 注册页面，TopBar 统一返回，题库 ID 再决定目录、Profile、题目与进度。本文基于 HarmonyOS 5.0+ 当前真实源码，复核两条分库链路，重点分析“题库不存在”和“题库存在但暂无内容”为什么不能混成一个空状态。

【中国方言题库｜07】HarmonyOS ArkTS 方言练习实战：推进题目、提交答案并同步统计摘要：答题页真正困难的部分不是画四个选项，而是保证“选中、判定、解析、错题、自动下一题、最终统计”按确定顺序发生。“中国方言题库”的 PracticePage 同时支持章节、随机、考试、错题练习和错题解析，使用 ArkUI @State 驱动单题界面，再通过 @StorageLink 与 UserDataManager 同步收藏、错题、笔记和学习进度。本文面向 HarmonyOS 5.0 及以上版本，基于真实源码逐段复核状态推进、计时、完成提交与生命周期清理，并指出混合错题统计和空题回退的边界。

【中国方言题库｜05】HarmonyOS ArkTS 东北话分库实战：让地区内容与通用列表解耦摘要：地区题库很容易走向两种极端：所有地区挤在一个巨型页面里，或者每个地区复制一套列表、进度和跳转代码。“中国方言题库”的东北话分库采用第三种方式：NortheastBankPage 只固定 b_northeast，共享的 BankDetailContent 负责详情、章节、进度、多设备布局和练习入口，MockBanks 再通过题库 ID 选择本地内容。本文基于当前 HarmonyOS 5.0+ ArkTS 源码，拆解这条真实链路，并讨论数据边界、章节分配、缓存、进度隔离和后续模块化方式。

arkts- 8 三方库介绍OpenHarmony三方库中心仓@hadss/hmrouter地址==>步骤1 安装==>步骤2 依赖配置插件配置