• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# Ability Framework Changelog
2
3## cl.ability.1 AbilityDelegator.startAbility() Error Code Changed
4
5**Access Level**
6
7Public API
8
9**Reason for Change**
10
11All error codes returned by **AbilityDelegator.startAbility()** are inconsistent with the API documentation.
12
13**Impact of the Change**
14
15This change does not require application adaptation.
16
17The change affects all error codes returned by **AbilityDelegator.startAbility()**. The error code mapping is as follows:
18
19| Before Change   | After Change   |
20| -------- | --------  |
21| 29360128 | 401       |
22| 2097199  | 16000001  |
23| 2097187  | 16000002  |
24| 2097179  | 16000004  |
25| 2097208  | 16000005  |
26| 2097207  |16000006   |
27| 2097203  | 16000008  |
28| 11       |  16000009 |
29| 2097206  | 16000010  |
30| 2097323  | 16000011  |
31| 2097204  | 16000012  |
32| 2097215  | 16000013  |
33| 2097167  | 16000050  |
34| 5242881  | 16000053  |
35| 29360300 | 16000055  |
36| 2097205  | 16200001  |
37
38**Start API Level**
39
40API 9
41
42**Change Since**
43
44OpenHarmony SDK 6.0.0.32
45
46**Key API/Component Changes**
47
48**startAbility()** provided by AbilityDelegator
49
50**Adaptation Guide**
51
52No adaptation is required.
53
54For details about the **startAbility()** API provided by AbilityDelegator, see [startAbility](../../../application-dev/reference/apis-test-kit/js-apis-inner-application-abilityDelegator.md#startability9).
55
56## cl.ability.2 Erasing Invalid URIs When Sharing Files via Want
57
58**Access Level**
59
60Public API
61
62**Reason for Change**
63
64In file sharing scenarios (where the **flags** field of Want is configured with [wantConstant.Flags.FLAG_AUTH_READ_URI_PERMISSION](../../../application-dev/reference/apis-ability-kit/js-apis-app-ability-wantConstant.md#flags) or [wantConstant.Flags.FLAG_AUTH_WRITE_URI_PERMISSION](../../../application-dev/reference/apis-ability-kit/js-apis-app-ability-wantConstant.md#flags)), an application can pass a single URI through the **uri** field of Want, or pass multiple URIs using the **Key** value of [wantConstant.Params.PARAMS_STREAM](../../../application-dev/reference/apis-ability-kit/js-apis-app-ability-wantConstant.md#params). To ensure that the parameters passed to the target application are valid, the system proactively erases URIs that do not meet the conditions.
65
66**Impact of the Change**
67
68This change does not require application adaptation.
69
70Before change, in file sharing scenarios, if the scheme of the **uri** field in Want is empty, or the scheme of the URIs in the **wantConstant.Params.PARAMS_STREAM** field is not **file**, the system does not perform any processing.
71
72After change, in file sharing scenarios, if the scheme of the **uri** field in Want is empty, or the scheme of the URIs in the **wantConstant.Params.PARAMS_STREAM** field is not **file**, the system erases the corresponding URI values.
73
74**Start API Level**
75
76API 9
77
78**Change Since**
79
80OpenHarmony SDK 6.0.0.32
81
82**Key API/Component Changes**
83
84The APIs related to starting and exiting applications can trigger this change in file sharing scenarios. The involved interfaces are as follows:
85
86[UIAbilityContext](../../../application-dev/reference/apis-ability-kit/js-apis-inner-application-uiAbilityContext.md#uiabilitycontext):
87- startAbility(want: Want, callback: AsyncCallback<void>): void
88- startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>): void
89- startAbility(want: Want, options?: StartOptions): Promise<void>
90- startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>): void
91- startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback<AbilityResult>): void
92- startAbilityForResult(want: Want, options?: StartOptions): Promise<AbilityResult>
93- terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback<void>): void
94- terminateSelfWithResult(parameter: AbilityResult): Promise<void>
95- connectServiceExtensionAbility(want: Want, options: ConnectOptions): number
96- startAbilityByCall(want: Want): Promise<Caller>
97- startUIServiceExtensionAbility(want: Want): Promise<void>
98- connectUIServiceExtensionAbility(want: Want, callback: UIServiceExtensionConnectCallback) : Promise<UIServiceProxy>
99
100[UIExtensionContext](../../../application-dev/reference/apis-ability-kit/js-apis-inner-application-uiExtensionContext.md#uiextensioncontext):
101
102- startAbility(want: Want, callback: AsyncCallback<void>): void
103- startAbility(want: Want, options: StartOptions, callback: AsyncCallback<void>): void
104- startAbility(want: Want, options?: StartOptions): Promise<void>
105- startAbilityForResult(want: Want, callback: AsyncCallback<AbilityResult>): void
106- startAbilityForResult(want: Want, options: StartOptions, callback: AsyncCallback<AbilityResult>): void
107- startAbilityForResult(want: Want, options?: StartOptions): Promise<AbilityResult>
108- connectServiceExtensionAbility(want: Want, options: ConnectOptions): number
109- terminateSelfWithResult(parameter: AbilityResult, callback: AsyncCallback<void>): void
110- terminateSelfWithResult(parameter: AbilityResult): Promise<void>
111- startUIServiceExtensionAbility(want: Want): Promise<void>
112- connectUIServiceExtensionAbility(want: Want, callback: UIServiceExtensionConnectCallback) : Promise<UIServiceProxy>
113
114**Adaptation Guide**
115
116No adaptation is required.
117