arkts

HarmonyOS趣味相机实战第16篇：实时识别采样、Busy锁与Generation并发治理在相机预览上做人体识别，最直接的实现是不断从 Surface 创建 PixelMap，再调用 CoreVisionKit。这个方案能跑起来，却容易在真机上出现预览掉帧、多个识别任务重叠、切换镜头后旧结果回写、页面退出仍持有 PixelMap 等问题。

39-设置开关退出就复原-用偏好写队列和回滚状态兜住摘要：设置页开关最容易被写成 @State 一改就完事。实际项目里，用户快速连点、离开页面、写入失败、重启应用都会暴露问题：UI 显示已开启，持久化里还是旧值。更稳的做法是让设置写入走串行队列，页面可以乐观展示，但失败必须回滚，并用重启验证证明真的保存成功。

HarmonyOS趣味相机实战第17篇：BackupExtensionAbility备份恢复与Preferences版本迁移本地相机应用通常同时保存两类数据：真实照片文件，以及用于页面展示的标题、时间、水印和文档索引。仅恢复其中一类会产生“列表存在但图片打不开”或“文件还在但应用相册为空”的半恢复状态。

想你依然心痛

【共创季稿事节】HarmonyOS 7.0 ArkTS 声明式UI高级实战：自定义动画与手势系统即使触不到满天星辰，也要奔跑在萤火之森。接受“理想可能达不到”（触不到星辰），但不接受“什么都不做”。退而求其次不是妥协，而是换一种方式靠近光明。萤火虽小，也是自己的光。

42-RDB查询拖慢首屏-用索引分页和快照缓存拆开摘要：本地 RDB 数据多了以后，首屏卡顿经常不是 UI 写得慢，而是页面一出现就做了全表排序、统计和复杂过滤。更稳的做法是把首屏快照、分页查询和统计重算拆开：首屏先读轻量快照，列表分页加载，统计在写入后维护或后台刷新。

HarmonyOS趣味相机实战第13篇：CameraPicker与CameraKit选型、系统拍照回退及架构边界HarmonyOS 应用需要“拍一张照片”时，并不一定要自己管理 CameraInput、PhotoSession、XComponent Surface 和 PhotoOutput。若产品只需要调用系统拍摄界面并拿回结果，CameraPicker 能显著减少相机生命周期代码；若产品需要在应用内实时预览、倒计时、闪光灯、水印叠层、人体识别、前后镜头切换或双摄扩展，则必须使用 CameraKit 自定义会话。

HarmonyOS趣味相机实战第14篇：装饰素材强类型建模、锚点语义与套装组合校验相机贴纸功能看起来像“选一张图片并叠到预览上”，但素材数量增长后，真正难维护的不是图片资源，而是素材背后的业务语义：猫耳应该跟随头顶，眼镜应该跟随双眼，翅膀应该位于人体后方，边框只属于场景层，氛围贴纸允许重复添加，套装引用的素材不能失效。

鸿蒙HarmonyOS 多模态输入实战 —— 图片与文档输入智谱/DeepSeek假设你让 Agent 接收用户拍的烘焙成品照片，分析烘焙效果。你查了智谱 API 文档，发现它支持 image_url。你写了：

31-后台任务重复执行-用唯一任务键和租约防止并发摘要：后台任务重复执行，常见于定时任务、页面返回刷新、手动同步各自启动了一次同样的业务。用户看到的是同步两次、通知重复、数据覆盖，日志里却像每个入口都合理。稳定做法是为业务任务建立唯一任务键和租约，任何入口都先申请运行权，拿不到租约就复用、跳过或等待。

32-Token明文存储-把凭据边界收到安全仓储里摘要：登录 Token 最危险的地方，不是“它被存了一次”，而是它会顺着页面状态、请求日志、异常上报和旧版本迁移扩散出去。实际项目里要先把泄露链路画出来，再把凭据收进唯一的 TokenVault：页面只拿会话摘要，请求前短时读取，刷新和退出登录都走同一个边界，发布前用搜索和重启验证证明明文没有残留。

高地捣蛋鬼

HarmonyOS7 表单验证实战：实时校验与错误提示的完整方案做表单就绕不开验证。用户名不能为空、邮箱要有 @ 符号、手机号得是 11 位数字——这些规则看起来简单，但真正做到用户体验好的验证逻辑，还是有不少细节要处理。

22-平板上页面被拉扁-用断点布局和资源覆盖做一多适配摘要：手机单列页面直接铺到平板，常见后果是卡片像横幅、文本行过长、右侧空白却没有信息。本文以课程首页为例，根据窗口宽度划分紧凑、中等和扩展三档；窄屏保留单列，宽屏切换列表—详情双栏，并把颜色、图片等视觉差异放入资源覆盖，让一套工程在不同窗口保留同一任务路径而非同一像素布局。

27-RDB写一半数据不一致-用事务边界和补偿日志兜住摘要：RDB 写一半数据不一致，常见于主表已经插入、明细表或索引表失败，页面却提示保存成功。关系型数据库适合复杂关系数据，但多表写入必须有清晰事务边界；如果业务还涉及文件、网络或跨模块状态，也要留下补偿日志，方便启动后恢复或提醒用户重试。

HarmonyOS趣味相机实战第11篇：从单摄切换升级前后双摄同开、能力探测与降级设计当前 D:/APP/1quweixiangji 趣味相机已经完成前后镜头发现、单镜头预览、镜头切换和 PhotoOutput 拍照，但它一次只维护一个 CameraInput、一个 PhotoSession 和一个 XComponent Surface。若要升级为“前后双摄同开”，不能简单地连续调用两次 createCameraInput()：设备可能没有前后两个逻辑摄像头，也可能不支持并发；支持并发的机型还需要使用并发能力结果提供的输出配置，并以受限能力模式打开输入。

HarmonyOS趣味相机实战第12篇：CameraKit错误分层、相机占用恢复与用户可重试状态机CameraKit 相机项目最难排查的故障往往都被用户描述成一句“相机打不开”。实际原因可能完全不同：相机权限被拒绝、设备没有可用镜头、XComponent Surface 尚未创建、旧 PhotoSession 没释放、相机被其他应用占用、photoAvailable 没在超时窗口内返回，甚至只是页面拿到了旧任务的迟到 PixelMap。如果所有错误都显示“请重试”，用户无法恢复，开发者也无法从日志定位。

HarmonyOS趣味相机实战第7篇：Preferences相册缓存、旧数据兼容与异常兜底本地相册看起来只是一个列表，但真正上线后会遇到很多细节：第一次启动没有数据怎么办，Preferences 里的 JSON 损坏怎么办，老版本缺少新字段怎么办，滤镜强度出现 NaN 怎么办，保存太多记录会不会拖慢启动，页面拿到列表后会不会直接改坏服务内部缓存。

ArkTS 并发编程：TaskPool 多线程实战ArkTS适用版本：HarmonyOS 6.1（API 12）及以上验证环境：Pura 90 Pro 模拟器（HarmonyOS 6.1.1，API 24）关键 API：@kit.ArkTS → taskpool

HarmonyOS趣味相机实战第5篇：CameraKit资源释放、PixelMap生命周期与预览黑屏排查相机应用最容易出现的不是“代码编译不过”，而是运行一段时间后预览黑屏、切后台回来相机被占用、连续拍照后卡顿、保存后内存涨、前后摄像头切换失败。这些问题通常不是一个 UI 按钮能解决的，而是 CameraKit 会话、PreviewOutput、PhotoOutput、MetadataOutput、CameraInput、PixelMap、ImageSource、CoreVision 检测器和页面状态没有形成清晰的生命周期。

鸿蒙上跑通第一个 AI Agent：5 分钟接入智谱/DeepSeek很多开发者在鸿蒙上接入大模型的方式是：写一个 fetch 请求调 Chat Completions API，拿到 JSON，解析 choices[0].message.content，显示到 Text 组件上。这能"跑通"，但跑不对：

不才难以繁此生

NavPathStack 返回错页怎么排查：中式美食详情页从搜索、收藏和推荐进入怎么回到原处中式美食的菜谱详情页会从很多地方进入：首页推荐、搜索结果、收藏页、购物清单、相关推荐。详情页本身看起来是同一个页面，但返回时不能都按同一种方式处理。从搜索进来，应该回到搜索结果；从收藏进来，应该回到收藏列表；从首页推荐进来，应该回到首页原来的区域。