63671c01创建于 2023年3月1日历史提交

帐号子系统ChangeLog

OpenHarmony4.0.3.2版本相较于OpenHarmony之前的版本,帐号模块的API变更如下。

cl.account_os_account.1 应用帐号isAccountRemovable命名变更

类Authenticator中的成员函数isAccountRemovable由于命名不统一问题,名称变更为checkAccountRemovable。

变更影响

类Authenticator中的成员函数isAccountRemovable,在4.0.3.2版本及后续版本中无法继续正常使用,由checkAccountRemovable代替。

关键的接口/组件变更

  • 涉及接口

    class Authenticator {
      ...
      isAccountRemovable
      ...
    }
    
  • 变更前:

    class Authenticator {
      ...
      /**
      * Checks whether the specified account can be removed.
      * @param name Indicates the account name.
      * @param callback Indicates the authenticator callback.
      * @returns void.
      * @since 9
      */
      isAccountRemovable(name: string, callback: AuthCallback): void;
      ...
    }
    
  • 变更后:

    class Authenticator {
      ...
      /**
      * Checks whether the specified account can be removed.
      * @param name Indicates the account name.
      * @param callback Indicates the authenticator callback.
      * @returns void.
      * @since 9
      */
      checkAccountRemovable(name: string, callback: AuthCallback): void;
      ...
    }
    

cl.account_os_account.2 系统帐号checkConstraintEnabled命名变更

checkConstraintEnabled由于命名不统一问题,名称变更为checkOsAccountConstraintEnabled。

变更影响

checkConstraintEnabled接口,在4.0.3.2版本及后续版本中无法继续正常使用,由checkOsAccountConstraintEnabled代替。

关键的接口/组件变更

  • 涉及接口
interface AccountManager {
  ...
  checkConstraintEnabled
  ...
}
  • 变更前:

    checkConstraintEnabled(localId: number, constraint: string, callback: AsyncCallback<boolean>): void;
    checkConstraintEnabled(localId: number, constraint: string): Promise<boolean>;
    
  • 变更后:

    checkOsAccountConstraintEnabled(localId: number, constraint: string, callback: AsyncCallback<boolean>): void;
    checkOsAccountConstraintEnabled(localId: number, constraint: string): Promise<boolean>;
    

cl.account_os_account.3 系统帐号checkOsAccountConstraintEnabled权限场景变更

checkOsAccountConstraintEnabled接口的权限管控新增可选权限:ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS。

变更影响

在4.0.3.2版本及后续版本中,应用申请ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS权限亦可调用checkOsAccountConstraintEnabled, 切此前版本申请ohos.permission.MANAGE_LOCAL_ACCOUNTS权限的不影响使用

关键的接口/组件变更

  • 涉及接口
interface AccountManager {
  ...
  checkOsAccountConstraintEnabled
  ...
}
  • 变更前:

    ...
    * @permission ohos.permission.MANAGE_LOCAL_ACCOUNTS
    ...
    checkOsAccountConstraintEnabled(localId: number, constraint: string, callback: AsyncCallback<boolean>): void;
    checkOsAccountConstraintEnabled(localId: number, constraint: string): Promise<boolean>;
    
  • 变更后:

    ...
    * @permission ohos.permission.MANAGE_LOCAL_ACCOUNTS or ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS
    ...
    checkOsAccountConstraintEnabled(localId: number, constraint: string, callback: AsyncCallback<boolean>): void;
    checkOsAccountConstraintEnabled(localId: number, constraint: string): Promise<boolean>;
    

cl.account_os_account.4 系统帐号queryOsAccountLocalIdFromProcessd命名变更

queryOsAccountLocalIdFromProcess由于命名不统一问题,名称变更为getOsAccountLocalId。

变更影响

queryOsAccountLocalIdFromProcess接口,在4.0.3.2版本及后续版本中无法继续正常使用,由getOsAccountLocalId代替。

关键的接口/组件变更

  • 涉及接口
interface AccountManager {
  ...
  queryOsAccountLocalIdFromProcess
  ...
}
  • 变更前:

    queryOsAccountLocalIdFromProcess(callback: AsyncCallback<number>): void;
    queryOsAccountLocalIdFromProcess(): Promise<number>;
    
  • 变更后:

    getOsAccountLocalId(callback: AsyncCallback<number>): void;
    getOsAccountLocalId(): Promise<number>;
    

cl.account_os_account.5 系统帐号queryOsAccountLocalIdFromUid命名变更

queryOsAccountLocalIdFromUid由于命名不统一问题,名称变更为getOsAccountLocalIdForUid。

变更影响

queryOsAccountLocalIdFromUid接口,在4.0.3.2版本及后续版本中无法继续正常使用,由getOsAccountLocalIdForUid代替。

关键的接口/组件变更

  • 涉及接口
interface AccountManager {
  ...
  queryOsAccountLocalIdFromUid
  ...
}
  • 变更前:

    queryOsAccountLocalIdFromUid(uid: number, callback: AsyncCallback<number>): void;
    queryOsAccountLocalIdFromUid(uid: number): Promise<number>;
    
  • 变更后:

    getOsAccountLocalIdForUid(uid: number, callback: AsyncCallback<number>): void;
    getOsAccountLocalIdForUid(uid: number): Promise<number>;
    

cl.account_os_account.6 系统帐号queryOsAccountLocalIdFromDomain命名变更

queryOsAccountLocalIdFromDomain由于命名不统一问题,名称变更为getOsAccountLocalIdForDomain。

变更影响

queryOsAccountLocalIdFromDomain接口,在4.0.3.2版本及后续版本中无法继续正常使用,由getOsAccountLocalIdForDomain代替。

关键的接口/组件变更

  • 涉及接口
interface AccountManager {
  ...
  queryOsAccountLocalIdFromDomain
  ...
}
  • 变更前:

    queryOsAccountLocalIdFromDomain(domainInfo: DomainAccountInfo, callback: AsyncCallback<number>): void;
    queryOsAccountLocalIdFromDomain(domainInfo: DomainAccountInfo): Promise<number>;
    
  • 变更后:

    getOsAccountLocalIdForDomain(domainInfo: DomainAccountInfo, callback: AsyncCallback<number>): void;
    getOsAccountLocalIdForDomain(domainInfo: DomainAccountInfo): Promise<number>;
    

cl.account_os_account.7 系统帐号getActivatedOsAccountIds命名变更

getActivatedOsAccountIds由于命名不统一问题,名称变更为getActivatedOsAccountLocalIds。

变更影响

getActivatedOsAccountIds接口,在4.0.3.2版本及后续版本中无法继续正常使用,由getActivatedOsAccountLocalIds代替。

关键的接口/组件变更

  • 涉及接口
interface AccountManager {
  ...
  getActivatedOsAccountIds
  ...
}
  • 变更前:

    getActivatedOsAccountIds(callback: AsyncCallback<Array<number>>): void;
    getActivatedOsAccountIds(): Promise<Array<number>>;
    
  • 变更后:

    getActivatedOsAccountLocalIds(callback: AsyncCallback<Array<number>>): void;
    getActivatedOsAccountLocalIds(): Promise<Array<number>>;
    

cl.account_os_account.8 系统帐号queryOsAccountLocalIdBySerialNumber命名变更

queryOsAccountLocalIdBySerialNumber由于命名不统一问题,名称变更为getOsAccountLocalIdForSerialNumber。

变更影响

queryOsAccountLocalIdBySerialNumber接口,在4.0.3.2版本及后续版本中无法继续正常使用,由getOsAccountLocalIdForSerialNumber代替。

关键的接口/组件变更

  • 涉及接口
interface AccountManager {
  ...
  queryOsAccountLocalIdBySerialNumber
  ...
}
  • 变更前:

    queryOsAccountLocalIdBySerialNumber(serialNumber: number, callback: AsyncCallback<number>): void;
    queryOsAccountLocalIdBySerialNumber(serialNumber: number): Promise<number>;
    
  • 变更后:

    getOsAccountLocalIdForSerialNumber(serialNumber: number, callback: AsyncCallback<number>): void;
    getOsAccountLocalIdForSerialNumber(serialNumber: number): Promise<number>;
    

cl.account_os_account.9 系统帐号querySerialNumberByOsAccountLocalId命名变更

querySerialNumberByOsAccountLocalId由于命名不统一问题,名称变更为getSerialNumberForOsAccountLocalId。

变更影响

querySerialNumberByOsAccountLocalId接口,在4.0.3.2版本及后续版本中无法继续正常使用,由getSerialNumberForOsAccountLocalId代替。

关键的接口/组件变更

  • 涉及接口
interface AccountManager {
  ...
  querySerialNumberByOsAccountLocalId
  ...
}
  • 变更前:

    querySerialNumberByOsAccountLocalId(localId: number, callback: AsyncCallback<number>): void;
    querySerialNumberByOsAccountLocalId(localId: number): Promise<number>;
    
  • 变更后:

    getSerialNumberForOsAccountLocalId(localId: number, callback: AsyncCallback<number>): void;
    getSerialNumberForOsAccountLocalId(localId: number): Promise<number>;
    

cl.account_os_account.10 系统帐号getBundleIdFromUid命名变更

getBundleIdFromUid由于命名不统一问题,名称变更为getBundleIdForUid。

变更影响

getBundleIdFromUid接口,在4.0.3.2版本及后续版本中无法继续正常使用,由getBundleIdForUid代替。

关键的接口/组件变更

  • 涉及接口
interface AccountManager {
  ...
  getBundleIdFromUid
  ...
}
  • 变更前:

    getBundleIdFromUid(uid: number, callback: AsyncCallback<number>): void;
    getBundleIdFromUid(uid: number): Promise<number>;
    
  • 变更后:

    getBundleIdForUid(uid: number, callback: AsyncCallback<number>): void;
    getBundleIdForUid(uid: number): Promise<number>;
    

cl.account_os_account.11 系统帐号queryOsAccountConstraintSourceTypes命名变更

queryOsAccountConstraintSourceTypes由于命名不统一问题,名称变更为getOsAccountConstraintSourceTypes。

变更影响

queryOsAccountConstraintSourceTypes接口,在4.0.3.2版本及后续版本中无法继续正常使用,由getOsAccountConstraintSourceTypes代替。

关键的接口/组件变更

  • 涉及接口
interface AccountManager {
  ...
  queryOsAccountConstraintSourceTypes
  ...
}
  • 变更前:

    queryOsAccountConstraintSourceTypes(localId: number, constraint: string, callback: AsyncCallback<Array<ConstraintSourceTypeInfo>>): void;
    queryOsAccountConstraintSourceTypes(localId: number, constraint: string): Promise<Array<ConstraintSourceTypeInfo>>;
    
  • 变更后:

    getOsAccountConstraintSourceTypes(localId: number, constraint: string, callback: AsyncCallback<Array<ConstraintSourceTypeInfo>>): void;
    getOsAccountConstraintSourceTypes(localId: number, constraint: string): Promise<Array<ConstraintSourceTypeInfo>>;