目录

添加元服务卡片至桌面

场景介绍

为了快速访问和管理元服务卡片信息,用户可以将常用的元服务卡片添加到桌面。应用可通过调用应用市场服务提供的loadService接口来加载元服务卡片加桌页面,用户点击“添加至桌面”按钮,将元服务卡片添加至桌面。

业务流程

  1. 用户使用元服务卡片加桌功能。

  2. 应用调用AppGallery Kit的loadService接口。

  3. AppGallery Kit API获取应用传入的信息,生成展示页面。

  4. 展示生成的页面给用户,用户点击“添加至桌面”按钮,将元服务卡片添加至桌面。

约束与限制

接口说明

详细接口说明可参考接口文档。

接口名 描述
loadService(context: common.UIAbilityContext, want: Want, callback?: ServiceViewCallback): void 加载元服务加桌页面接口。

开发步骤

  1. 导入productViewManager模块及相关公共模块。

    import { common, Want } from '@kit.AbilityKit';
    import { BusinessError } from '@kit.BasicServicesKit';
    import { hilog } from '@kit.PerformanceAnalysisKit';
    import { productViewManager } from '@kit.AppGalleryKit';
  2. 构造元服务卡片参数。

    const TAG: string = 'LoadService';
    
    @Entry
    @Component
    struct LoadServiceView {
        context = this.getUIContext().getHostContext() as common.UIAbilityContext;
    
        build() {
            Column() {
                Button($r('app.string.load_service'))
                    .id('load_service')
                    .onClick(() => {
                        try {
                            const request: Want = {
                              // 此处填入要加载的元服务的加桌链接
                              uri: 'store://******'
                            };
    
                            const callback: productViewManager.ServiceViewCallback = {
                                // 接收元服务卡片加桌结果信息
                                onReceive: (data: productViewManager.ServiceViewReceiveData) => {
                                    hilog.info(0, TAG,
                                        `loadService onReceive.result is ${data.result}, msg is ${data.msg}, formInfo is ${JSON.stringify(
                                            data.formInfo)}`);
                                },
                                onError: (error: BusinessError) => {
                                    hilog.error(0, TAG,
                                        `loadService onError.code is ${error.code}, message is ${error.message}`)
                                },
                                // 当元服务卡片加桌页成功打开时回调
                                onAppear: () => {
                                    hilog.info(0, TAG, `loadService onAppear.`);
                                },
                                // 当元服务卡片加桌页关闭时回调
                                onDisappear: () => {
                                    hilog.info(0, TAG, `loadService onDisappear.`);
                                }
                            };
    
                            // ...
                        } catch (error) {
                            hilog.error(0, TAG,
                                `loadService failed.code is ${(error as BusinessError).code}, message is ${(error as
                                    BusinessError).message}`);
                        }
                    })
                    .width('100%')
    
            }
            .margin(16)
            .height('100%')
            .justifyContent(FlexAlign.Center)
        }
    }
  3. 调用productViewManager.loadService方法,将步骤2中构造的参数依次传入接口中。

    // 调用接口,加载元服务加桌页面
    productViewManager.loadService(this.context, request, callback);