1# ApplicationContext(系统接口)
2
3ApplicationContext模块继承自[Context](js-apis-inner-application-context.md)，提供开发者应用级别的的上下文的能力，包括提供注册及取消注册应用内组件生命周期的监听接口。
4
5> **说明：**
6>
7> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
8> 当前页面仅包含本模块的系统接口，其他公开接口参见[ApplicationContext](js-apis-inner-application-applicationContext.md)。
9
10## 导入模块
11
12```ts
13import { common } from '@kit.AbilityKit';
14```
15
16## 使用说明
17
18在使用ApplicationContext的功能前，需要通过context的实例获取。
19
20## ApplicationContext.preloadUIExtensionAbility<sup>12+</sup>
21
22preloadUIExtensionAbility(want: Want): Promise\<void\>
23
24预加载指定UIExtensionAbility实例。
25被预加载的UIExtensionAbility实例会执行到UIExtensionAbility的OnCreate生命周期，然后等待被当前应用正式加载。支持多次预加载UIExtensionAbility实例，每次正式加载时，会使一个预加载的UIExtensionAbility实例从OnCreate继续完成UIExtensionAbility的生命周期。
26
27**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
28
29**系统接口**：此接口为系统接口。
30
31| 参数名 | 类型 | 必填 | 说明 |
32| -------- | -------- | -------- | -------- |
33| want | [Want](js-apis-app-ability-want.md)  | 是 | 预加载UIExtensionAbility的want信息。 |
34
35**返回值：**
36
37| 类型 | 说明 |
38| -------- | -------- |
39| Promise&lt;void&gt; | Promise对象。无返回结果的Promise对象。 |
40
41**错误码：**
42
43以下错误码详细介绍请参考[通用错误码](../errorcode-universal.md)和[元能力子系统错误码](errorcode-ability.md)。
44
45| 错误码ID | 错误信息 |
46| ------- | -------------------------------- |
47| 401 | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified. 2.Incorrect parameter types. |
48| 16000001 | The specified ability does not exist. |
49| 16000002 | Incorrect ability type. |
50| 16000004 | Failed to start the invisible ability. |
51| 16200011 | The context does not exist. |
52| 16000050 | Internal error. |
53
54**示例：**
55
56```ts
57import { UIAbility, Want } from '@kit.AbilityKit';
58import { BusinessError } from '@kit.BasicServicesKit';
59
60export default class EntryAbility extends UIAbility {
61  onCreate() {
62    let want: Want = {
63      bundleName: 'com.ohos.uiextensionprovider',
64      abilityName: 'UIExtensionProvider',
65      moduleName: 'entry',
66      parameters: {
67        //与UIExtensionAbility在module.json5中"type"字段配置一致
68        'ability.want.params.uiExtensionType': 'sys/commonUI'
69      }
70    };
71    try {
72      let applicationContext = this.context.getApplicationContext();
73      applicationContext.preloadUIExtensionAbility(want)
74        .then(() => {
75          // 执行正常业务
76          console.info('preloadUIExtensionAbility succeed');
77        })
78        .catch((err: BusinessError) => {
79          // 处理业务逻辑错误
80          console.error('preloadUIExtensionAbility failed');
81        });
82    } catch (err) {
83      // 处理入参错误异常
84      let code = (err as BusinessError).code;
85      let message = (err as BusinessError).message;
86      console.error(`preloadUIExtensionAbility failed. code: ${code}, msg: ${message}`);
87    }
88  }
89}
90```
91