电商网站开发北京,无锡做装修网站,做网站 中文字体是用什么,河南城源建设工程有限公司网站前言 本文基于Api13 上篇文章#xff0c;我们简单了解了服务卡片的相关知识#xff0c;那么这篇文章#xff0c;我们就从0到1实现一个服务卡片。
创建卡片 创建卡片很简单#xff0c;可以在Application或者在元服务中#xff0c;在你的主模块下#xff0c;任意的文件下进…前言 本文基于Api13 上篇文章我们简单了解了服务卡片的相关知识那么这篇文章我们就从0到1实现一个服务卡片。
创建卡片 创建卡片很简单可以在Application或者在元服务中在你的主模块下任意的文件下进行右键选择New-Service Widget选择你要实现静态或者动态卡片这里大家不用纠结因为在创建完成之后我们可以在form_config.json配置文件中通过isDynamic参数修改卡片类型为空或者true则是动态卡片false则为静态卡片所以在这里你选择哪一个都没问题。 目前静态提供了5个模版动态提供了4个大家可以根据实际的业务需求选择其中一个即可。 选择好一个模版之后就进入到了如下的页面也就是服务卡片的配置页面从上到下分别为Service widget name服务卡片的名字Display name卡片显示的名字description卡片的描述信息Language开发语言这里建议ArkTssupportDimensions卡片支持的外观规1 * 2表示1行2列的二宫格以此类推Ability name:卡片生命周期管理文件。 配置填完之后点击底部的Finish我们就完成了一个默认的服务卡片可以直接运行运行之后长按桌面图标后就会显示卡片的选项 点击卡片后就会展示出默认的卡片UI我们可以点击添加至桌面 这样就会在桌面上显示我们刚才创建的服务卡片 卡片目录结构 创建完之后会在我们原有的项目中生成如下文件首先是entryformability包下的EntryFormAbility文件它是卡片扩展模块主要提供卡片创建、销毁、刷新等生命周期回调widget包的pages下的WidgetCard主要是基于ArkUI提供卡片UI开发能力resources下的form_config.json配置文件主要用于配置WidgetCard相关信息。 主要文件介绍 一个卡片的配置主要是通过三个文件也就是上面目录结构中的EntryFormAbility文件、WidgetCard文件和form_config.json配置文件我们逐一进行分析一下
EntryFormAbility文件 主要是卡片扩展模块提供卡片创建、销毁、刷新等生命周期回调继承于FormExtensionAbility源码如下 export default class EntryFormAbility extends FormExtensionAbility {onAddForm(want: Want) {// Called to return a FormBindingData object.const formData ;return formBindingData.createFormBindingData(formData);}onCastToNormalForm(formId: string) {// Called when the form provider is notified that a temporary form is successfully// converted to a normal form.}onUpdateForm(formId: string) {// Called to notify the form provider to update a specified form.}onFormEvent(formId: string, message: string) {// Called when a specified message event defined by the form provider is triggered.}onRemoveForm(formId: string) {// Called to notify the form provider that a specified form has been destroyed.}onAcquireFormState(want: Want) {// Called to return a {link FormState} object.return formInfo.FormState.READY;}
} onAddForm卡片提供方接收创建卡片的通知接口formBindingData.FormBindingData对象是卡片要显示的数据onCastToNormalForm卡片提供方接收临时卡片转常态卡片的通知接口onUpdateForm卡片提供方接收携带参数的更新卡片的通知接口获取最新数据后调用formProvider的updateForm接口刷新卡片数据onFormEvent卡片提供方接收处理卡片事件的通知接口onRemoveForm卡片提供方接收销毁卡片的通知接口onAcquireFormState卡片提供方接收查询卡片状态通知接口默认返回卡片初始状态(该方法可以选择性重写)。 WidgetCard文件 主要是卡片UI视图可以在这里对卡片进行绘制支持声明式范式的部分组件、事件、动效、数据管理、状态管理能力在使用的时候可以查看官方Api中是否标记了“卡片能力”的标记如果标记了证明是可以在ArkTS卡片中使用。 form_config.json配置文件 form_config配置文件就是服务卡片配置填的那些信息如下所示 {forms: [{name: widget,displayName: $string:widget_display_name,description: $string:widget_desc,src: ./ets/widget/pages/WidgetCard.ets,uiSyntax: arkts,window: {designWidth: 720,autoDesignWidth: true},colorMode: auto,isDynamic: true,isDefault: true,updateEnabled: false,scheduledUpdateTime: 10:30,updateDuration: 1,defaultDimension: 2*2,supportDimensions: [2*2]}]
} 各个字段概述如下 相关总结 form_config配置文件里面可选的属性非常之多以上的表格并未列举全面大家在写的时候一定要去官方文档进行查阅。 本文标签HarmonyOS/服务卡片参考资料官方文档之服务卡片指导。
