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_ACCOUNTS。 93 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 ```