1# ability子系统Changelog
2
3## cl.ability.1 createModuleContext接口废弃
4
5**访问级别**
6
7公开接口。
8
9**废弃原因**
10
11使用该接口创建的context无法正确获取资源。
12
13**废弃影响**
14
15该变更为兼容性变更，提供了新接口。
16
17**起始 API Level**
18
199
20
21**废弃发生版本**
22
23从OpenHarmony SDK 5.0.0.37开始。
24
25**废弃的接口/组件**
26
27|接口声明|废弃说明|替代接口|
28|-------|-------|-------|
29|createModuleContext(moduleName: string): Context|用这个接口创建的context无法正确获取资源，建议使用替代接口。|createModuleContext(context: Context, moduleName: string): Promise<Context>|
30
31**适配指导**
32
33需要使用新的替代接口，替代接口为带context入参的createModuleContext。
34
35废弃前代码示例：
36
37```ts
38import { common, UIAbility } from '@kit.AbilityKit';
39import { BusinessError } from '@kit.BasicServicesKit';
40
41export default class EntryAbility extends UIAbility {
42  onCreate() {
43    console.log('MyAbility onCreate');
44    let moduleContext: common.Context;
45    try {
46      moduleContext = this.context.createModuleContext('entry');
47    } catch (error) {
48      console.error(`createModuleContext failed, error.code: ${(error as BusinessError).code}, error.message: ${(error as BusinessError).message}`);
49    }
50  }
51}
52```
53废弃后代码示例：
54
55```ts
56import { common, UIAbility } from '@kit.AbilityKit';
57import { BusinessError } from '@kit.BasicServicesKit';
58
59export default class EntryAbility extends UIAbility {
60  onCreate() {
61    console.log('MyAbility onCreate');
62    let moduleContext: common.Context;
63    try {
64      common.createModuleContext(this.context,'entry').then((data: Context)=>{
65        moduleContext = data;
66      }).catch((err : BusinessError)=>{
67        console.error(`createModuleContext failed, error.code: ${(error as BusinessError).code}, error.message: ${(error as BusinessError).message}`);
68      })
69    } catch (error) {
70      console.error(`createModuleContext failed, error.code: ${(error as BusinessError).code}, error.message: ${(error as BusinessError).message}`);
71    }
72  }
73}
74```
75## cl.ability.2 createModuleContext接口废弃
76
77**访问级别**
78
79系统接口。
80
81**废弃原因**
82
83使用该接口创建的context无法正确获取资源。
84
85**废弃影响**
86
87该变更为兼容性变更，提供了新接口。
88
89**起始 API Level**
90
919
92
93**废弃发生版本**
94
95从OpenHarmony SDK 5.0.0.37开始。
96
97**废弃的接口/组件**
98
99|接口声明|废弃说明|替代接口|
100|-------|-------|-------|
101|createModuleContext(bundleName: string, moduleName: string): Context|用这个接口创建的context无法正确获取资源，建议使用替代接口。|createModuleContext(context: Context, bundleName: string, moduleName: string): Promise<Context>|
102
103**适配指导**
104
105需要使用新的替代接口，替代接口为带context入参的createModuleContext。
106
107废弃前代码示例：
108
109```ts
110import { common, UIAbility } from '@kit.AbilityKit';
111import { BusinessError } from '@kit.BasicServicesKit';
112
113export default class EntryAbility extends UIAbility {
114  onCreate() {
115    console.log('MyAbility onCreate');
116    let moduleContext: common.Context;
117    try {
118      moduleContext = this.context.createModuleContext('bunlename', 'entry');
119    } catch (error) {
120      console.error(`createModuleContext failed, error.code: ${(error as BusinessError).code}, error.message: ${(error as BusinessError).message}`);
121    }
122  }
123}
124```
125废弃后代码示例：
126
127```ts
128import { common, UIAbility } from '@kit.AbilityKit';
129import { BusinessError } from '@kit.BasicServicesKit';
130
131export default class EntryAbility extends UIAbility {
132  onCreate() {
133    console.log('MyAbility onCreate');
134    let moduleContext: common.Context;
135    try {
136      common.createModuleContext(this.context, 'bunlename', 'entry').then((data: Context)=>{
137        moduleContext = data;
138      }).catch((err : BusinessError)=>{
139        console.error(`createModuleContext failed, error.code: ${(error as BusinessError).code}, error.message: ${(error as BusinessError).message}`);
140      })
141    } catch (error) {
142      console.error(`createModuleContext failed, error.code: ${(error as BusinessError).code}, error.message: ${(error as BusinessError).message}`);
143    }
144  }
145}
146```
147
148## cl.ability.3 createBundleContext接口废弃
149
150**访问级别**
151
152系统接口。
153
154**废弃原因**
155
156使用该接口创建的context无法正确获取资源。
157
158**废弃影响**
159
160该变更为兼容性变更，提供了新接口。
161
162**起始 API Level**
163
1649
165
166**废弃发生版本**
167
168从OpenHarmony SDK 5.0.0.37开始。
169
170**废弃的接口/组件**
171
172|接口声明|废弃说明|替代接口|
173|-------|-------|-------|
174|createBundleContext(bundleName: string): Context|用这个接口创建的context无法正确获取资源，建议使用替代接口。|createBundleContext(context: Context, bundleName: string): Promise<Context>|
175
176**适配指导**
177
178需要使用新的替代接口，替代接口为带context入参的createBundleContext。
179
180废弃前代码示例：
181
182```ts
183import { common, UIAbility } from '@kit.AbilityKit';
184import { BusinessError } from '@kit.BasicServicesKit';
185
186export default class EntryAbility extends UIAbility {
187  onCreate() {
188    console.log('MyAbility onCreate');
189    let bundleContext: common.Context;
190    try {
191      bundleContext = this.context.createBundleContext('bundlename');
192    } catch (error) {
193      console.error(`createBundleContext failed, error.code: ${(error as BusinessError).code}, error.message: ${(error as BusinessError).message}`);
194    }
195  }
196}
197```
198废弃后代码示例：
199
200```ts
201import { common, UIAbility } from '@kit.AbilityKit';
202import { BusinessError } from '@kit.BasicServicesKit';
203
204export default class EntryAbility extends UIAbility {
205  onCreate() {
206    console.log('MyAbility onCreate');
207    let bundleContext: common.Context;
208    try {
209      common.createBundleContext(this.context,'bundlename').then((data: Context)=>{
210        bundleContext = data;
211      }).catch((err : BusinessError)=>{
212        console.error(`createBundleContext failed, error.code: ${(error as BusinessError).code}, error.message: ${(error as BusinessError).message}`);
213      })
214    } catch (error) {
215      console.error(`createBundleContext failed, error.code: ${(error as BusinessError).code}, error.message: ${(error as BusinessError).message}`);
216    }
217  }
218}
219```