应用内拉起卡片管理加桌
===========

从API version 18开始，Form Kit提供在应用内将ArkTS卡片添加到桌面的能力，以方便用户后续便捷查看信息或快速进入应用。

#### 开发步骤

下面给出示例，实现如下功能：在应用内点击“添加卡片到桌面”按钮，拉起卡片管理页面。用户可在卡片管理页面，点击“添加至桌面”按钮，此时在桌面即可看到新添加的卡片。

1.  [创建卡片](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-ui-widget-creation)。
    
2.  通过[openFormManager](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-form-formprovider#formprovideropenformmanager18)方法在应用内添加拉起卡片管理页面入口。
    
    // entry/src/main/ets/pages/Index.ets
    import { formProvider } from '@kit.FormKit';
    import { BusinessError } from '@kit.BasicServicesKit';
    import { Want } from '@kit.AbilityKit';
    import { promptAction } from '@kit.ArkUI';
    import { hilog } from '@kit.PerformanceAnalysisKit';
    
    const DOMAIN = 0x0000;
    
    @Entry
    @Component
    struct Index {
      build() {
        Row() {
          Column() {
            // 添加拉起卡片管理页面按钮
            Button($r('app.string.open\_form\_manager\_button'))
              .onClick(() => {
                const want: Want = {
                  bundleName: "com.samples.formmanagerdemo",
                  abilityName: 'EntryFormAbility',
                  parameters: {
                    'ohos.extra.param.key.form\_dimension': 2,
                    'ohos.extra.param.key.form\_name': 'widget',
                    'ohos.extra.param.key.module\_name': 'entry'
                  },
                };
                try {
                  // 点击按钮后调用openFormManager方法，拉起卡片管理页面
                  formProvider.openFormManager(want);
                } catch (error) {
                  promptAction.openToast({ message: (error as BusinessError).message });
                  hilog.info(DOMAIN, 'testTag', 'catch error ', 'code:', (error as BusinessError).code, 'message:',
                    (error as BusinessError).message);
                }
              })
              .margin({ top: 10, bottom: 10 })
          }
          .width('100%')
        }
        .height('100%')
      }
    }
    
    资源文件如下：
    
    // entry/src/main/resources/base/element/string.json
    {
      "string": \[
        {
          "name": "open\_form\_manager\_button",
          "value": "添加应用卡片到桌面"
        }
      \]
    }
    
3.  用户可在卡片管理页面，点击“添加至桌面”或者“添加至负一屏”，此时在桌面或者负一屏即可看到新添加的卡片。结果示例如下。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/3/v3/b1Ga-t24R9-ZL_5u3FSl3Q/zh-cn_image_0000002594828446.gif?HW-CC-KV=V1&HW-CC-Date=20260612T073343Z&HW-CC-Expire=86400&HW-CC-Sign=F9B2E73F824A071FE90B34C4B8D7C689DD8152D4EEFE943B7A70E41D4C15F846)