鸿蒙 ArkTS 状态管理实战:从员工签到 App 看 @State 与端云协同

举报
yd_239758213 发表于 2026/11/19 12:44:11 2026/11/19
【摘要】 引言今天在鸿蒙开发实践中心浏览了“使用 Agent 生成鸿蒙端云一体员工签到 App”案例:端侧用 ArkTS 实现登录、签到、历史记录和管理台,云侧用 Node.js + Express + MySQL 提供接口,GPS 定位结合 Haversine 公式判定签到范围,JWT 做鉴权。最值得拆开讲的不是某个接口,而是状态管理:数据在哪里、谁能改、改了之后界面怎么知道。本文就以这个案例为线...

引言

今天在鸿蒙开发实践中心浏览了“使用 Agent 生成鸿蒙端云一体员工签到 App”案例:端侧用 ArkTS 实现登录、签到、历史记录和管理台,云侧用 Node.js + Express + MySQL 提供接口,GPS 定位结合 Haversine 公式判定签到范围,JWT 做鉴权。最值得拆开讲的不是某个接口,而是状态管理:数据在哪里、谁能改、改了之后界面怎么知道。本文就以这个案例为线索,聊聊 @State、@Prop 与端云协同的状态分层。

一、为什么状态管理是第一道坎

ArkUI 是声明式 UI,界面是状态的函数:状态变了,框架自动重新执行 build() 重新渲染。点击“签到”后要立刻显示“签到成功 / 超出范围”,如果靠手动改组件文本,代码很快会乱成一团。把“签到结果”声明为状态,让界面跟着状态走,才是正确姿势。

二、@State:组件私有的响应式状态

@State 是最基础的状态装饰器,只能用于组件内部,被它标记的变量一旦变化,引用它的 UI 会自动刷新:

@Entry @Component
struct CheckinPage {
  @State status: string = '未签到'
  build() {
    Column() {
      Text(this.status)
      Button('签到').onClick(() => {
        this.status = '签到成功'
      })
    }
  }
}

要点有二:修改必须通过赋值触发,直接改对象内部字段有时不会刷新;@State 只属于当前组件,跨页面共享不要用它硬撑,否则每个页面都要重复请求和同步。

三、@Prop 与 @Link:父子之间怎么传数据

签到页常由父组件拼装,子组件只负责展示一段信息。@Prop 适合单向传递:父组件改,子组件跟着变,子组件自己不能改;需要回写时用 @Link 双向绑定。选错方向的典型症状是:在子组件改了值,界面闪一下又变回去,因为数据源头在父组件,下一轮渲染又被覆盖。规则很简单:谁拥有数据,谁负责修改。

四、从本地状态到端云协同

真实签到不是纯本地的:端侧取 GPS 坐标,把坐标和 token 发给后端,后端查配置、算距离、判班次,再返回结果。建议分三层:UI 状态如 loading、提示语,用 @State;业务状态如当前用户、签到记录,放在 Service 里集中管理;服务端状态如签到位置、班次时间,权威来源永远是后端,端侧只做缓存和展示。分层后调试也有章可循:界面没刷新先看 @State,数据不一致先看 Service,规则不对先看后端接口。

五、三个容易踩的坑

一是重复点击:请求没回来前连点两次,后端可能收到两条记录,请求期间应禁用按钮。二是把 token 放在组件状态里到处传,token 属于全局登录态,应由 AuthService 统一持有并在请求时注入。三是默认地址不为空:案例 README 提醒,ConfigCenter 的默认 API 地址应为空字符串,防止凭据误发到演示服务器,首次启动需在登录页先设置服务器地址。

结语

@State 解决“一个组件内部的数据怎么变”,@Prop 与 @Link 解决“父子组件之间的数据怎么流”,Service 与后端接口解决“跨页面、跨端云的数据以谁为准”。把这三层想清楚,再去看签到 App 的 6 个页面与 4 个 Service,结构就很清晰了。建议照着案例把签到流程跑通一次,再加一个“查看历史签到”页面,亲手感受状态从接口流向界面的完整过程。

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

评论(0)

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

全部回复

上滑加载中

设置昵称

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

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

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