1# 帐号子系统ChangeLog
2
3OpenHarmony4.0.3.2版本相较于OpenHarmony之前的版本,帐号模块的API变更如下。
4
5## cl.account_os_account.1 应用帐号isAccountRemovable命名变更
6
7类Authenticator中的成员函数isAccountRemovable由于命名不统一问题,名称变更为checkAccountRemovable。
8
9**变更影响**
10
11类Authenticator中的成员函数isAccountRemovable,在4.0.3.2版本及后续版本中无法继续正常使用,由checkAccountRemovable代替。
12
13**关键的接口/组件变更**
14
15- 涉及接口
16  ```ts
17  class Authenticator {
18    ...
19    isAccountRemovable
20    ...
21  }
22  ```
23- 变更前:
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- 变更后:
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 系统帐号checkConstraintEnabled命名变更
58
59checkConstraintEnabled由于命名不统一问题,名称变更为checkOsAccountConstraintEnabled。
60
61**变更影响**
62
63checkConstraintEnabled接口,在4.0.3.2版本及后续版本中无法继续正常使用,由checkOsAccountConstraintEnabled代替。
64
65**关键的接口/组件变更**
66
67- 涉及接口
68```
69interface AccountManager {
70  ...
71  checkConstraintEnabled
72  ...
73}
74```
75
76- 变更前:
77
78  ```ts
79  checkConstraintEnabled(localId: number, constraint: string, callback: AsyncCallback<boolean>): void;
80  checkConstraintEnabled(localId: number, constraint: string): Promise<boolean>;
81  ```
82
83- 变更后:
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 系统帐号checkOsAccountConstraintEnabled权限场景变更
91
92checkOsAccountConstraintEnabled接口的权限管控新增可选权限:ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS93
94**变更影响**
95
96在4.0.3.2版本及后续版本中,应用申请ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS权限亦可调用checkOsAccountConstraintEnabled,
97切此前版本申请ohos.permission.MANAGE_LOCAL_ACCOUNTS权限的不影响使用
98
99**关键的接口/组件变更**
100
101- 涉及接口
102```
103interface AccountManager {
104  ...
105  checkOsAccountConstraintEnabled
106  ...
107}
108```
109
110- 变更前:
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- 变更后:
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 系统帐号queryOsAccountLocalIdFromProcessd命名变更
131
132queryOsAccountLocalIdFromProcess由于命名不统一问题,名称变更为getOsAccountLocalId。
133
134**变更影响**
135
136queryOsAccountLocalIdFromProcess接口,在4.0.3.2版本及后续版本中无法继续正常使用,由getOsAccountLocalId代替。
137
138**关键的接口/组件变更**
139
140- 涉及接口
141```
142interface AccountManager {
143  ...
144  queryOsAccountLocalIdFromProcess
145  ...
146}
147```
148- 变更前:
149
150  ```ts
151  queryOsAccountLocalIdFromProcess(callback: AsyncCallback<number>): void;
152  queryOsAccountLocalIdFromProcess(): Promise<number>;
153  ```
154
155- 变更后:
156
157  ```ts
158  getOsAccountLocalId(callback: AsyncCallback<number>): void;
159  getOsAccountLocalId(): Promise<number>;
160  ```
161
162## cl.account_os_account.5 系统帐号queryOsAccountLocalIdFromUid命名变更
163
164queryOsAccountLocalIdFromUid由于命名不统一问题,名称变更为getOsAccountLocalIdForUid。
165
166**变更影响**
167
168queryOsAccountLocalIdFromUid接口,在4.0.3.2版本及后续版本中无法继续正常使用,由getOsAccountLocalIdForUid代替。
169
170**关键的接口/组件变更**
171
172- 涉及接口
173```
174interface AccountManager {
175  ...
176  queryOsAccountLocalIdFromUid
177  ...
178}
179```
180
181- 变更前:
182
183  ```ts
184  queryOsAccountLocalIdFromUid(uid: number, callback: AsyncCallback<number>): void;
185  queryOsAccountLocalIdFromUid(uid: number): Promise<number>;
186  ```
187
188- 变更后:
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 系统帐号queryOsAccountLocalIdFromDomain命名变更
196
197queryOsAccountLocalIdFromDomain由于命名不统一问题,名称变更为getOsAccountLocalIdForDomain。
198
199**变更影响**
200
201queryOsAccountLocalIdFromDomain接口,在4.0.3.2版本及后续版本中无法继续正常使用,由getOsAccountLocalIdForDomain代替。
202
203**关键的接口/组件变更**
204
205- 涉及接口
206```
207interface AccountManager {
208  ...
209  queryOsAccountLocalIdFromDomain
210  ...
211}
212```
213
214- 变更前:
215
216  ```ts
217  queryOsAccountLocalIdFromDomain(domainInfo: DomainAccountInfo, callback: AsyncCallback<number>): void;
218  queryOsAccountLocalIdFromDomain(domainInfo: DomainAccountInfo): Promise<number>;
219  ```
220
221- 变更后:
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 系统帐号getActivatedOsAccountIds命名变更
229
230getActivatedOsAccountIds由于命名不统一问题,名称变更为getActivatedOsAccountLocalIds。
231
232**变更影响**
233
234getActivatedOsAccountIds接口,在4.0.3.2版本及后续版本中无法继续正常使用,由getActivatedOsAccountLocalIds代替。
235
236**关键的接口/组件变更**
237
238- 涉及接口
239```
240interface AccountManager {
241  ...
242  getActivatedOsAccountIds
243  ...
244}
245```
246
247- 变更前:
248
249  ```ts
250  getActivatedOsAccountIds(callback: AsyncCallback<Array<number>>): void;
251  getActivatedOsAccountIds(): Promise<Array<number>>;
252  ```
253
254- 变更后:
255
256  ```ts
257  getActivatedOsAccountLocalIds(callback: AsyncCallback<Array<number>>): void;
258  getActivatedOsAccountLocalIds(): Promise<Array<number>>;
259  ```
260
261## cl.account_os_account.8 系统帐号queryOsAccountLocalIdBySerialNumber命名变更
262
263queryOsAccountLocalIdBySerialNumber由于命名不统一问题,名称变更为getOsAccountLocalIdForSerialNumber。
264
265**变更影响**
266
267queryOsAccountLocalIdBySerialNumber接口,在4.0.3.2版本及后续版本中无法继续正常使用,由getOsAccountLocalIdForSerialNumber代替。
268
269**关键的接口/组件变更**
270
271- 涉及接口
272```
273interface AccountManager {
274  ...
275  queryOsAccountLocalIdBySerialNumber
276  ...
277}
278```
279
280- 变更前:
281
282  ```ts
283  queryOsAccountLocalIdBySerialNumber(serialNumber: number, callback: AsyncCallback<number>): void;
284  queryOsAccountLocalIdBySerialNumber(serialNumber: number): Promise<number>;
285  ```
286
287- 变更后:
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 系统帐号querySerialNumberByOsAccountLocalId命名变更
295
296querySerialNumberByOsAccountLocalId由于命名不统一问题,名称变更为getSerialNumberForOsAccountLocalId。
297
298**变更影响**
299
300querySerialNumberByOsAccountLocalId接口,在4.0.3.2版本及后续版本中无法继续正常使用,由getSerialNumberForOsAccountLocalId代替。
301
302**关键的接口/组件变更**
303
304- 涉及接口
305```
306interface AccountManager {
307  ...
308  querySerialNumberByOsAccountLocalId
309  ...
310}
311```
312
313- 变更前:
314
315  ```ts
316  querySerialNumberByOsAccountLocalId(localId: number, callback: AsyncCallback<number>): void;
317  querySerialNumberByOsAccountLocalId(localId: number): Promise<number>;
318  ```
319
320- 变更后:
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 系统帐号getBundleIdFromUid命名变更
328
329getBundleIdFromUid由于命名不统一问题,名称变更为getBundleIdForUid。
330
331**变更影响**
332
333getBundleIdFromUid接口,在4.0.3.2版本及后续版本中无法继续正常使用,由getBundleIdForUid代替。
334
335**关键的接口/组件变更**
336
337- 涉及接口
338```
339interface AccountManager {
340  ...
341  getBundleIdFromUid
342  ...
343}
344```
345
346- 变更前:
347
348  ```ts
349  getBundleIdFromUid(uid: number, callback: AsyncCallback<number>): void;
350  getBundleIdFromUid(uid: number): Promise<number>;
351  ```
352
353- 变更后:
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 系统帐号queryOsAccountConstraintSourceTypes命名变更
361
362queryOsAccountConstraintSourceTypes由于命名不统一问题,名称变更为getOsAccountConstraintSourceTypes。
363
364**变更影响**
365
366queryOsAccountConstraintSourceTypes接口,在4.0.3.2版本及后续版本中无法继续正常使用,由getOsAccountConstraintSourceTypes代替。
367
368**关键的接口/组件变更**
369
370- 涉及接口
371```
372interface AccountManager {
373  ...
374  queryOsAccountConstraintSourceTypes
375  ...
376}
377```
378
379- 变更前:
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- 变更后:
387
388  ```ts
389  getOsAccountConstraintSourceTypes(localId: number, constraint: string, callback: AsyncCallback<Array<ConstraintSourceTypeInfo>>): void;
390  getOsAccountConstraintSourceTypes(localId: number, constraint: string): Promise<Array<ConstraintSourceTypeInfo>>;
391  ```