跳到主要内容

cloudbase js sdk 版本迁移

v2 到 v3 迁移​

v3 版本在代码使用上完全兼容 v2 版本，可以平滑迁移，但有以下变化需注意：

  • 身份认证、云函数、云存储 请求域名变为：{env}.api.tcloudbasegateway.com，与 HTTP API 对齐

  • 云存储 迁移指南请参考云存储迁移文档

  • v3 优化了 身份认证 模块，带来更加方便的 api 调用操作，推荐使用新的方法，用法请参考 身份认证

  • 云函数、云存储 域名变化会涉及前置开放 API 权限校验，请到 云开发平台/身份认证/权限控制 中进行角色关联，详细说明请参考策略管理

    与登录认证的关系

v1 到 v2 迁移​

登录认证​

从 v1 到 v2，登录认证模块有以下变化：

  • 登录状态持久化：登录状态只支持 local 模式
  • v2 版本不再支持监听用户登录状态改变
  • v2 版本不再支持公众号登录方式，如需使用该方式，请用 v1 版本
  • 用户字段信息精简化，详见 User
  • 对账户关联使用方式进行了调整，并且不再支持关联自定义登录，详见「登录认证 v2 ｜账户关联」
  • 对登录的使用方式进行了调整，详见「登录认证 v2 ｜登录认证」

接口调整​

Auth​

更新​
新增​
废弃​
  • Auth.anonymousAuthProvider
  • Auth.customAuthProvider
  • Auth.forceResetPwdByPhoneCode
  • Auth.getAuthHeader
  • Auth.getAuthHeaderAsync
  • Auth.onAccessTokenRefreshed
  • Auth.onAnonymousConverted
  • Auth.onLoginStateExpired
  • Auth.onLoginTypeChanged
  • Auth.sendPasswordResetEmail
  • Auth.sendPhoneCode
  • Auth.shouldRefreshAccessToken
  • Auth.signInWithEmailAndPassword
  • Auth.signInWithPhoneCodeOrPassword
  • Auth.signInWithUsernameAndPassword
  • Auth.signUpWithEmailAndPassword
  • Auth.signUpWithPhoneCode
  • Auth.weixinAuthProvider

LoginState​

废弃​
  • LoginState.isAnonymousAuth
  • LoginState.isCustomAuth
  • LoginState.isUsernameAuth
  • LoginState.isWeixinAuth
  • LoginState.loginType

User​

废弃​
  • User.avatarUrl
  • User.linkWithPhoneNumber
  • User.nickName
  • User.updateEmail
  • User.updatePassword
  • User.updatePhoneNumber
  • User.updateUsername