# 拉起应用选择页

#### 场景介绍

在需要为指定应用设置管控规则的场景下，管控应用通过调用拉起应用选择页的接口拉起选择页后，使得用户能够选择目标应用。在用户选择完毕并点击完成按钮后，接口会返回选中应用的token。管控应用获取到目标应用的token后，可以根据token为选定应用设置管控规则。

#### 用户体验设计

#### 业务流程

流程说明：

1.  应用调用拉起应用选择页的接口，拉起健康使用设备查询开发者是否已申请权限，以及用户是否授权。
    
2.  若状态为未授权，则抛出对应错误码；若状态为已授权，应用将拉起应用选择列表，并根据传入应用token信息预勾选对应应用。
    
3.  应用选择页将用户选中的应用列表转化为token列表返回给调用接口的应用。
    

#### 接口说明

拉起应用选择页关键接口如下表所示：

| 接口名 | 描述 |
| --- | --- |
| startAppPicker(context: common.Context, appSelection: guardService.AppInfo): Promise<string[]> | 拉起应用选择页。 |

1.  应用选择页面中的应用列表不包含的系统应用包括：电话、联系人、设置、未成年模式等。
    
2.  应用选择页面中的应用列表不包含管控发起应用本身和已授权的管控应用。
    

#### 开发前提

拉起应用选择页需要申请用户授权，请先参考请求用户授权章节完成用户授权。

#### 开发步骤

1.  导入相关模块。
    
    ```
    import { appPicker } from '@kit.ScreenTimeGuardKit';
    import { BusinessError } from '@kit.BasicServicesKit';
    import { hilog } from '@kit.PerformanceAnalysisKit';
    ```
    
2.  调用startAppPicker，拉起应用选择页。
    
    ```
    private async getAppTokens(selectedAppTokens: string[]): Promise<string[]> {
      try {
        let newSelectedAppTokens: string[] =
          await appPicker.startAppPicker(this.getUIContext().getHostContext(), { appTokens: selectedAppTokens });
        return newSelectedAppTokens;
      } catch(error) {
        let err: BusinessError = error as BusinessError;
        hilog.error(0x0000, 'GuardService',
          `startAppPicker fail, errCode is ${err.code}, errMessage is ${err.message}`);
        return selectedAppTokens;
      }
    }
    ```