harmony 鸿蒙帐号子系统ChangeLog

2023-06-24
浏览 (725)

帐号子系统ChangeLog

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

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

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

变更影响

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

关键的接口/组件变更

涉及接口 ts 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>>;