快捷卡片

更新时间：2024-09-01 11:23:13

概述

快捷卡片是应用的特殊页面，配置为快捷卡片的页面可以被其他宿主应用作为组件引入。此特性可以使得其能跟随主应用更新，而宿主应用无需更新。

一个应用可以配置多个快捷卡片，一个快捷卡片也可以被多个宿主应用所引用。

manifest.json 文件

快捷卡片在 manifest.json 中的 widgets 对象里进行定义，参考下面定义简例：

{
  "package": "com.example.demo",
  "router": {
    "entry": "pages/Home",
    "pages": {
      "pages/Home": {
        "component": "index"
      },
      "pages/Music": {
        "component": "index"
      }
    },
    // 快捷卡片定义
    "widgets": {
      // 音乐快捷卡片
      "pages/Music": {
        "id": "music2008",
        // 快捷卡片名（必填）
        "name": "音乐服务",
        // 快捷卡片组件名（必填）
        "component": "index",
        // 可编辑路径
        "params": {
          // 快捷卡片缩略图 (必填)
          "previewImage": ["./music.png"],
          "hpw": 0
        }
      }
    }
  }
}

复制代码

router.widgets[widgetPath]

用于定义单个快捷卡片页面信息。

属性	类型	默认值	必填	描述
id	Integer	-	是	快捷卡片唯一标识
name	String	-	是	快捷卡片中文名称，用于在切换选择等显示的名称
component	String	-	是	表盘对应组件名，与 ux 文件名保持一致，例如'index' 对应 'index.ux'
params	Object	-	是	快捷卡片参数，详见下面说明

params

快捷卡片特有参数，用于快捷卡片框架加载快捷卡片和展示列表。

属性	类型	默认值	必填	描述
previewImage	String	-	是	字符串数组，数组每一项代表预览图片路径，用于在快捷卡片商店、切换选择等显示的预览图
hpw	Integer	-	否	高功耗提醒，0-无高功耗提醒，1-需要高功耗提醒，默认为 0