HarmonyOS 鸿蒙Next应用内拉起添加桌面卡片问题

开发者您好，问题描述中“模态框内的卡片能只展示我想选中的卡片类型”，您这边想选中的卡片类型是展示一个单独的卡片还是说需要展示一组卡片（非全部卡片）能够在模态框中进行选择。

如果是需要选择到自己需要跳转的卡片而不是通过滑动轮播图才能进行选择，可以参考以下方案：

方案一：

调用formProvider.openFormManager接口，拉起卡片管理页面，将卡片添加至桌面。 formProvider.openFormManager接口根据传入的want参数，拉起卡片管理页面并优先显示参数对应的卡片。若want参数错误，则无法拉起卡片管理页面；若want参数的parameters字段不完整或指定的卡片不存在，则默认展示form_config.json中配置的默认卡片。

• want参数需包含字段包括：
  • bundleName：卡片所属应用的包名。
  • abilityName：卡片所属的ability名称。
  • parameters：展示卡片的参数，详见下文。
• parameters需包含的字段包括：
  • ohos.extra.param.key.form_dimension：卡片尺寸，参考FormDimension。
  • ohos.extra.param.key.form_name：卡片名称，即form_config.json中卡片对应的name。
  • ohos.extra.param.key.module_name：卡片所属的模块名称。

示例代码如下：

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('添加卡片')
          .onClick(() => {
            const want: Want = {
              bundleName: 'com.example.myapplication', // 包名
              abilityName: 'EntryFormAbility', // 模块ability名称
              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%');
  }
}

方案二：

使用FormMenu组件，通过长按组件弹出“添加至桌面”菜单，将卡片添加至桌面。 以Menu组件为菜单容器，通过AddFormMenuItem添加菜单子项，根据AddFormMenuItem中传入的参数want，将指定的卡片添加至桌面，添加时会根据传入的组件ID获取组件快照和位置，用于添加桌面时的过渡动效。若want参数或组件ID错误、指定的卡片不存在或未在form_config.json中配置，则无法将卡片添加至桌面。

• want参数需包含字段包括：
  • bundleName：卡片所属应用的包名。
  • abilityName：卡片所属的ability名称。
  • parameters：展示卡片的参数，详见下文。
• parameters需包含的字段包括：
  • ohos.extra.param.key.form_dimension：卡片尺寸，参考FormDimension。
  • ohos.extra.param.key.form_name：卡片名称，即form_config.json中卡片对应的name。
  • ohos.extra.param.key.module_name：卡片所属的模块名称。

示例代码如下：

import { AddFormMenuItem } from '@kit.ArkUI';
import { formBindingData } from '@kit.FormKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

const tag = 'AddFormMenuItem';

@Entry
@Component
struct FormMenuDemo {
  private compId: string = 'addforms@d46313145';

  @Builder
  MyMenu() {
    Menu() {
      AddFormMenuItem(
        {
          bundleName: 'com.example.myapplication', // 包名
          abilityName: 'EntryFormAbility', // 模块ability名称
          parameters: {
            'ohos.extra.param.key.form_dimension': 2, // 卡片尺寸
            'ohos.extra.param.key.form_name': 'widgetImage', // 卡片名称
            'ohos.extra.param.key.module_name': 'entry' // 卡片所属的模块名称
          },
        },
        this.compId,
        {
          formBindingData: formBindingData.createFormBindingData({}),
          callback: (error, formId) => {
            hilog.info(0x3900, tag, `callback info：error = ${JSON.stringify(error)}, formId = ${formId}`);
            if (error?.code === 0) {
              hilog.info(0x3900, tag, '添加至桌面成功');
            } else {
              hilog.info(0x3900, tag, '添加至桌面失败，请尝试其它添加方式');
            }
          }
        }
      );
    };
  }

  build() {
    Row() {
      Column({ space: 36 }) {
        Text('长按图片添加卡片到桌面')
          .fontSize('18fp');

        Image($r('app.media.startIcon')) // 自定义图片
          .id(this.compId)
          .width(150)
          .height(150)
          // 绑定菜单
          .bindContextMenu(this.MyMenu, ResponseType.LongPress, {
            placement: Placement.TopLeft
          });
      }
      .width('100%');
    }
    .height('100%');
  }
}

您看下以上方案能否满足您当前的开发诉求，如果都不能满足请反馈，可以提供一下您需要的场景的更加完整的步骤。