harmony 鸿蒙应用内拉起卡片管理加桌

2025-06-12
浏览 (5)

应用内拉起卡片管理加桌

卡片开发服务支持将应用的ArkTS卡片添加到桌面。

桌面提供统一的卡片管理页面。应用通过formProvider模块提供的openFormManager接口，能够拉起卡片管理页面，触发卡片添加至桌面操作，点击“添加至桌面”，实现卡片添加至桌面的功能。

开发步骤

// entry/src/main/ets/pages/Index.ets

import { formProvider } from '@kit.FormKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { Want } from '@kit.AbilityKit';

@Entry
@Component
struct Index {

  build() {
    Row() {
      Column() {
        //添加拉起卡片管理页面按钮，点击按钮后调用openFormManager方法，拉起卡片管理页面
        Button('拉起卡片管理页面')
          .onClick(() => {
            const want: Want = {
              bundleName: 'com.example.formbutton',
              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 {
              formProvider.openFormManager(this.want);
            } catch (error) {
              console.error(`catch error, code: ${(error as BusinessError).code}, message: ${(error as BusinessError).message})`);
            }
          })
          .margin({ top: 10, bottom: 10 })
      }
      .width('100%')
    }
    .height('100%')
  }
}