1# Account Subsystem Changelog
2
3OpenHarmony 4.0.3.2 has the following changes in account module APIs:
4
5## cl.account_os_account.1 App Account API isAccountRemovable Renamed
6
7Changed **isAccountRemovable** in the **Authenticator** class to **checkAccountRemovable**.
8
9**Change Impact**
10
11The **isAccountRemovable** API in the **Authenticator** class cannot be used from 4.0.3.2. Use **checkAccountRemovable** instead.
12
13**Key API/Component Changes**
14
15- Involved APIs:
16  ```ts
17  class Authenticator {
18    ...
19    isAccountRemovable
20    ...
21  }
22  ```
23- Before change:
24
25  ```ts
26  class Authenticator {
27    ...
28    /**
29    * Checks whether the specified account can be removed.
30    * @param name Indicates the account name.
31    * @param callback Indicates the authenticator callback.
32    * @returns void.
33    * @since 9
34    */
35    isAccountRemovable(name: string, callback: AuthCallback): void;
36    ...
37  }
38  ```
39
40- After change:
41
42  ```ts
43  class Authenticator {
44    ...
45    /**
46    * Checks whether the specified account can be removed.
47    * @param name Indicates the account name.
48    * @param callback Indicates the authenticator callback.
49    * @returns void.
50    * @since 9
51    */
52    checkAccountRemovable(name: string, callback: AuthCallback): void;
53    ...
54  }
55  ```
56
57## cl.account_os_account.2 OS Account API checkConstraintEnabled Renamed
58
59Changed **checkConstraintEnabled** to **checkOsAccountConstraintEnabled**.
60
61**Change Impact**
62
63The **checkConstraintEnabled** API cannot be used from 4.0.3.2. Use **checkOsAccountConstraintEnabled** instead.
64
65**Key API/Component Changes**
66
67- Involved APIs:
68```
69interface AccountManager {
70  ...
71  checkConstraintEnabled
72  ...
73}
74```
75
76- Before change:
77
78  ```ts
79  checkConstraintEnabled(localId: number, constraint: string, callback: AsyncCallback<boolean>): void;
80  checkConstraintEnabled(localId: number, constraint: string): Promise<boolean>;
81  ```
82
83- After change:
84
85  ```ts
86  checkOsAccountConstraintEnabled(localId: number, constraint: string, callback: AsyncCallback<boolean>): void;
87  checkOsAccountConstraintEnabled(localId: number, constraint: string): Promise<boolean>;
88  ```
89
90## cl.account_os_account.3 OS Account API **checkOsAccountConstraintEnabled** Permission Scenario Change
91
92Added an optional permission **ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS** to the **checkOsAccountConstraintEnabled** API.
93
94**Change Impact**
95
96In 4.0.3.2 and later versions, an app with the **ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS** permission can also call **checkOsAccountConstraintEnabled**.
97The use of **ohos.permission.MANAGE_LOCAL_ACCOUNTS** is not affected.
98
99**Key API/Component Changes**
100
101- Involved APIs:
102```
103interface AccountManager {
104  ...
105  checkOsAccountConstraintEnabled
106  ...
107}
108```
109
110- Before change:
111
112  ```ts
113  ...
114  * @permission ohos.permission.MANAGE_LOCAL_ACCOUNTS
115  ...
116  checkOsAccountConstraintEnabled(localId: number, constraint: string, callback: AsyncCallback<boolean>): void;
117  checkOsAccountConstraintEnabled(localId: number, constraint: string): Promise<boolean>;
118  ```
119
120- After change:
121
122  ```ts
123  ...
124  * @permission ohos.permission.MANAGE_LOCAL_ACCOUNTS or ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
125  ...
126  checkOsAccountConstraintEnabled(localId: number, constraint: string, callback: AsyncCallback<boolean>): void;
127  checkOsAccountConstraintEnabled(localId: number, constraint: string): Promise<boolean>;
128  ```
129
130## cl.account_os_account.4 OS Account API queryOsAccountLocalIdFromProcessd Renamed
131
132Changed **queryOsAccountLocalIdFromProcess** to **getOsAccountLocalId**.
133
134**Change Impact**
135
136The **queryOsAccountLocalIdFromProcess** API cannot be used from 4.0.3.2. Use **getOsAccountLocalId** instead.
137
138**Key API/Component Changes**
139
140- Involved APIs:
141```
142interface AccountManager {
143  ...
144  queryOsAccountLocalIdFromProcess
145  ...
146}
147```
148- Before change:
149
150  ```ts
151  queryOsAccountLocalIdFromProcess(callback: AsyncCallback<number>): void;
152  queryOsAccountLocalIdFromProcess(): Promise<number>;
153  ```
154
155- After change:
156
157  ```ts
158  getOsAccountLocalId(callback: AsyncCallback<number>): void;
159  getOsAccountLocalId(): Promise<number>;
160  ```
161
162## cl.account_os_account.5 OS Account API queryOsAccountLocalIdFromUid Renamed
163
164Changed **queryOsAccountLocalIdFromUid** to **getOsAccountLocalIdForUid**.
165
166**Change Impact**
167
168The **queryOsAccountLocalIdFromUid** API cannot be used from 4.0.3.2. Use **getOsAccountLocalIdForUid** instead.
169
170**Key API/Component Changes**
171
172- Involved APIs:
173```
174interface AccountManager {
175  ...
176  queryOsAccountLocalIdFromUid
177  ...
178}
179```
180
181- Before change:
182
183  ```ts
184  queryOsAccountLocalIdFromUid(uid: number, callback: AsyncCallback<number>): void;
185  queryOsAccountLocalIdFromUid(uid: number): Promise<number>;
186  ```
187
188- After change:
189
190  ```ts
191  getOsAccountLocalIdForUid(uid: number, callback: AsyncCallback<number>): void;
192  getOsAccountLocalIdForUid(uid: number): Promise<number>;
193  ```
194
195## cl.account_os_account.6 OS Account API queryOsAccountLocalIdFromDomain Renamed
196
197Changed **queryOsAccountLocalIdFromDomain** to **getOsAccountLocalIdForDomain**.
198
199**Change Impact**
200
201The **queryOsAccountLocalIdFromDomain** API cannot be used from 4.0.3.2. Use **getOsAccountLocalIdForDomain** instead.
202
203**Key API/Component Changes**
204
205- Involved APIs:
206```
207interface AccountManager {
208  ...
209  queryOsAccountLocalIdFromDomain
210  ...
211}
212```
213
214- Before change:
215
216  ```ts
217  queryOsAccountLocalIdFromDomain(domainInfo: DomainAccountInfo, callback: AsyncCallback<number>): void;
218  queryOsAccountLocalIdFromDomain(domainInfo: DomainAccountInfo): Promise<number>;
219  ```
220
221- After change:
222
223  ```ts
224  getOsAccountLocalIdForDomain(domainInfo: DomainAccountInfo, callback: AsyncCallback<number>): void;
225  getOsAccountLocalIdForDomain(domainInfo: DomainAccountInfo): Promise<number>;
226  ```
227
228## cl.account_os_account.7 OS Account API getActivatedOsAccountIds Renamed
229
230Changed **getActivatedOsAccountIds** to **getActivatedOsAccountLocalIds**.
231
232**Change Impact**
233
234The **getActivatedOsAccountIds** API cannot be used from 4.0.3.2. Use **getActivatedOsAccountLocalIds** instead.
235
236**Key API/Component Changes**
237
238- Involved APIs:
239```
240interface AccountManager {
241  ...
242  getActivatedOsAccountIds
243  ...
244}
245```
246
247- Before change:
248
249  ```ts
250  getActivatedOsAccountIds(callback: AsyncCallback<Array<number>>): void;
251  getActivatedOsAccountIds(): Promise<Array<number>>;
252  ```
253
254- After change:
255
256  ```ts
257  getActivatedOsAccountLocalIds(callback: AsyncCallback<Array<number>>): void;
258  getActivatedOsAccountLocalIds(): Promise<Array<number>>;
259  ```
260
261## cl.account_os_account.8 OS Account API queryOsAccountLocalIdBySerialNumber Renamed
262
263Changed **queryOsAccountLocalIdBySerialNumber** to **getOsAccountLocalIdForSerialNumber**.
264
265**Change Impact**
266
267The **queryOsAccountLocalIdBySerialNumber** API cannot be used from 4.0.3.2. Use **getOsAccountLocalIdForSerialNumber** instead.
268
269**Key API/Component Changes**
270
271- Involved APIs:
272```
273interface AccountManager {
274  ...
275  queryOsAccountLocalIdBySerialNumber
276  ...
277}
278```
279
280- Before change:
281
282  ```ts
283  queryOsAccountLocalIdBySerialNumber(serialNumber: number, callback: AsyncCallback<number>): void;
284  queryOsAccountLocalIdBySerialNumber(serialNumber: number): Promise<number>;
285  ```
286
287- After change:
288
289  ```ts
290  getOsAccountLocalIdForSerialNumber(serialNumber: number, callback: AsyncCallback<number>): void;
291  getOsAccountLocalIdForSerialNumber(serialNumber: number): Promise<number>;
292  ```
293
294## cl.account_os_account.9 OS Account API querySerialNumberByOsAccountLocalId Renamed
295
296Changed **querySerialNumberByOsAccountLocalId** to **getSerialNumberForOsAccountLocalId**.
297
298**Change Impact**
299
300The **querySerialNumberByOsAccountLocalId** API cannot be used from 4.0.3.2. Use **getSerialNumberForOsAccountLocalId** instead.
301
302**Key API/Component Changes**
303
304- Involved APIs:
305```
306interface AccountManager {
307  ...
308  querySerialNumberByOsAccountLocalId
309  ...
310}
311```
312
313- Before change:
314
315  ```ts
316  querySerialNumberByOsAccountLocalId(localId: number, callback: AsyncCallback<number>): void;
317  querySerialNumberByOsAccountLocalId(localId: number): Promise<number>;
318  ```
319
320- After change:
321
322  ```ts
323  getSerialNumberForOsAccountLocalId(localId: number, callback: AsyncCallback<number>): void;
324  getSerialNumberForOsAccountLocalId(localId: number): Promise<number>;
325  ```
326
327## cl.account_os_account.10 OS Account API getBundleIdFromUid Renamed
328
329Changed **getBundleIdFromUid** to **getBundleIdForUid**.
330
331**Change Impact**
332
333The **getBundleIdFromUid** API cannot be used from 4.0.3.2. Use **getBundleIdForUid** instead.
334
335**Key API/Component Changes**
336
337- Involved APIs:
338```
339interface AccountManager {
340  ...
341  getBundleIdFromUid
342  ...
343}
344```
345
346- Before change:
347
348  ```ts
349  getBundleIdFromUid(uid: number, callback: AsyncCallback<number>): void;
350  getBundleIdFromUid(uid: number): Promise<number>;
351  ```
352
353- After change:
354
355  ```ts
356  getBundleIdForUid(uid: number, callback: AsyncCallback<number>): void;
357  getBundleIdForUid(uid: number): Promise<number>;
358  ```
359
360## cl.account_os_account.11 OS Account API queryOsAccountConstraintSourceTypes Renamed
361
362Changed **queryOsAccountConstraintSourceTypes** to **getOsAccountConstraintSourceTypes**.
363
364**Change Impact**
365
366The **queryOsAccountConstraintSourceTypes** API cannot be used from 4.0.3.2. Use **getOsAccountConstraintSourceTypes** instead.
367
368**Key API/Component Changes**
369
370- Involved APIs:
371```
372interface AccountManager {
373  ...
374  queryOsAccountConstraintSourceTypes
375  ...
376}
377```
378
379- Before change:
380
381  ```ts
382  queryOsAccountConstraintSourceTypes(localId: number, constraint: string, callback: AsyncCallback<Array<ConstraintSourceTypeInfo>>): void;
383  queryOsAccountConstraintSourceTypes(localId: number, constraint: string): Promise<Array<ConstraintSourceTypeInfo>>;
384  ```
385
386- After change:
387
388  ```ts
389  getOsAccountConstraintSourceTypes(localId: number, constraint: string, callback: AsyncCallback<Array<ConstraintSourceTypeInfo>>): void;
390  getOsAccountConstraintSourceTypes(localId: number, constraint: string): Promise<Array<ConstraintSourceTypeInfo>>;
391  ```
392