• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 应用内拉起卡片管理加桌
2<!--Kit: Form Kit-->
3<!--Subsystem: Ability-->
4<!--Owner: @cx983299475-->
5<!--Designer: @xueyulong-->
6<!--Tester: @chenmingze-->
7<!--Adviser: @Brilliantry_Rui-->
8
9从API version 18开始,卡片开发服务支持将应用的ArkTS卡片添加到桌面。
10
11桌面提供统一的卡片管理页面。应用通过[formProvider](../reference/apis-form-kit/js-apis-app-form-formProvider.md)模块提供的[openFormManager](../reference/apis-form-kit/js-apis-app-form-formProvider.md#formprovideropenformmanager18)接口,能够拉起卡片管理页面,触发卡片添加至桌面操作,点击“添加至桌面”,实现卡片添加至桌面的功能。
12
13## 开发步骤
14
15实现[formProvider](../reference/apis-form-kit/js-apis-app-form-formProvider.md)接口提供的[openFormManager](../reference/apis-form-kit/js-apis-app-form-formProvider.md#formprovideropenformmanager18)方法。
16
17```ts
18// entry/src/main/ets/pages/Index.ets
19
20import { formProvider } from '@kit.FormKit';
21import { BusinessError } from '@kit.BasicServicesKit';
22import { Want } from '@kit.AbilityKit';
23
24@Entry
25@Component
26struct Index {
27
28  build() {
29    Row() {
30      Column() {
31        //添加拉起卡片管理页面按钮,点击按钮后调用openFormManager方法,拉起卡片管理页面
32        Button('拉起卡片管理页面')
33          .onClick(() => {
34            const want: Want = {
35              bundleName: 'com.example.formbutton',
36              abilityName: 'EntryFormAbility',
37              parameters: {
38                'ohos.extra.param.key.form_dimension': 2,
39                'ohos.extra.param.key.form_name': 'widget',
40                'ohos.extra.param.key.module_name': 'entry'
41              },
42            };
43            try {
44              formProvider.openFormManager(want);
45            } catch (error) {
46              console.error(`catch error, code: ${(error as BusinessError).code}, message: ${(error as BusinessError).message})`);
47            }
48          })
49          .margin({ top: 10, bottom: 10 })
50      }
51      .width('100%')
52    }
53    .height('100%')
54  }
55}
56```
57