harmonyos

见山是山-见水是水

鸿蒙Divider 分割线组件完全指南：内容分组、视觉分区与自定义样式本文基于 HarmonyOS（ArkTS 声明式开发范式，API 12 / 5.0.0）写作，所有示例均可在 DevEco Studio 模拟器中验证。配套演示工程位于本文同级目录 ohos/，包含完整可运行的 EntryAbility.ets 与 Index.ets。

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

JsonConvert：适用于 Android、鸿蒙与 Flutter 的 JSON 转 Model 插件作为移动端开发者，每天和各种接口数据打交道是家常便饭。而处理接口数据时，最让人头疼、最消耗耐心的环节莫过于把一大串复杂的「JSON 转换成对应的 Model」了。尤其是遇到嵌套层级深、字段又多的响应数据，手写不仅容易出错，而且枯燥又浪费时间。

Dovis(誓平步青云）

从手机单栏到平板分栏：任务清单的筛选、选中态与不可变更新任务清单最容易停在“能显示几行文字”的阶段。真正开始操作以后，新增任务要进入列表，筛选条件要立即生效，勾选状态要同步顶部计数，宽屏详情还要始终指向当前任务。只要其中一个状态单独维护，页面很快就会出现列表和详情不一致的问题。

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

HarmonyOS Stage 模型实战：UIAbility 生命周期如何驱动页面安全状态HarmonyOS Stage 模型中，UIAbility 是带界面的应用组件，WindowStage 提供窗口绘制区域，ArkUI 页面则管理实际组件树。

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

梦想不只是梦与想

鸿蒙 AppGallery Connect：查看应用信息（三）创建HarmonyOS应用/元服务后，经常需要查看应用的各种标识信息。本文将介绍如何在AppGallery Connect中查看这些关键信息。

【中国方言题库｜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

鸿蒙ArkTS实战项目 - 门店陈列巡检台：巡检卡片与多列切换实现本篇只看巡检卡片组件和页面控制区。六张卡片高度不同，正好适合拿来验证瀑布流的测量和排布结果，因此文章必须给出足够多的卡片代码，而不是只讲结果图。

Harmony os 技术实战｜拼豆制图27：用单字符编码承载 50 张 70×70 图纸标签：Harmony os、ArkTS、资源编码、数据校验、像素图纸一张 70×70 拼豆图有 4900 个位置。如果把每个位置直接写成包含 row、col、colorId、colorCode、hex 和 isEmpty 的对象，资源文件会迅速膨胀，人工审查也几乎不可能。工程采用了更紧凑的形式：每行是一段字符串，每个字符代表空格或色板索引，加载时再展开为完整 BeadCell[]。

UIAbility 生命周期全链路：从冷启动到热启动的实战笔记生命周期管理是应用开发中最容易踩坑的地方之一。鸿蒙的 UIAbility 生命周期设计相比传统移动端框架有一些独特之处，尤其是冷启动和热启动的区分、WindowStage 的介入时机、以及 onNewWant 的处理逻辑。这篇文章结合官方文档和实际开发经验，把 UIAbility 的完整生命周期链路梳理一遍。

梦想不只是梦与想

鸿蒙 AppGallery Connect：应用创建（二）APP ID是应用开发与发布的关键要素，是识别应用的唯一标识。如需在华为应用市场发布应用，或者使用AppGallery Connect提供的各类服务，首先要在AGC为软件包创建对应的HarmonyOS应用。

我用 HarmonyOS NEXT 做了一款排班倒班 App一款叫《班妥了》的鸿蒙原生 + 微信小程序双端排班应用，聊聊我为什么做、怎么做、踩了哪些坑。我是一名 AI 平台工程师。去年开始给自己写一个排班工具，原因是市面上实在找不到一个「小而美、本地优先、能看清自己一年到底有多拼」的 App。于是从 0 开始用 HarmonyOS NEXT 撸了一版，又顺手做了个微信小程序版给同事用。

芯笺 Markdown：面向 HarmonyOS PC 的本地优先 Markdown 编辑器芯笺 Markdown 是一款面向 HarmonyOS PC / 2in1 的本地 Markdown 编辑器，现已上架。它不以笔记库或云同步为中心，而是把用户自己的 .md / .txt 当作唯一事实来源。1.0 不申请 ohos.permission.INTERNET，不要求登录，不上传文档。本文说明它的产品边界、核心能力，以及在鸿蒙电脑上的实际用法。

世人万千丶

鸿蒙项目实战 - 社区活动编排板：标签云布局算法与自动换行实例：社区活动编排板｜技术：CustomLayoutAlgorithm、onMeasure、onLayout、自动换行、DynamicLayout

鸿蒙ArkTS项目实战 - 门店陈列巡检台：完整代码与运行效果Button('🧭 59 门店陈列巡检台') .fontSize(14) .width('80%') .onClick(() => { this.getUIContext().getRouter().pushUrl({ url: 'pages/api24_series/StorePatrolPage' }); })

【中国方言题库｜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 及以上版本，基于真实源码逐段复核状态推进、计时、完成提交与生命周期清理，并指出混合错题统计和空题回退的边界。