干货！鸿蒙卡片开发超细致总结！

很多朋友都把自己的手机升级为了鸿蒙系统。如果你手头有两部或两部以上鸿蒙系统的手机，就可以尽情地体验鸿蒙的分布式能力了。

如果你手头只有一部鸿蒙系统的手机，不知道你有没有感知到：与升级前相比，在用户体验上有哪些变化呢？

细心体验就会发现，最大的变化非“卡片”莫属了！卡片的功能非常强大，用户无需打开应用，就可以从卡片中获取应用相关的动态信息，而且还可以与卡片进行交互。

最重要的是，在未来，卡片很可能会成为一个巨大的流量入口，从而成为第三方应用厮杀的阵地！

为了帮助大家更好地学习，我详细总结了鸿蒙卡片开发的核心技术精要，包括以下几部分：

什么是卡片

卡片的数量和尺寸

卡片与原子化服务

卡片的整体框架

使用 JS 开发卡片

使用 Java 开发卡片

开发卡片到底该使用 JS 还是使用 Java

什么是卡片

手机升级为鸿蒙系统之后，在某些应用的图标下方显示了一条横线，如下图所示：

凡是图标下方显示一条横线的应用，都可以在桌面上添加对应的卡片。

以“新浪新闻”这个应用为例，用手指按下图标的同时往上滑，就会弹出该应用的默认卡片，如下图所示：

点击卡片右上角的图钉，就将卡片固定在了桌面上，如下图所示：

卡片中的新闻会动态刷新。这样，用户无需打开应用，就可以从卡片中获取应用相关的动态信息。

点击卡片中的某一条新闻，就跳转到了应用的相关页面，如下图所示：

这个卡片设计得不是很好，最好是点击卡片中的某一条新闻，能跳转到应用内该条新闻对应的详情页面。

再以“音乐”这个应用为例，用手指按下图标的同时往上滑，就会弹出该应用的默认卡片，点击卡片右上角的图钉，就将卡片固定在了桌面上，如下图所示：

点击卡片中的按钮，可以开始播放音乐和暂停播放音乐。这样，通过与卡片进行交互，用户无需打开应用，就可以实现应用内的部分操作。

通过这两个例子，我们看到：卡片是应用内页面的展现形式，将页面的重要信息或者操作前置到卡片上，以达到服务直达、减少体验层级的目的。

卡片的数量和尺寸

我们已经知道了：卡片是应用内页面的展现形式，也就是应用内 Page Ability 的展现形式。

一个应用内包含 1~N 个 Page Ability，我们可以在 config.json 中为每个 Page Ability 配置 0~16 个卡片。

而配置的每个卡片可以有 1~4 个尺寸，因此，每个 Page Ability 对应的卡片数是 0~64。

如何查看一个应用的所有卡片呢？以“日历”这个应用为例，在桌面上长按其图标，在弹出的菜单中点击”服务卡片”，就显示出了日历这个应用的所有卡片，如下图所示：

可以通过上下滑动在卡片之间进行切换。在所有卡片中，只有一个卡片下方的按钮显示为”已设为上滑卡片”，其它卡片下方的按钮都显示为“设为上滑卡片”。

当某个卡片被设为上滑卡片之后，在桌面上用手指按下应用图标的同时往上滑，弹出的默认卡片就是该上滑卡片。

比如将最后一个月视图的卡片设为上滑卡片，如下图所示：

点击下方的按钮“设为上滑卡片”，该卡片就会等待用户将其钉在桌面上，先点击桌面的空白处将其取消，然后用手指按下应用图标的同时往上滑，弹出的默认卡片就是月视图的卡片了。

再次查看“日历”这个应用的所有卡片。对于任意一个卡片，都可以点击下方的按钮“添加到桌面”，将其添加到桌面上。

对于同一个卡片，用户可以在桌面上重复添加多个实例，如下图所示：

长按桌面上的某个卡片实例，在弹出的菜单中可以移除该卡片，也可以查看其对应应用的所有卡片。

此外，用手指按下应用图标的同时往上滑，然后长按弹出的默认卡片，也可以查看其对应应用的所有卡片。

无论一个应用有多少个卡片，卡片只有 4 种尺寸，分别是：

1×2 的微尺寸

2×2 的小尺寸

2×4 的中尺寸

4×4 的大尺寸

以“相机”这个应用为例，如下图所示：

对于 1×2 的微尺寸，会占据 1 行 2 列；对于 2×2 的小尺寸，会占据 2 行 2 列；对于 2×4 的中尺寸，会占据 2 行 4 列。

同理，对于 4×4 的大尺寸，会占据 4 行 4 列。任何一个卡片的尺寸都属于这 4 种尺寸中的其中一种。

卡片与原子化服务

与传统的需要安装的应用相比，原子化服务是应用的另外一种形态，他是可以提供特定功能的、免安装的、有独立入口的应用形态。

这里有一个非常重要的关键词：免安装。原子化服务是鸿蒙系统提供的一种面向未来的服务提供方式，他非常非常的重要，希望大家引起足够的重视。

给大家举个例子就明白什么是原子化服务了，如下图所示：

对于某个传统方式的、需要安装的“购物应用 T”，在按照原子化服务理念调整设计后，可以将“商品浏览”独立拆分为一个原子化服务 A，将“购物车”独立拆分为一个原子化服务 B，将“支付”独立拆分为一个原子化服务 C，每个原子化服务都提供了特定的功能，而且是免安装的。

用户在用到某个原子化服务时，再按需进行安装，系统程序框架会在后台自动地从原子化服务平台进行下载和安装，而无需用户显式地手动安装。

1 个原子化服务完成 1 个特定的便捷服务。原子化服务由 1 个或多个 HAP 包组成，1 个 HAP 包对应 1 个 FA 或 1 个 PA。

每个 FA 或 PA 均可独立运行，完成 1 个特定功能。原子化服务的大小不能超过 10MB。

原子化服务在桌面上是没有图标的，用户可以通过“服务中心”对原子化服务进行统一地查看、搜索和管理。

从屏幕左下角或右下角向斜上方滑动，即可进入“服务中心”，如下图所示：

在“我的服务”板块，展示了常用的服务；在“发现”板块，提供了全量的服务供用户进行管理和使用。

原子化服务在“服务中心”的显示形式为卡片，可以将其添加到桌面。这就是卡片与原子化服务的关系。

打开 DevEco Studio，创建一个 HarmonyOS 的工程，然后选择模板 Empty Ability（JS）或 Empty Ability（Java），点击按钮 Next，进入到工程配置界面，如下图所示：

其中，工程类型有两种：一种是“Service”，也就是原子化服务；另一种是“Application”，也就是传统的应用。

此外，还可以选择“是否在服务中心进行展示”。我们将工程类型指定为“原子化服务”，并且选择“在服务中心进行展示”。按照上图进行配置之后，点击按钮 Finish 以创建一个工程。

接下来，把鸿蒙手机连接到电脑上，对工程的主模块 entry 自动签名，如下图所示：

签名之后，将工程运行到鸿蒙手机上，显示出了主界面。由于该工程的类型是“原子化服务”，所以在桌面上并没有相应的图标。

由于在创建工程时选择了“在服务中心进行展示”，因此，打开服务中心，就看到了相应的入口卡片，如下图所示：

长按卡片，可以进入相应的服务，如下图所示：

点击卡片，可以将其“添加到我的服务”或”添加到桌面”

好，这样，就给大家讲清楚了卡片、原子化服务和服务中心的关系。

卡片的整体框架

华为官方给出了一张卡片的整体框架图，如下图所示：

可能很多朋友看到这张图就直接晕菜了。我们将其简化一下，如下图所示：

图的最左边是卡片提供方，要么是传统应用，要么是原子化服务。之所以将两者称之为卡片提供方，是因为传统应用或原子化服务中的 Page Ability 为卡片提供了表现素材，卡片是 Page Ability 的表现形式。

在传统应用或原子化服务中定义了卡片的生命周期回调方法。图的最右边是卡片使用方，要么是桌面，要么是服务中心。

之所以将两者称之为卡片使用方，是因为用户通过桌面或服务中心来使用卡片。图的中间是卡片管理服务，他是卡片的大管家，是卡片提供方和卡片使用方的中介和桥梁。

以卡片的定时或定点刷新为例，如果一个卡片在 config.json 中配置了定时或定点刷新，具体的流程如上图所示：

timer 事件会通知卡片管理服务

卡片管理服务会去卡片提供方的对象管理模块中找到对应的卡片提供方

卡片提供方回调卡片的生命周期刷新方法

卡片提供方将刷新数据返回给卡片管理服务

卡片管理服务根据卡片名称查找卡片使用方

卡片管理服务刷新卡片使用方的卡片

好，了解了卡片的整体框架之后，接下来，我们就正式进入到实操部分。我会首先给大家介绍如何使用 JS 开发卡片，然后再来介绍如何使用 Java 开发卡片。

使用 JS 开发卡片

①使用模板创建卡片

打开 DevEco Studio，创建一个 HarmonyOS 的工程，然后选择模板 Empty Ability（JS），点击按钮 Next，进入到工程配置界面，如下图所示：

其中，将工程类型指定为传统应用，并且不选择“在服务中心进行展示”。按照上图进行配置之后，点击按钮 Finish 以创建一个工程。

如何在一个传统应用的工程中创建卡片呢？在目录 entry 上点击右键，在弹出的菜单中选择 New，然后在弹出的子菜单中点击 Service Widget，如下图所示：

这里的 Service Widget 指的就是卡片。在模板选择界面，选择基本的模板 Grid Pattern，点击按钮 Next，进入到卡片配置界面，如下图所示：

首先配置卡片的名称和描述；然后配置卡片关联的 Page Ability；然后配置卡片的编程语言类型是 JS；接下来配置卡片的 JS 组件名称。

最后配置卡片支持的规格，其中，22 的小尺寸是必须要支持的，我们再勾选一个 12 的微尺寸。点击按钮 Finish 以创建一个卡片。

重复刚才的操作，在工程中再创建一个卡片，卡片配置界面如下图所示：

其中，卡片支持的规格，除了默认的 22 小尺寸之外，再勾选一下 24 的中尺寸和 4*4 的大尺寸。

这样，DevEco Studio 就自动帮我们生成了一些目录和文件。先打开 js 子目录，如下图所示：

其中，main_widget1 和 main_widget2 是创建卡片时配置的 JS 组件名称；index.hml 中定义了卡片中包含哪些 UI 组件。

index.css 中定义了卡片中的 UI 组件都长什么样；index.json 中定义了卡片中动态绑定的数据，此外，还可以定义 click 触发的事件，稍候会给大家详细介绍。

再打开 Java 子目录，如下图所示：

其中，MainWidget1 和 MainWidget2 是创建卡片时配置的卡片名称；在 MainAbility 中添加了卡片的生命周期回调方法，如：onCreateForm()、onUpdateForm()、onTriggerFormEvent() 等。

此外，还添加了 FormControllerManager、FormController、以及两个以 Impl 结尾的实现类，这 4 个文件到底有什么用呢？稍候给大家介绍。

最后，打开 config.json 看一下，里面自动添加了很多配置，如下图所示

MainAbility 添加了标签“forms”，这里的 form 就是卡片的意思，和 Service Widget 是一回事儿。

“forms”是一个数组，包含两个元素，分别表示我们创建的两个卡片。

顺便提一下，在前面我们有讲到：“可以在 config.json 中为每个 Page Ability 配置 0~16 个卡片”，也就是说，数组“forms”中最多可以包含 16 个元素。

上图的最下方还添加了一个标签“js”，“js”也是一个数组，包含三个元素，其中后两个元素就是两个卡片对应的 js 组件。

“name”分别是“main_widget1”和“main_widget2”，这两个值就对应着上面的标签“forms”中“jsComponentName”的两个值。

也就是说，上面的标签“forms”中卡片的 js 组件，是在下面的标签“js”中定义的。

我们再来看一下上面的标签“forms”中卡片的配置：

“isDefault”表示该卡片是否为默认的上滑卡片，也就是用手指按下应用图标的同时往上滑时弹出的卡片。

“scheduledUpdateTime”表示卡片定点刷新的时刻，采用 24 小时制，精确到分钟。

“defaultDimension“表示卡片的默认尺寸规格，取值必须在下面的“supportDimensions“所配置的列表中。

“colorMode“表示卡片的主题样式，默认值是“auto”，表示自适应，还可以取值为“dark”或“light”，分别表示深色主题和浅色主题。

“supportDimensions”表示卡片支持的尺寸规格，也就是我们在创建卡片时配置的尺寸规格。

“updateEnabled”表示卡片是否支持定时刷新或定点刷新，优先选择定时刷新。

“updateDuration“表示卡片定时刷新的周期。当取值为 0 时，表示该参数不生效；当取值为正整数 N 时，表示刷新周期为 30*N 分钟。

接下来，我们先对工程的主模块 entry 自动签名，然后看一下运行效果。

运行之后，在桌面上应用图标的下方显示了一条横线，表示该应用是支持卡片的，如下图所示：

在桌面上长按应用的图标，在弹出的菜单中点击“服务卡片”，就显示出了应用的所有卡片

上下滑动所有卡片，总共有 5 个，其中，名为 MainWidget1 的卡片有两个，尺寸分别是 12 和 22，名为 MainWidget2 的卡片有三个，尺寸分别是 22、24 和 4*4。

此外，名为 MainWidget1 的 22 的卡片被设为了上滑卡片，这是因为在 config.json 中，将“isDefault”设为了“true”，并且将“defaultDimension”设为了“22”，如下图所示：

②卡片的初始化

当我们在桌面上长按应用的图标然后显示所有卡片的时候，MainAbility 中卡片的生命周期方法 onCreateForm() 会被自动回调，方法 onCreateForm() 的实现如下图所示：

在方法 onCreateForm() 中，分别调用 intent.getLongParam()、intent.getStringParam() 和 intent.getIntParam() 获得了卡片的 id、名称和尺寸。此外，在方法 onCreateForm() 中可以进行一些卡片的初始化操作。

大家想想看，现在应用内只有 5 个卡片，假如应用内有几十个卡片，难道要把这几十个卡片的所有初始化操作都写在方法 onCreateForm() 中吗？

显然是不好的做法！为此，通过模板自动生成的代码中，为我们提供了 FormControllerManager、FormController、XxxImpl 这几个类。

其中，FormControllerManager 是卡片管理器的大管家；FormController 是卡片的管理器，他是一个抽象类。

XxxImpl 实现了 FormController，MainWidget1Impl 是名为 MainWidget1 的卡片对应的卡片控制器，MainWidget2Impl 是名为 MainWidget2 的卡片对应的卡片控制器。

这样，就可以根据卡片的名称对卡片进行独立控制了。在方法 onCreateForm() 中，首先得到 FormControllerManager 的实例，然后根据卡片 ID 得到对应的卡片控制器，也就是对应的 XxxImpl 的实例，最后调用对应的 XxxImpl 中的方法 bindFormData()。

打开 MainWidget1Impl，方法 bindFormData() 中的代码如下所示：

根据卡片的尺寸，分别设置了两个变量“mini”和“dim2X4”的值，这两个变量是子目录 main_widget1 中的 index.json 中的两个变量。

这里顺便说一下，在 index.hml 中，很多变量都使用两个花括号括了起来，这些变量的值是在程序的运行过程中动态确定的，这种技术称之为动态绑定。这些变量的初始值在 index.json 中的标签“data”中进行了定义。

所以，在方法 bindFormData() 中，根据卡片的尺寸修改了两个动态绑定的变量的值。我们对自动生成的代码再修改一下，如下图所示：

运行工程，显示所有卡片
所有卡片的标题都被修改了（尺寸最小的卡片除外，因为他本来就不显示标题）。

③卡片的定点/定时刷新

接下来，我们试一下卡片的定点刷新。打开 config.json，先将 MainWidget2 对应的标签“updateDuration”修改为 0，以关闭定时刷新，对于标签“scheduledUpdateTime”设定的时刻，当到达之后，MainAbility 中卡片的回调方法 onUpdateForm() 就会被自动调用

在方法体的最后，调用了卡片控制器的方法 updateFormData()。打开 MainWidget2Impl，在方法 updateFormData() 中，添加如下代码：

首先，将要刷新的数据存放在一个 ZSONObject 实例中，然后，将其封装在一个 FormBindingData 的实例 bindingData 中，最后，调用 MainAbility 的方法 updateForm()，并将 bindingData 作为第二个实参。

打开 config.json，将标签“scheduledUpdateTime”的值修改为当前时刻的两分钟之后。

运行工程，将 ManWidget2 对应的三个卡片都添加到桌面上，当到达设定的定点时刻之后，三个卡片的标题都刷新了，如下图所示：

④卡片的跳转事件

对于桌面上名为 MainWidget2 的三个卡片，接下来我们要实现的功能是：点击任意一个卡片中左上方的图片，都跳转到 SecondAbility 对应的页面。

新建一个名为 SecondAbility 的 Page Ability，其所在的包是 com.zrc.demos。

打开子目录 main_widget2 中的 index.json，添加如下配置：

其中，标签“actions”用于定义所有的事件，目前只定义了一个名为“startSecondAbility”的事件。

将标签“action”的值设置为“router”，表示该事件是一个跳转事件。标签“abilityName”的值指定了跳转的目标 Ability。标签“params”的值指定了跳转时携带的数据。

打开子目录 main_widget2 中的 index.hml，在标签 image 中添加一个属性 onclick，并将值设置为刚刚在 index.json 中定义的 action 的名称“startSecondAbility”，如下图所示：

打开 SecondAbilitySlice，在回调方法 onStart() 中获取跳转时携带的数据，如下图所示：