【HarmonyOS】六脉神剑 | 元服务绝技之卡片刷新

【关键字】

元服务卡片(简称卡片)、刷新

【背景介绍】

本文主要介绍元服务卡片(简称卡片)中Java卡片的刷新相关知识，首先我们需要对卡片中的角色有基本的了解，如下：

1、卡片提供方

提供卡片显示内容的HarmonyOS应用或原子化服务，控制卡片的显示内容、控件布局以及控件点击事件。

2、卡片使用方

显示卡片内容的宿主应用，控制卡片在宿主中展示的位置，最常见的使用方如：桌面、服务中心。

3、卡片管理服务

用于管理系统中所添加卡片的常驻代理服务，包括卡片对象的管理与使用，以及卡片周期性刷新等。

下文将主要介绍卡片的两种刷新模式：

1、主动刷新 2、周期性刷新。

【主动刷新】

主动刷新就是应用（卡片提供方）通过updateForm接口去刷新卡片，可以使用的场景也很多，例如在卡片上添加刷新按钮，通过事件触发刷新卡片。系统对主动刷新也没有限制，只要在卡片可见（HarmonyOS 3.0系统限制）的时候，都可以通过这种方式进行刷新操作。

【周期性刷新】

周期性刷新主要有三种方式。

1、  定点刷新，即在每天的某个时间点刷新

定点刷新的周期是每天一次，需要在config.json中配置scheduledUpdateTime，每天都会在固定的时间点进行刷新。

2、  定时刷新，即间隔固定的时间后刷新服务卡片

定时刷新通过config.json中配置updateDuration设置固定的时间间隔，间隔最低是30分钟一次，所以每天最多能刷新的次数在50次以下。

3、  动态定时刷新，可以让卡片提供方来设置下次相对的定时刷新时间。动态定时刷新的最小时间间隔是5分钟，每天最多刷新也是50次。动态定时刷新使用可以参考以下论坛帖：

【HarmonyOS】基于JS UI的Java服务卡片如何实现动态定时刷新-华为开发者论坛 | 华为开发者联盟 (huawei.com)

周期性刷新流程如下图：

卡片周期性刷新是由卡片管理服务控制的，所以在使用过程中要注意以下一些情况：

1、卡片是否可见： 当前卡片当前状态不可见的时候，不允许刷新（HarmonyOS 3.0系统限制）。如果满足了刷新时间，卡片不可见，那么卡片会在下次卡片可见的时候刷新

2、刷新次数是否大于等于50：满足了定时器的时间，默认为30分钟刷新一次，当刷新次数大于等于50时，将不会进行周期刷新

3、周期性刷新IPC过程中，提供方是否存活：周期性刷新前卡片提供方是否存活都不会影响卡片周期性刷新，因为卡片周期性刷新是由卡片管理服务控制的，在需要刷新时如果卡片提供方不活动，卡片管理服务将会拉起提供方。

提供方存活或者拉起提供方后，卡片管理服务会与提供方进行IPC通信，收到IPC消息后，提供方会在onUpdateForm()回调中使用updateForm实现周期性刷新。

如果在这个IPC通信过程中提供方被杀死，就卡片的使用方无法完成刷新。

4、卡片是否被省电精灵管控：当应用允许后台活动开关关闭时，省电精灵会根据应用类型，改变卡片的刷新周期。其中工具类型的卡片最多半小时刷新一次，邮件、闹钟等应用最多2小时刷新一次，其他应用最多一天刷新一次。此外省电精灵会检测功耗大的卡片，将卡片的刷新周期强制改成24小时一次。

【其他刷新方式】

1、监听广播刷新（仅限Harmony 2.0系统，无法在3.0上使用）

例如可以通过监听亮屏广播（FA卡片可以接收鸿蒙侧的广播，无法接收安卓侧的广播），在广播的接收后，主动调用updateform接口进行卡片刷新。但这种方式会引起功耗等相关问题，会被系统管控，方法仅供参考。

2、通过前台Service实现实时刷新

因为后台服务会被系统回收，所以想要实现长时间实时刷新需要绑定前台Service，然后再Service中通过updateForm进行服务卡片刷新。(参考示例: Codelabs: 分享知识与见解，一起探索HarmonyOS的独特魅力。 - Gitee.com)

但是这种刷新方式功耗很大被系统管控，目前暂无办法保证卡片服务不被系统销毁，不过可以通过以下方式去改善被销毁的情况：

• 进入手机管家 > 应用启动管理 >“您的应用”> 关闭自动管理按钮，关闭后会弹框显示手动管理界面，将手动管理三项管理允许自启动、允许关联启动、允许后台活动都选择开启；
• 进入手机设置，在顶部搜索框搜索电池优化,左上角下拉选择所有应用，找到“您的应用”，设置为不允许；

需要说明的是这些操作都需要用户手动点击完成，并且通过这种方法只能改善被系统销毁的情况。如果因为功耗等相关问题被系统管控，服务还是会被杀死。

元服务的卡片刷新不难实现，总结来说有六种方式，可归纳为刷新绝技的六脉神剑。

少商剑：主动刷新

商阳剑：周期性刷新-定点刷新

中冲剑：周期性刷新-定时刷新

关冲剑：周期性刷新-动态定时刷新

少冲剑：监听广播刷新

少泽剑：前台Service实时刷新

大侠绝技练成，即可闯荡江湖。

【参考】

一文看懂HarmonyOS服务卡片运行原理和开发方法-华为开发者论坛 | 华为开发者联盟 (huawei.com)

时钟卡片（Java） (huawei.com)

 欲了解更多更全技术文章，欢迎访问https://developer.huawei.com/consumer/cn/forum/?ha_source=zzh