• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# Context
2
3> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
4> 本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
5
6
7提供开发者运行代码的上下文环境,包括应用信息、ResourceManager等信息。
8
9
10
11## 使用说明
12
13
14通过AbilityContext等继承实现。
15
16
17## 属性
18
19**系统能力**:以下各项对应的系统能力均为SystemCapability.Ability.AbilityRuntime.Core
20
21| 名称 | 参数类型 | 可读 | 可写 | 说明 |
22| -------- | -------- | -------- | -------- | -------- |
23| resourceManager | ResourceManager | 是 | 否 | ResourceManager对象。 |
24| applicationInfo | ApplicationInfo | 是 | 否 | 当前应用信息。 |
25| cacheDir | string | 是 | 否 | 应用在内部存储上的缓存路径。 |
26| tempDir | string | 是 | 否 | 应用的临时文件路径。 |
27| filesDir | string | 是 | 否 | 应用在内部存储上的文件路径。 |
28| databaseDir | string | 是 | 否 | 获取本地数据存储路径。 |
29| storageDir | string | 是 | 否 | 获取轻量级数据存储路径。 |
30| bundleCodeDir | string | 是 | 否 | 应用安装路径。 |
31| distributedFilesDir | string | 是 | 否 | 应用的分布式文件路径。 |
32| eventHub | [EventHub](js-apis-eventhub.md) | 是 | 否 | 事件中心信息。|
33
34
35## Context.createBundleContext
36
37createBundleContext(bundleName: string): Context;
38
39创建指定应用上下文。
40
41**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
42
43**参数:**
44
45| 参数名 | 类型 | 必填 | 说明 |
46| -------- | -------- | -------- | -------- |
47| bundleName | string | 是 | 应用bundle名。 |
48
49**返回值:**
50
51| 类型 | 说明 |
52| -------- | -------- |
53| Context | 对应创建应用的上下文context。 |
54
55**示例:**
56
57  ```js
58  let test = "com.example.test";
59  let context = this.context.createBundleContext(test);
60  ```
61
62
63## Context.getApplicationContext
64
65getApplicationContext(): Context;
66
67获取当前context。
68
69**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
70
71**返回值:**
72
73| 类型 | 说明 |
74| -------- | -------- |
75| Context | 当前Context 信息。 |
76
77**示例:**
78
79
80  ```js
81  // 必选项。
82  let context = this.context.getApplicationContext();
83  ```
84
85
86
87>  **说明:**
88> 当SDK :API 9版本为Canary版本时;
89
90## Context.switchArea
91
92switchArea(mode: AreaMode): void
93
94开启文件范围
95
96**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
97
98**参数:**
99
100| 参数名 | 类型                  | 必填 | 说明           |
101| ------ | --------------------- | ---- | -------------- |
102| mode   | [AreaMode](#AreaMode) | 是   | 应用bundle名。 |
103
104**示例**:
105
106```js
107var areaMode = 0
108this.context.switchArea(areaMode);
109```
110
111## AreaMode
112
113文件范围模式
114
115**系统能力**:SystemCapability.Ability.AbilityRuntime.Core
116
117| 名称 | 参数类型 | 值   |
118| ---- | -------- | ---- |
119| EL1  | number   | 0    |
120| EL2  | number   | 1    |