ArkTS待机屏保卡片开发指导
===============

从API version 23开始，Form Kit提供在设备待机屏保界面（即横屏充电锁屏状态下显示的界面）上显示卡片的能力，用以展示重要信息，旨在待机下也可陪伴用户。待机屏保卡片用于展示天气、日历等信息，并支持用户个性化定制。

本文介绍了待机屏保卡片的使用步骤、约束限制，并给出开发指导。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a6/v3/aHSoY96XQfCxV4EU8rCRqQ/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073343Z&HW-CC-Expire=86400&HW-CC-Sign=AD14ACDAB0639C1812E7FCF147A13087DE5A988282E0EA01D0992E940FDA28DF)

在待机屏保界面下默认为深色模式不会跟随系统。

#### 亮点/特征

*   丰富待机显示，提供个性美观的待机显示页面，打造全场景、个性化的“百变”心灵陪伴。
*   提供情感陪伴和情绪价值，在工作的时候，日程待办，提升工作效率；在学习的时候，作为时钟摆台，陪伴学习。

#### 约束和限制

1.  待机屏保卡片只支持 2\*2尺寸的卡片。
2.  待机屏保卡片不推荐展示用户个人隐私敏感数据。
3.  待机屏保卡片有明确的UX设计规范。具体请参考设计指南中的[待机屏保](https://developer.huawei.com/consumer/cn/doc/design-guides/system-features-service-widget-0000002087671904#section966618274556)。

#### 开启方式

待机屏保功能在系统上默认是开启的，功能开关路径“设置>桌面和个性化>待机屏保设置”，开关界面如下图。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/f6/v3/fKtlo83xT1K6WdzJUI5kuQ/zh-cn_image_0000002594668526.png?HW-CC-KV=V1&HW-CC-Date=20260612T073343Z&HW-CC-Expire=86400&HW-CC-Sign=0D4A3AA777BC2D96EE8A5133BE7C73FFA93655F0421B3F182704CA454327E98E "点击放大")

#### 使用步骤

待机屏保支持卡片展示与卡片编辑功能（添加、移除），具体操作步骤如下：

1.  进入待机屏保界面：插入充电器或开启“不充电可显示” 开关，设备横屏锁屏并与桌面夹角45°~90°稳定摆放（折叠机需切换为外屏；同时折叠机支持帐篷模式显示），即可进入待机屏保界面。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/9f/v3/kpe6G-xEQyyOaB6lMfb29Q/zh-cn_image_0000002594828454.png?HW-CC-KV=V1&HW-CC-Date=20260612T073343Z&HW-CC-Expire=86400&HW-CC-Sign=65E9A2DCF6D2C34EA271C4A1F8258F07E75ABC12151FBAA4BE66FFA04F26E596 "点击放大")
    
2.  进入待机屏保编辑界面：在待机屏保界面长按或双指捏合即可进入编辑界面。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3d/v3/y-vk2K4XQHqvBKlJR_R8pQ/zh-cn_image_0000002625187901.png?HW-CC-KV=V1&HW-CC-Date=20260612T073343Z&HW-CC-Expire=86400&HW-CC-Sign=274636796D3369D2DE5E02C38513445509BAFB59870D74BCA3164E67C3C4CEEB "点击放大")
    
3.  进入待机屏保卡片中心界面：在待机屏保编辑界面，上滑左侧或右侧列表至最后，点击“+”弹出卡片管理页面。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a6/v3/ux3FmiQqTRWVgwat7np2Lg/zh-cn_image_0000002625108045.png?HW-CC-KV=V1&HW-CC-Date=20260612T073343Z&HW-CC-Expire=86400&HW-CC-Sign=37A539114E6745D92D7AA277FEDF43801DBB994D5A7D9462A656E5A121ACCBC2 "点击放大")
    
4.  进入待机屏保卡片管理页面：在待机屏保卡片中心点击“建议”会显示推荐的卡片，或者点击应用列表中的应用，弹出对应的卡片。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/94/v3/S8vIfgi1SBena6_524O0zg/zh-cn_image_0000002594668528.png?HW-CC-KV=V1&HW-CC-Date=20260612T073343Z&HW-CC-Expire=86400&HW-CC-Sign=0DAB37B4DB7A089747DF10D5A160761CC3E74E558A0B205D0A69913536C11779 "点击放大")
    
5.  添加卡片：在待机屏保卡片管理页面，选择好卡片后，点击“添加”按钮即可添加到待机屏保界面。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/18/v3/nSe73eO_TJ63si2qNmR_vA/zh-cn_image_0000002594828456.png?HW-CC-KV=V1&HW-CC-Date=20260612T073343Z&HW-CC-Expire=86400&HW-CC-Sign=2482512A04D6D8330D16C4B6CA75A39A5B358265C066E7D9266E3F6EAE4EB5BC "点击放大")
    
6.  移除卡片：进入待机屏保编辑界面，点击卡片右上角的“-”即可移除卡片。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/9e/v3/Ys2TtBk_SCWnH0J0yI1RGA/zh-cn_image_0000002625187903.png?HW-CC-KV=V1&HW-CC-Date=20260612T073343Z&HW-CC-Expire=86400&HW-CC-Sign=D60A73E0E25187B34B21FB336679F9C4D962C727B0C6CAC08591D72E74AA7667 "点击放大")
    

#### 开发准备

#### \[h2\]待机屏保开放能力申请

待机屏保卡片会展示在设备的待机屏保界面，开发者需申请上架开放能力，用以保护数据隐私安全。

因此在应用调试或发布时，必须使用[手动签名](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-signing#section297715173233)，并在手动签名[申请Profile](https://developer.huawei.com/consumer/cn/doc/app/agc-help-debug-profile-0000002248181278)过程中[创建HarmonyOS应用](https://developer.huawei.com/consumer/cn/doc/app/agc-help-create-app-0000002247955506)，创建应用时参考如下指导为应用接入开放能力。

1.  登录AppGallery Connect，选择“开发与服务”。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b7/v3/n8uJOfa6RX6QHfHfpezyVQ/zh-cn_image_0000002594668522.png?HW-CC-KV=V1&HW-CC-Date=20260612T073343Z&HW-CC-Expire=86400&HW-CC-Sign=D5F513ED6086D6434BA930F4D830F779F97CF6E6C3FDA9E1EDDC6C61E97DC4FA "点击放大")
    
2.  在项目列表中找到您的项目，并点击选择需开启开放能力的应用/元服务。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e4/v3/-MdN4-xJQkaA0g30oy_1rw/zh-cn_image_0000002594828450.png?HW-CC-KV=V1&HW-CC-Date=20260612T073343Z&HW-CC-Expire=86400&HW-CC-Sign=9061BE8F313D35958429955EEA2808D599B51C81BB8B76A299BAD95CFA9BC5D4 "点击放大")
    
3.  在“开放能力管理”页面，点击待机屏保卡片对应的申请按钮。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/16/v3/W37x_AKLR_ulNDLQnQ3nXQ/zh-cn_image_0000002625108047.png?HW-CC-KV=V1&HW-CC-Date=20260612T073343Z&HW-CC-Expire=86400&HW-CC-Sign=ED4C0F6E704E1D1B3966AF929857EB51E8DB685C24F947761C2937C36856EA3B "点击放大")
    
4.  在“新建业务申请”窗口填写申请信息，然后点击“提交”。
    
    申请原因：必填，包括应用介绍、使用场景、申请用途，不超过512个字符。
    
    上传附件：选填，提供对应卡片UI设计释义材料，仅可上传1个附件，大小不超过500MB。支持文本、表格、图片、视频、压缩包格式。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/42/v3/BnIlTHjAQkOg8uEIEmqsvA/zh-cn_image_0000002594668530.png?HW-CC-KV=V1&HW-CC-Date=20260612T073343Z&HW-CC-Expire=86400&HW-CC-Sign=614CFC8B120BEFC73E0F58D1DE108D1A49DC868C9D768DBE98941CF553523CE7 "点击放大")
    
5.  返回“开放能力管理”页面，原“申请”按钮变为置灰显示的“申请”，待机屏保卡片的能力开关已勾选。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/0/v3/ImfhuVXiSGapxhPZYailww/zh-cn_image_0000002594828458.png?HW-CC-KV=V1&HW-CC-Date=20260612T073343Z&HW-CC-Expire=86400&HW-CC-Sign=04F55E80260C9DFB8FD75D6374AA981E5C6ED5E8208DB8A10BD5ADD91B5DC822 "点击放大")
    
    至此，您的应用已成功开通待机屏保开放能力。
    

#### 开发步骤

下面给出示例，实现待机屏保卡片展示。

1.  [创建卡片](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-ui-widget-creation)。
    
2.  配置卡片在待机屏保界面展示。
    
    如果卡片不需要展示在待机屏保界面，配置isSupported字段为false;如果卡片已适配待机屏保卡片UX规范，配置isAdapted字段为true，系统会把卡片布局组件中backgroundImage移除；如果卡片涉及隐私敏感信息，需要配置isPrivacySensitive字段为true，用户将卡片添加到待机屏保界面则会有蒙版覆盖。具体参考[配置文件字段说明](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-ui-widget-configuration#配置文件字段说明)。
    

  // entry/src/main/resources/base/profile/form\_config.json
  {
    "forms": \[
      {
        "name": "widget",
        "displayName": "$string:widget\_display\_name",
        "description": "$string:widget\_desc",
        "src": "./ets/widget/pages/WidgetCard.ets",
        "uiSyntax": "arkts",
        "isDynamic": true,
        "isDefault": true,
        "updateEnabled": false,
        "scheduledUpdateTime": "10:30",
        "renderingMode": "autoColor",
        "updateDuration": 1,
        "defaultDimension": "1\*2",
        "supportDimensions": \[
          "1\*2",
          "2\*2"
        \],
        "standby": {
          "isSupported": true,
          "isAdapted": true,
          "isPrivacySensitive": false
        }
      }
    \]
  }