ArkUI 番茄钟·森林养成 App 实践:状态管理、定时器与本地归档的落地细节

举报
yd_279885541 发表于 2026/11/14 08:11:55 2026/11/14
【摘要】 番茄钟·森林养成 App 案例实践记录:倒计时应放进 @State 而不是 build()、种树动画用 animateTo 状态驱动、森林快照按日期用 Preferences 归档,并附 ArkTS 严格模式 this 绑定、沉浸式状态栏等踩坑细节,适合 ArkUI 入门后的第一个完整项目。

为什么选番茄钟练 ArkUI

鸿蒙实践中心上线的 HarmonyOS-APP-tomato-timer 案例是个很好的 ArkUI 练手项目:专注完成即种树、中途放弃则枯萎、按日期归档森林快照。功能不复杂,但把 ArkUI 声明式开发的几个核心机制都串起来了。这两天把这个案例的代码结构过了一遍,记录几个实操细节。

一、倒计时驱动:不要在 build 里做计算

初学者最容易犯的错是在 build() 里直接读 Date.now() 做剩余时间计算——build 只声明"UI 是状态的函数",时间流逝不是状态变化,界面不会刷新。正确做法是用 @State 持有 remainSeconds,setTimeout/Timer 回调里每秒减一,UI 自动跟随。注意页面隐藏时要暂停计时,用 onPageHide/onPageShow 生命周期配对处理,否则后台挂着好几个计时器,回来一看树已经"烂"在原地了。

二、种树动画:状态驱动的属性过渡

树苗从种子到成材的过程,用 @State 的 growthStage(0~3)控制不同的 Image/自定义组件,切换时加 animateTo 做尺寸和透明度过渡就够用了。不需要引入复杂的动画库。中途放弃变枯萎,本质是同一个 growthStage 状态被重置成特殊值,配合不同的资源图。这正体现了声明式 UI 的思路:你只描述"状态长什么样 UI 就长什么样",动画是状态变化的自然结果。

三、森林快照:按日期归档的本地持久化

归档功能用 @StorageLink 或 AppStorage 跨页面共享完成记录,落盘用 Preferences 存 JSON 数组,key 按日期分片。列表页用 LazyForEach 渲染历史记录,数据量大时务必给 item 生成稳定 key,否则滑动列表会出现状态错乱。日历视图用 Grid + ForEach 按 7 列布局,周首日偏移用 date.getDay() 算。

四、踩过的坑

一是 ArkTS 严格模式不允许 any,Timer 回调里的 this 绑定要用箭头函数,否则状态更新落不到组件实例上;二是沉浸式状态栏要给 Column 顶部加 expandSafeArea 或者用 window 模块设置 avoid area,不然计时数字会被状态栏压住。三是编译打包走 DevEco Studio 或云端的 AI DevSpace 都行,用浏览器里的 DevSpace 云端编译反而省去本地环境配置。

小结

这个案例代码量不大,覆盖了状态管理、生命周期、动画、持久化、列表渲染五个高频知识点,适合作为 ArkUI 入门后的第一个完整项目。仓库在 gitcode 的 harmony-practice-center 下开源,感兴趣的可以拉下来跑一跑。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。