arkui

HarmonyOS7 国际化适配：i18n 让你的 App 走向全球我之前做过一个出海项目，App 在国内跑得好好的，一到海外就各种问题——日期格式不对、货币符号乱了、阿拉伯语界面直接崩了。这些问题都归到"国际化适配"这个大坑里。HarmonyOS7 的 i18n 工具链其实做得挺完善，关键是你要知道怎么用。今天就来系统聊聊。

【寻迹校园 HarmonyOS NEXT 实战 37】一套 ArkUI 适配四档宽度：sm、md、lg、xl 响应式 Shell 实战本章导读：这是“寻迹校园 HarmonyOS NEXT 实战”系列第 37 篇。本文基于 Index.ets、Bottom/Top/SideNavigation、HomePage.ets 与 2026-08-12 模拟器验收记录，完整拆解 <600vp、600–839vp、840–1279vp、>=1280vp 四档 ArkUI Shell 的导航、内容密度、状态归属和页面复用方式，同时明确“保留大屏代码”不等于当前应用市场已经支持 Tablet 或 2-in-1。

熊猫钓鱼>_>

鸿蒙ArkUI全手势操作实战指南：6大基础手势从原理到落地避坑在鸿蒙原生应用开发中，手势交互是连接用户与界面的核心桥梁。从最简单的点击按钮，到复杂的图片缩放、页面侧滑返回，所有流畅的原生交互体验，底层都依赖ArkUI提供的手势系统。很多开发者在实际项目中经常会遇到手势冲突、响应不跟手、多设备适配异常等问题，本质上都是没有吃透基础手势的底层识别逻辑和参数边界规则。

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

【寻迹校园 HarmonyOS NEXT 实战 35】先写全页面 Design Spec 再写 ArkUI：一个比赛项目的设计稿门禁实践本章导读：这是“寻迹校园 HarmonyOS NEXT 实战”系列第 35 篇。本文结合 docs/design/all-pages-design-spec-v2.md、Index.ets、路由树、七组设计板和首发设备配置，复盘如何在多页面 HarmonyOS NEXT 项目中先固定页面、状态、断点、组件和文案，再把设计映射到 ArkUI 实现。

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

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

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

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

【中国方言题库｜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 源码，拆解这条真实链路，并讨论数据边界、章节分配、缓存、进度隔离和后续模块化方式。

【中国方言题库｜04】HarmonyOS ArkTS 粤语分库实战：处理繁简文本、读音与练习入口摘要：粤语分库不仅是把 bankId 换成 b_yue。粤字形、繁简展示、读音来源和练习参数都需要明确的数据契约。本文基于“中国方言题库”当前 YueBankPage、MockBanks、BankDetailContent 与 PracticePage 真实源码，说明固定入口如何复用统一详情组件，题库如何保存“唔、冇、咗、攰”等粤语文本，以及为什么当前 audioHint 和 zh-CN TTS 不能被宣传为真人或标准粤语读音。文章同时给出结构化文本与真实音频的安全扩展路径。

【寻迹校园 HarmonyOS NEXT 实战 06】共享权威词表：让发布表单与首页筛选使用同一套分类这是“寻迹校园 HarmonyOS NEXT 实战”系列第 6 篇。本文结合 ReportTaxonomy.ets，说明 HarmonyOS NEXT 应用如何用稳定内部值、展示标签和筛选关键词建立共享权威词表，避免发布、筛选和旧数据回显互相打架。

【寻迹校园 HarmonyOS NEXT 实战 07】不引入全局状态库：用 dataRevision 实现跨页面刷新这是“寻迹校园 HarmonyOS NEXT 实战”系列第 7 篇。本文拆解 Index.ets 的 dataRevision 方案：Service 和 Repository 保存权威数据，页面只传递失效信号，让首页、消息和“我的发布”在写入后重新读取，而不是维护多份可变副本。

【中国方言题库｜01】HarmonyOS ArkTS 方言题库首页实战：组织地区入口、推荐内容和学习进度摘要：题库应用的首页不是把所有功能堆在一屏，而是要回答三个问题：用户上次学到哪里、现在最值得做什么、怎样用最短路径进入目标题库。本文基于“中国方言题库”真实 ArkTS 源码，拆解 HomePage、Index、MockBanks 与 BankCard 的协作方式，展示如何用 ArkUI 组织六个地区题库、七类题型、本地学习统计、快速入口以及 phone、tablet、2in1 的断点布局。所有题量和学习进度都来自当前题库与本地记录，不虚构在线热度、排行榜或云端推荐。

【知律｜16】HarmonyOS ArkTS 多设备布局实战：适配手机、平板和 PC/2in1 的窗口变化多设备适配不是把手机页面的宽度改成 100% 就结束。手机适合底部主导航，平板和 PC/2in1 更适合侧边导航；分类卡片要随着可用宽度增加列数，题库详情在宽窗口中可以拆成双栏；窗口缩小时，内容必须重新回到单列，同时保持按钮、长文本和底部安全区可达。

【寻迹校园 HarmonyOS NEXT 实战 01】从校园痛点到可上架 MVP：失物招领应用产品设计这是“寻迹校园 HarmonyOS NEXT 实战”系列第 1 篇。项目使用 ArkTS、ArkUI、Stage Model、RelationalStore 和 Agent Framework Kit，目标不是堆功能，而是做出一条可以验证、可以降级、可以交付的校园失物招领闭环。

【寻迹校园 HarmonyOS NEXT 实战 03】NavPathStack 路由实战：18 个页面如何集中管理这是“寻迹校园 HarmonyOS NEXT 实战”系列第 3 篇。本文结合 ArkUI Stage Model 项目，拆解稳定路由键、类型化参数、统一 destinationBuilder，以及同一个 NavPathStack 如何复用到手机与大屏 Shell。

【知律｜10】HarmonyOS ArkTS 案例边界实战：明确普法内容不替代法律意见法律学习应用有一个比“答案是否能显示”更难的工程问题：用户会把界面里的确定语气当成可以直接执行的结论。题库写着“应当赔偿”“可以起诉”“申请仲裁”，在学习场景里可能只是知识点；放到真实纠纷中，却还取决于事实、证据、地域、程序期限、现行规则和专业判断。一个醒目的“仅供参考”无法自动修复过期法条、虚构来源或缺失条件。