Skip to main content
版本：v3.x

注册副屏应用和快捷卡片

介绍​

拓展系统开放能力是 Zepp OS 团队的一个重要目标，在全新推出的 2.0 版本中，我们将小程序的运行场景拓展到了副屏应用和快捷卡片。

下图为副屏应用：

widget

下图为快捷卡片：

cards

提示

副屏应用和快捷卡片是屏幕上的一个小组件，一个小程序可以包含多个独立的副屏应用或快捷卡片，副屏应用或快捷卡片必须依附于小程序存在。

警告

副屏应用和快捷卡片构造函数对 API_LEVEL 有要求，API 兼容性请参考 API_LEVEL。

开发副屏应用或者快捷卡片​

类比于小程序页面 Page 的开发方式，两者非常相似，以副屏应用举例，一共分为两步。

1. app.json 配置和文件目录组织​

首先需要在 app.json - 小程序配置 中进行入口文件和 icon 的配置。

app.json
{
  "module": {
    "app-widget": {
      "widgets": [
        {
          "path": "app-widget/index",
          "icon": "icon.png",
          "name": "app-widget-demo",
          "runtime": {
            "type": "js"
          }
        }
      ]
    }
  }
}

项目目录结构的组织参考 目录结构。

2. 应用注册与开发​

每一个副屏应用都需要在对应的 JS 文件中使用 SecondaryWidget 构造函数 进行副屏应用实例注册，指定生命周期回调、事件处理函数，挂载属性等。

提示

如果要注册快捷卡片，参考 《AppWidget 构造函数》

与 Page 生命周期略有不同，由于副屏应用和快捷卡片存在焦点特性，新加入了 onResume 和 onPause 生命周期，分别在获得焦点和失去焦点时触发。

3. 添加副屏应用或者快捷卡片​

此处列举在设备或者模拟器上的操作路径：

信息

添加副屏应用：

设置 => 使用偏好 => 副屏应用 => 界面底部的添加 icon

信息

添加快捷卡片:

快捷卡片页面下拉至最底部 => 点击设置 icon => 界面底部添加 icon