# 从 tcb-js-sdk 迁移
@cloudbase/js-sdk 保留了 tcb-js-sdk 全部的核心概念,所以您可以沿袭使用 tcb-js-sdk 的大部分逻辑,在迁移过程中仅需要关注以下两点:
- 全量变量
- API 迁移
# 迁移指南
# 全局变量
tcb-js-sdk 暴露的全局变量名称为 tcb
, @cloudbase/js-sdk 将全局变量更名为 cloudbase
。
# API 迁移
tcb-js-sdk 文档中标明的即将废弃的 API 在 @cloudbase/js-sdk 中不再提供,清单如下:
# Auth.on() - 废弃
废弃 tcb-js-sdk 用于监听登录相关事件的 API Auth.on()
,@cloudbase/js-sdk 针对每种事件提供对应的监听 API,列表如下
事件名称 | API |
---|---|
loginStateExpire | Auth.onLoginStateExpired() |
loginStateChanged | Auth.onLoginTypeChanged() |
refreshAccessToken | Auth.onAccessTokenRefreshed() |
anonymousConverted | Auth.onAnonymousConverted() |
loginTypeChanged | Auth.onLoginTypeChanged() |
# Auth.signInAnonymously() - 代替
废弃 tcb-js-sdk 用于匿名登录的 API Auth.signInAnonymously()
, @cloudbase/js-sdk 中提供 API AnonymousAuthProvider.signIn()
实现同样功能。
# Auth.linkAndRetrieveDataWithTicket() - 代替
废弃 tcb-js-sdk 用于匿名账号转正的 API Auth.linkAndRetrieveDataWithTicket()
, @cloudbase/js-sdk 中提供 API User.linkWithTicket()
实现同样功能。
# Auth.signInWithTicket() - 代替
废弃 tcb-js-sdk 用于自定义登录的 API Auth.signInWithTicket()
, @cloudbase/js-sdk 中提供 API CustomAuthProvider.signIn()
实现同样功能。
# 新版特性
# 模块体系
tcb-js-sdk 只能一次性引入全量 SDK,造成打包后的 JavaScript 文件体积过大,这对于只需要云开发部分功能的用户很不友好。@cloudbase/js-sdk 新增按需引入功能模块的特性,您可以根据自身业务需求引入对应的功能模块,详情请查看初始化章节。
# 更友好的语法提示
如果您使用 TypeScript 或 VSCode 等具备语法提示功能的 IDE,将会在开发过程中体验到更友好的语法提示。
← 广告数据上报