• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# Context
2
3Context模块提供了ability或application的上下文的能力，包括访问特定应用程序的资源等。
4
5> **说明：**
6>
7> 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
8> 本模块接口仅可在Stage模型下使用。
9
10## 导入模块
11
12```ts
13import common from '@ohos.app.ability.common';
14```
15
16## 属性
17
18**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
19
20| 名称          | 类型     | 可读   | 可写   | 说明      |
21| ----------- | ------ | ---- | ---- | ------- |
22| resourceManager     | resmgr.[ResourceManager](js-apis-resource-manager.md) | 是    | 否    | 资源管理对象。   |
23| applicationInfo | [ApplicationInfo](js-apis-bundle-ApplicationInfo.md) | 是    | 否    | 当前应用程序的信息。 |
24| cacheDir | string | 是    | 否    | 缓存目录。 |
25| tempDir | string | 是    | 否    | 临时目录。 |
26| filesDir | string | 是    | 否    | 文件目录。 |
27| databaseDir | string | 是    | 否    | 数据库目录。 |
28| preferencesDir | string | 是    | 否    | preferences目录。 |
29| bundleCodeDir | string | 是    | 否    | 安装包目录。不能拼接路径访问资源文件，请使用[资源管理接口](js-apis-resource-manager.md)访问资源。 |
30| distributedFilesDir | string | 是    | 否    | 分布式文件目录。 |
31| eventHub | [EventHub](js-apis-inner-application-eventHub.md) | 是    | 否    | 事件中心，提供订阅、取消订阅、触发事件对象。 |
32| area | [AreaMode](#areamode) | 是    | 否    | 文件分区信息。 |
33
34
35## Context.createBundleContext
36
37createBundleContext(bundleName: string): Context;
38
39根据包名创建安装包的上下文Context。
40
41**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
42
43**参数：**
44
45| 名称       | 类型                     | 必填   | 说明            |
46| -------- | ---------------------- | ---- | ------------- |
47| bundleName | string | 是    | 包名。 |
48
49**返回值：**
50
51| 类型 | 说明 |
52| -------- | -------- |
53| Context | 安装包的上下文Context。 |
54
55**示例：**
56
57```ts
58let bundleContext: common.Context;
59try {
60    bundleContext = this.context.createBundleContext('com.example.test');
61} catch (error) {
62    console.error('createBundleContext failed, error.code: ${error.code}, error.message: ${error.message}');
63}
64```
65
66## Context.createModuleContext
67
68createModuleContext(moduleName: string): Context;
69
70根据模块名创建上下文Context。
71
72**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
73
74**参数：**
75
76| 名称       | 类型                     | 必填   | 说明            |
77| -------- | ---------------------- | ---- | ------------- |
78| moduleName | string | 是    | 模块名。 |
79
80**返回值：**
81
82| 类型 | 说明 |
83| -------- | -------- |
84| Context | 上下文Context。 |
85
86**示例：**
87
88```ts
89<<<<<<< HEAD
90let moduleContext = this.context.createModuleContext('entry');
91=======
92let moduleContext: common.Context;
93try {
94    moduleContext = this.context.createModuleContext('entry');
95} catch (error) {
96    console.error('createModuleContext failed, error.code: ${error.code}, error.message: ${error.message}');
97}
98>>>>>>> 48a75c8e72 (Modify the secondary import module of ability)
99```
100
101## Context.createModuleContext
102
103createModuleContext(bundleName: string, moduleName: string): Context;
104
105根据包名和模块名创建上下文Context。
106
107**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
108
109**参数：**
110
111| 名称       | 类型                     | 必填   | 说明            |
112| -------- | ---------------------- | ---- | ------------- |
113| bundleName | string | 是    | 包名。 |
114| moduleName | string | 是    | 模块名。 |
115
116**返回值：**
117
118| 类型 | 说明 |
119| -------- | -------- |
120| Context | 上下文Context。 |
121
122**示例：**
123
124```ts
125let moduleContext: common.Context;
126try {
127    moduleContext = this.context.createModuleContext('com.example.test', 'entry');
128} catch (error) {
129    console.error('createModuleContext failed, error.code: ${error.code}, error.message: ${error.message}');
130}
131```
132
133## Context.getApplicationContext
134
135getApplicationContext(): ApplicationContext;
136
137获取应用上下文Context。
138
139**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
140
141**返回值：**
142
143| 类型 | 说明 |
144| -------- | -------- |
145| Context | 应用上下文Context。 |
146
147**示例：**
148
149```ts
150let applicationContext: common.Context;
151try {
152    applicationContext = this.context.getApplicationContext();
153} catch (error) {
154    console.error('getApplicationContext failed, error.code: ${error.code}, error.message: ${error.message}');
155}
156```
157
158## AreaMode
159
160文件分区
161
162**系统能力**：以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
163
164| 名称 | 值 | 说明 |
165| -------- | -------- | -------- |
166| EL1 | 0 | 设备级加密区，设备开机后可访问的数据区。 |
167| EL2 | 1 | 用户级加密区，设备开机，首次输入密码后才能够访问的数据区。 |
168