拉起许可应用跳转页

场景介绍

从6.0.2(22)版本开始，新增支持拉起许可应用跳转页功能。为实现用户在被管控期间快速跳转到许可应用的诉求，开发者可调用startAppForm接口拉起应用跳转页，页面中将展示通过接口参数传入的许可应用token对应的应用列表。用户点击其中的应用图标后能跳转到该应用。

用户体验设计

业务流程

流程说明：

1. 应用调用拉起许可应用跳转页的接口，拉起健康使用设备查询开发者是否已申请权限，以及用户是否授权。
2. 若状态为未授权，则抛出对应错误码；若状态为已授权，应用将根据传入的应用token信息获取全量应用信息，判断是否展示TrustApp，并拉起应用列表Form。
3. 用户点击跳转页中的应用，跳转到相应的应用。

接口说明

拉起许可应用跳转页的关键接口如下表所示：

接口名	描述
startAppForm(context: common.Context, appSelection: guardService.AppInfo, appSubTitle: string, displayTrustApp: boolean): Promise<void>	拉起许可应用跳转页。

开发前提

拉起许可应用跳转页需要申请用户授权，请先参考请求用户授权章节完成用户授权。

开发步骤

1. 导入相关模块。

   import { appPicker } from '@kit.ScreenTimeGuardKit';
   import { hilog } from '@kit.PerformanceAnalysisKit';
   import { BusinessError } from '@kit.BasicServicesKit';

2. 调用startAppForm，拉起许可应用跳转页。

   @Entry
   @Component
   struct TestPage {
      build() {
         Column() {
            Button("TestStartAppForm")
               .onClick(async () => {
                  try {
                     // 先调用startAppPicker获取相应应用的token
                     const tokens = await appPicker.startAppPicker(this.getUIContext().getHostContext(), { appTokens: [] });
   
                     await appPicker.startAppForm(this.getUIContext().getHostContext(), { appTokens: tokens }, "TestStartAppForm", false);
                  } catch (err) {
                     const message = (err as BusinessError).message;
                     const code = (err as BusinessError).code;
                     hilog.error(0x0000, `ScreenTimeGuard:startAppForm`, `startAppForm failed error code: ${code}, message: ${message}`);
                  }
               })
         }
      }
   }