HarmonyOS怎么开发元服务卡片功能

大明姑娘_2377

大明姑娘_2377

2026-08-07

503人浏览

原创

HarmonyOS元服务卡片开发需完成四步闭环:新建Stage模型下的Service Widget模块、配置2×2尺寸及定点刷新、实现日期动态绑定与onUpdate定时更新、通过router.pushUrl跳转并校验路径匹配,缺一不可。

harmonyos怎么开发元服务卡片功能 - php中文网

在HarmonyOS中开发元服务卡片功能,需完成卡片创建、数据绑定、动态刷新与页面跳转四步闭环,缺一不可——否则卡片添加后空白、点击无响应或时间不更新。

新建元服务卡片模块

打开DevEco Studio,在已创建的元服务工程根目录右键 → New → Module → 选择“Service Widget”模板 → 命名为“widget_card” → 点击Finish。

这一步必须在Stage模型下进行;若项目为FA模型或未启用Stage,新建选项将不可见。【新建前务必确认工程配置为Stage模型,否则无法生成合法卡片结构】

生成后,自动创建widgets目录,含index.ets(UI)、model.ts(逻辑)、config.json(卡片元信息)三个核心文件。

配置卡片尺寸与生命周期

打开widget_card/src/main/resources/base/profile/widget_config.json,修改以下字段:

"defaultLayout": "2x2",

"isDefault": true,

"updateDuration": 0,

"scheduledUpdateTime": "00:00"

其中updateDuration设为0表示禁用周期刷新,scheduledUpdateTime设为"00:00"表示每日零点定点刷新——这是避免后台频繁唤醒、节省电量的关键设定。

注意:小尺寸(2×2)为必选,若未配置,上架审核会直接驳回。

实现卡片动态日期显示

第一步:在index.ets中声明响应式变量

@State curDate: string = '1990-01-01';

第二步:在onPageShow生命周期中获取当前日期并赋值

onPageShow() { this.curDate = new Date().toISOString().split('T')[0]; }

第三步:在UI中绑定显示

Munch
Munch

一款AI视频内容分析与短视频制作工具,可从长视频中识别适合传播的片段,并辅助制作面向社交平台的短内容。

下载

Text(this.curDate).fontSize(14)

这一步仅解决首次加载显示,不处理后续更新——若只做这一步,用户第二天看到的仍是昨天的日期。

让卡片真正“活”起来:定时刷新数据

方法一:使用系统级定点刷新(推荐)

在widget_card/src/main/ets/model/widgetModel.ets中,找到onUpdate函数,添加如下代码:

onUpdate(want: common.Want, formId: number): void { const now = new Date(); const dateStr = now.toISOString().slice(0, 10); formProvider.updateForm(formId, { curDate: dateStr }); }

此函数会在scheduledUpdateTime指定时刻被系统调用,无需手动启停定时器。

方法二:手动启动定时器(慎用)

在onPageShow中调用setInterval(() => { this.curDate = new Date().toISOString().split('T')[0]; }, 60000);

【禁止在卡片中长期运行setInterval,会导致系统强制回收卡片进程,卡片变灰失效】

从卡片跳转到元服务内部页面

第一步:在index.ets中给Text组件添加router事件

Text('进入游戏').onClick(() => { router.pushUrl({ url: 'pages/index', params: { fromCard: true, level: 1 } }); })

第二步:在目标页面pages/index.ets的onPageShow中读取参数

onPageShow() { const params = router.getParams() as Record; if (params.fromCard) { console.info('来自卡片跳转,关卡:' + params.level); } },>

第三步:确保pages/index.ets所在模块已在module.json5中声明为Ability,并且abilityName与router.pushUrl中url路径严格匹配——路径错误会导致白屏且无报错提示。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

harmonyos教程 harmonyos

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
harmonyos是什么意思
harmonyos是什么意思

harmonyos是一个多设备、可扩展的全场景操作系统,它的设计目标是实现智能终端之间的无缝连接,提供统一的操作体验。本专题提供harmonyos相关的文章,大家可以免费体验。

2023.06.28

5365

5

Navicat创建数据库教程
Navicat创建数据库教程

本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。

2026.11.20

0

7

Navicat入门教程大全
Navicat入门教程大全

本专题整理Navicat入门教程,从认识软件界面到开展数据库操作,介绍初次使用需要了解的知识和方法。内容兼顾连接配置、数据管理及日常使用中的疑问,方便用户按学习进度查阅,为后续实践和独立操作打好基础。

2026.11.20

0

17

Navicat数据库连接配置指南
Navicat数据库连接配置指南

从确认数据库信息到建立可用连接,本专题串联Navicat连接数据库的相关知识和操作方法。既有初次配置时需要了解的基础内容,也有连接后的检查思路,方便用户按实际需求查阅教程,逐步熟悉数据库连接的设置流程。

2026.11.20

0

10

PHP8.6数组与数据处理教程
PHP8.6数组与数据处理教程

本专题汇总PHP8.6数组与数据处理教程,涵盖CSV读取和导出、引用遍历删除、array_filter回调模式、配置键名冲突、pathinfo文件名校验、GMP大整数进制转换及UTF-8正则筛选,说明升级兼容变化、输入范围和失败处理方法。

2026.11.20

0

8

PHP8.6升级迁移教程
PHP8.6升级迁移教程

本专题汇总PHP8.6升级迁移与弃用接口改造教程,涵盖反射调用、对象属性赋值、标识符更名、构造函数与__debugInfo调整,以及插件类名检查、常量导出、ArrayIterator排序、SPL和DTO查询参数转换,帮助梳理弃用提示并完成代码兼容改造。

2026.11.20

0

10

PHP8.6安装配置与FPM运维教程
PHP8.6安装配置与FPM运维教程

本专题汇总PHP8.6正式版安装部署与FPM运维教程,涵盖Linux并存安装、独立ini配置、扩展重新编译、Nginx切换与回滚、FPM状态监控和慢日志排查,以及环境变量、请求超时、OPcache刷新和预加载配置。

2026.11.20

0

10

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

2026.11.20

0

8

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

40

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程