目录

概述

使用约束

创建服务卡片

预览服务卡片

概述

服务卡片 是FA(Feature Ability)的一种主要信息呈现形式,开发者可以在卡片中展示用户最关心的FA数据,并可以通过单击卡片内容直接打开FA。服务卡片支持不同的规格尺寸,开发者可以根据展示的不同内容和布局效果,选用不同的卡片尺寸,支持的尺寸包括:1*2、2*2、2*4和4*4宫格。

不同的SDK版本提供的卡片模板不同。

API 4\5\6\7提供如下卡片模板

模板名称 支持的设备 支持的开发语言 模板描述 Image With Information(图文卡片模板) Phone/Tablet Java、 JavaScript 图文卡片模板主要在于展现图片和一定数量文本的搭配,在这种布局下,图片和文本属于同等重要的信息。在不同尺寸下,图片大小和文本数量会发生一定变化,用于凸显关键信息。

API 8提供如下卡片模板

模板名称 支持的设备 支持的开发语言 模板描述 Hello World Phone JavaScript 支持低代码开发的HelloWorld卡片。 Image With Information(图文卡片模板) Phone JavaScript 图文卡片模板主要在于展现图片和一定数量文本的搭配,在这种布局下,图片和文本属于同等重要的信息。在不同尺寸下,图片大小和文本数量会发生一定变化,用于凸显关键信息。 Immersive Information(沉浸图文卡片模板) Phone JavaScript 沉浸式卡片的装饰性较强,能够较好的提升卡片品质感并起到装饰桌面的作用,合理的去布局信息与背景图片之间的空间比例,可以提升用户的个性化使用体验。

使用约束

每个FA最多可以配置16张服务卡片。JS卡片不支持调试。

创建服务卡片

DevEco Studio提供服务卡片的一键创建功能,可以快速创建和生成服务卡片模板。

对于创建新工程,可以在工程向导中勾选Show in service center,该参数表示是否在服务中心展示,勾选该参数会同步创建服务卡片模板。 关于工程配置项详细说明请参考创建一个新的工程 。 卡片创建完成后,会在工程目录下生成EntryCard目录。 在该目录下,每个拥有EntryCard的模块,都会生成一个和模块名相同的文件夹,同时还会默认生成一张2x2的快照型EntryCard图片(png格式)。 开发者可以将其替换为提前设计好的2x2快照图:将新的快照图拷贝到上图目录下,删除默认图片,新图片命名遵循格式“卡片名称-2x2.png”。 在已有工程中添加新模块,也可以添加服务卡片和EntryCard,只需在创建模块时,勾选Show in service center即可。创建出来的服务卡片和EntryCard同创建新工程生成的一致。在已有工程中,添加EntryCard,只能通过手工方式,按照上图中的EntryCard目录创建对应的文件夹和图片。在已有工程中,新添加服务卡片,可以通过如下方法进行创建。

打开一个工程,创建服务卡片,创建方法包括如下两种方式:

选择模块(如entry模块)下的任意文件,单击菜单栏File > New > Service Widget创建服务卡片。选择模块(如entry模块)下的任意文件,单击右键 > New > Service Widget创建服务卡片。在Choose a Template for Your Service Widget界面中,选择卡片模板,单击Next。 在Configure Your Service Widget界面中,配置卡片的基本信息,包括:

Service widget name:卡片的名称,在同一个FA中,卡片名称不能重复,且只能包含大小写字母、数字和下划线。Description:卡片的描述信息。Enable Super Visual:是否选择低代码方式开发。Language:界面开发语言。Support dimensions:选择卡片的规格。部分卡片支持同时设置多种规格。Ability name:选择一个挂靠服务卡片的Page Ability,或者创建一个新的Page Ability。 说明 如果选择的Ability是继承AceAbility时,请参考JS卡片开发指导 的步骤2进行修改。 Module name:卡片所属的模块。 单击Finish完成卡片的创建。创建完成后,工具会自动创建出服务卡片的布局文件,并在config.json文件中写入服务卡片的属性字段,关于各字段的说明请参考应用配置文件说明 。 卡片创建完成后,请根据Java卡片开发指导或JS卡片开发指导,完成服务卡片的开发,详情请参考服务卡片开发指南 。

预览服务卡片

在开发服务卡片过程中,支持对卡片进行实时预览。服务卡片通过XML或JS文件进行布局设计,在开发过程中,可以对布局XML/JS文件进行实时预览,只要在XML/JS布局文件中保存了修改的源代码,在预览器中就可以实时查看布局效果。在Phone和Tablet服务卡片的预览效果中,每个尺寸的服务卡片提供3种场景的预览效果,分别为极窄(Minimum)、默认(Default)、极宽(Maximum),开发者应确保三种尺寸的显示效果均正常,以便适应不同屏幕尺寸的设备。

关于预览器的使用详细说明请参考使用预览器查看应用/服务效果 。

推荐阅读

评论可见,请评论后查看内容,谢谢!!!
 您阅读本篇文章共花了: