• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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| 201     | The application does not have permission to call the interface. |
48| 202     | The application is not system-app, can not use system-api. |
49| 401     | Parameter error. Possible causes: 1.Mandatory parameters are left unspecified. 2.Incorrect parameter types. |
50| 16000001 | The specified ability does not exist. |
51| 16000002 | Incorrect ability type. |
52| 16000004 | Cannot start an invisible component. |
53| 16200011 | The context does not exist. |
54| 16000050 | Internal error. |
55
56**示例：**
57
58```ts
59import { UIAbility, Want } from '@kit.AbilityKit';
60import { BusinessError } from '@kit.BasicServicesKit';
61
62export default class EntryAbility extends UIAbility {
63  onCreate() {
64    let want: Want = {
65      bundleName: 'com.ohos.uiextensionprovider',
66      abilityName: 'UIExtensionProvider',
67      moduleName: 'entry',
68      parameters: {
69        //与UIExtensionAbility在module.json5中"type"字段配置一致
70        'ability.want.params.uiExtensionType': 'sys/commonUI'
71      }
72    };
73    try {
74      let applicationContext = this.context.getApplicationContext();
75      applicationContext.preloadUIExtensionAbility(want)
76        .then(() => {
77          // 执行正常业务
78          console.info('preloadUIExtensionAbility succeed');
79        })
80        .catch((err: BusinessError) => {
81          // 处理业务逻辑错误
82          console.error('preloadUIExtensionAbility failed');
83        });
84    } catch (err) {
85      // 处理入参错误异常
86      let code = (err as BusinessError).code;
87      let message = (err as BusinessError).message;
88      console.error(`preloadUIExtensionAbility failed. code: ${code}, msg: ${message}`);
89    }
90  }
91}
92```
93