帐号变更说明

cl.account_os_account.1 删除应用帐号授权接口

变更影响

基于此前版本开发的应用，无法继续使用帐号授权能力。

关键接口/组件变更

涉及接口：

interface/sdk-js/api/@ohos.account.appAccount.d.ts:

    enum AccountCapabilityType

    class AccountCapabilityProvider

    class AuthorizationProvider extends AccountCapabilityProvider

    interface AuthorizationProviderInfo

    class AccountCapabilityRequest

    class AccountCapabilityResponse

    class AccountCapabilityScheduler

interface/sdk-js/api/@ohos.account.appAccount.AuthorizationExtensionAbility.d.ts:

    export default class AuthorizationExtensionAbility extends ExtensionAbility

    declare interface AuthorizationRequest

    declare interface AuthorizationCallback

变更后：

涉及接口全部删除。

适配指导

该接口删除后无法再使用，请同步删除相应功能。

cl.account_os_account.2 系统帐号添加凭据接口错误码变更

变更影响

基于此前版本开发的应用，需要重新适配旧错误码场景的分支判断。

关键接口/组件变更

涉及接口：

  class UserIdentityManager {
    ...
    addCredential(credentialInfo: CredentialInfo, callback: IIdmCallback): void;
    ...
  }

错误码列表：

变更前： 会话超时异常场景对应的错误码返回为12300002

变更后： 会话超时异常场景对应的错误码返回为12300001

适配指导

根据错误码变更场景进行排查适配。

cl.account_os_account.3 域插件查询帐号信息接口变更

域插件查询帐号信息接口getAccountInfo变更，为提高接参数的可扩展性，将原来的方法中的指定类型入参，替换为可扩展类型（GetDomainAccountInfoPluginOptions）入参。

变更影响

开发者需要适配新的入参类型，否则将导致编译失败。适配方式请参考下文示例代码。

关键接口/组件变更

变更前：

  interface DomainPlugin {
    ...
    getAccountInfo(domain: string, accountName: string, callback: AsyncCallback<DomainAccountInfo>): void;
    ...
  }

变更后：

  interface DomainPlugin {
    ...
    getAccountInfo(options: GetDomainAccountInfoPluginOptions, callback: AsyncCallback<DomainAccountInfo>): void;
    ...
  }

适配指导

接口入参修改为指定GetDomainAccountInfoPluginOptions类型，示例代码如下。

  let plugin: account_osAccount.DomainPlugin = {
  auth: (domainAccountInfo: account_osAccount.DomainAccountInfo, credential: Uint8Array,
        callback: account_osAccount.IUserAuthCallback) => {},
  authWithPopup: (domainAccountInfo: account_osAccount.DomainAccountInfo,
                  callback: account_osAccount.IUserAuthCallback) => {},
  authWithToken: (domainAccountInfo: account_osAccount.DomainAccountInfo, token: Uint8Array,
                  callback: account_osAccount.IUserAuthCallback) => {},
  getAccountInfo: (options: account_osAccount.GetDomainAccountInfoPluginOptions, // 接口入参变更
                  callback: AsyncCallback<account_osAccount.DomainAccountInfo>) => {
    // mock getting account information
    // notify result
    let code: BusinessError = {
      code: 0,
      name: "",
      message: ""
    };
    let accountInfo: account_osAccount.DomainAccountInfo = {
      domain: options.domain, // 入参读取方式
      accountName: options.accountName, // 入参读取方式
      accountId: 'xxxx'
    };
    callback(code, accountInfo);
  },
  getAuthStatusInfo: (domainAccountInfo: account_osAccount.DomainAccountInfo,
                      callback: AsyncCallback<account_osAccount.AuthStatusInfo>) => {},
  bindAccount: (domainAccountInfo: account_osAccount.DomainAccountInfo, localId: number,
                callback: AsyncCallback<void>) => {},
  unbindAccount: (domainAccountInfo: account_osAccount.DomainAccountInfo, callback: AsyncCallback<void>) => {},
  isAccountTokenValid: (domainAccountInfo: account_osAccount.DomainAccountInfo, token: Uint8Array,
                        callback: AsyncCallback<boolean>) => {},
  getAccessToken: (options: account_osAccount.GetDomainAccessTokenOptions, callback: AsyncCallback<Uint8Array>) => {}
}
  account_osAccount.DomainAccountManager.registerPlugin(plugin)