Permalink
Fetching contributors…
Cannot retrieve contributors at this time
1207 lines (793 sloc) 44.1 KB

3.11.0 (2018-11-08)

Features

  • 增加了 AV.LiveQuery.pauseAV.LiveQuery.resume 方法。这两个方法可以用于在网络变化或者应用切换后台时主动通知 SDK 断开/恢复 LiveQuery 的连接。
  • 排行榜增加了删除用户分数与排名的方法 AV.Leaderboard.deleteStatistics

Bug fixes

  • 修复了 AV.File#save 方法参数不尊重 AuthOptions 类型参数的问题。
  • 修复了 LiveQuery 的 Query#subscribe 方法在 React Native 中返回 undefined 的问题。
  • 修复了包括 Relation 在内的一些 TypeScript 定义文件错误。
Prereleases

3.11.0-beta.0 (2018-08-13)

Features

  • 增加了 AV.LiveQuery.pauseAV.LiveQuery.resume 方法。这两个方法可以用于在网络变化或者应用切换后台时主动通知 SDK 断开/恢复 LiveQuery 的连接。

Bug fixes

  • 修复了 AV.File#save 方法参数不尊重 AuthOptions 类型参数的问题。

3.10.0 (2018-08-03)

Features

  • AV.Leaderboard#getResultsAroundUser 方法增加了 user 参数支持获取指定用户附近的排名结果。

Bug fixes

  • 修复了文件上传进度回调会错误地在上传结束后报告 direction'download' 的事件的问题。
  • 修复了 TypeScript 定义中与第三方登录相关的多处错误。

3.9.0 (2018-07-19)

Features

  • 增加了匿名用户登录的支持:
    • AV.User.loginAnonymously 方法用于创建一个匿名用户并登录。
    • AV.User#isAnonymous 方法用于判断用户是否为匿名用户。
  • 排行榜增加了新的功能:
    • 支持更新数据时,无视排行榜的更新策略,强制更新分数:AV.Leaderboard#updateStatistics 方法增加了 overwrite 参数。
    • 支持获取历史版本的排名结果:AV.Leaderboard#getResultsAV.Leaderboard#getResultsAroundUser 方法增加了 version 参数。
    • 增加了获取历史版本存档的方法 AV.Leaderboard#getArchives

3.8.1 (2018-07-13)

Bug fixes

  • 修复 TypeScript 定义中的多处问题。

3.8.0 (2018-07-09)

Features

  • 初始化时不再需要 region 参数了。
  • 改进了 TypeScript 定义,现在 AV.Query 的查询结果会得到正确的类型推导。
  • 排行榜 API 根据产品功能的更新进行了一些调整:
    • 增加了一个新的数据更新策略 AV.LeaderboardUpdateStrategy.SUM
    • 移除了不再可用的 AV.LeaderboardVersionChangeInterval.HOUR
  • AV.Conversation 的发送消息 API 现在可以接受 leancloud-realtime v4 中的新 Message 类了。
  • 美国节点的应用现在也启用了每个应用独立的域名。

3.7.3 (2018-06-14)

Bug fixes

  • 修复了 CocosCreator 中 AV.Query#find 等方法在模拟器及真机上不触发回调并打印 [ERROR] args[0] isn't a typed array or an array buffer 的问题。
  • 修复了通过 require('leancloud-storage/live-query') 引入 SDK 无法得到 TypeScript 定义的问题。

3.7.2 (2018-06-06)

Bug fixes

  • 修复了 AV.Query#find 方法错误的 TypeScript 定义。
  • 排行榜 API 进行了修订。

3.7.1 (2018-05-31)

Bug fixes

  • 增加了遗漏的 AV.Leaderboard#destroy 方法。
  • 修复了将一个通过 AV.File.withURL 方法创建的文件保存为一个对象的属性时,文件被错误地保存为 null 的问题。
  • 更新了排行榜使用的 Rest API 路径。

3.7.0 (2018-05-25)

Features

  • 第三方账号登录功能增加了两项新的能力:

    • 所有第三方账号登录 API 增加了 failOnNotExist 参数,指定该参数为 true 时如果当前不存在该 authData 对应的用户,将会抛出「未找到用户」异常。该选项使开发者在使用第三方账号登录创建新用户之前有机会要求用户填写手机号码等信息。

      我们还重新命名了这些 API,以更好的反映其功能:

      • AV.User.loginWithAuthData 代替了 AV.User.signUpOrlogInWithAuthData
      • AV.User.loginWithAuthDataAndUnionId 代替了 AV.User.signUpOrlogInWithAuthDataAndUnionId
      • AV.User.loginWithWeapp 没有变化

      旧的 API 已不赞成使用,并将会在 v4.0.0 中移除。

    • 所有第三方账号登录静态 API 增加了对应的实例方法。开发者可以在调用这些方法前,先设置好用户的 usernamepassword 等信息,再与 authData 一起进行登录。增加的方法有:

      • AV.User#loginWithAuthData
      • AV.User#loginWithAuthDataAndUnionId
      • AV.User#loginWithWeapp
  • 新功能预览:排行榜(AV.Leaderboard

    排行榜功能目前在预览阶段,在正式发布前 API 可能会有不向前兼容的变更,请不要在生产环境使用。

Bug fixes

  • 修复了 AV.Query#sizeEqualTo 方法没有返回 this 的问题。

3.6.8 (2018-04-25)

Bug fixes

  • 修复了 AV.User#associateWithAuthDataAndUnionId 方法在当前用户已经连接了其他第三方平台时,unionId 没有生效的问题。
  • 修复了一些 TypeScript 定义文件的问题。

3.6.7 (2018-04-20)

Bug fixes

  • 修复了如果对象有 File 类型的属性,保存时会堆栈溢出的问题。这个问题是 v3.6.5 中引入的。

3.6.6 (2018-04-18)

Bug fixes

  • 修复了使用 LiveQuery 时在某些情况下会异常断开连接的问题。
  • 修复了使用 AV.StatuscountUnreadStatusesresetUnreadCount 方法时指定 owner 参数不生效(始终作用于当前用户)的问题。
  • 修复了使用 fetchWhenSave 选项更新对象时,如果更新的属性使用了嵌套的 key(如 book.name),更新成功后对象会有一些异常的未保存的值的问题。这个问题是 v3.6.5 中引入的。

3.6.5 (2018-04-09)

Bug fixes

  • 修复了对 Object 或 Array 类型的字段的值进行的直接修改在 save 时没有被正确保存的问题。这个问题是 v3.3.0 中引入的。

3.6.4 (2018-03-30)

Bug fixes

  • 修复了通过 AV.User.current() 获得的 User 有时无法正确得到关联对象属性的问题。

3.6.3 (2018-03-23)

Bug fixes

  • 修复了 LiveQuery 在断线重连后收不到新的通知的问题。

3.6.1 (2018-03-19)

Bug fixes

  • 修复了在 wepy 中使用时,在编译时抛出 找不到模块: vertx 异常的问题。
  • 修复了 AV.Object 中已经被 unset 的字段,fetch 后没有被清理的问题。

3.6.0 (2018-02-05)

Features

  • 第三方登录支持使用微信 unionId + openId 登录。
  • 支持全局设置请求超时时间: AV.setRequestTimeout(ms);,超时后 SDK 会抛出 ECONNABORTED 异常。

Bug Fixes

  • 修复了一个微信小游戏环境中的异常。

3.5.0 (2018-01-10)

Features

  • 支持微信小游戏。

Bug Fixes

  • 修复了初始化时传入 serverURLs 参数为 string 类型不生效的问题。

3.4.2 (2017-11-28)

Features

  • 细化了请求日志级别。

Bug fixes

  • 修复了 AV.User#dissociateAuthData 方法抛异常的问题。
  • 修复了使用 object#set('a.b', value) 修改嵌套的属性后,本地再次获取属性值没有更新的问题。

3.4.1 (2017-11-17)

Bug fixes

  • 修复了华北节点在 Node.js 中上传大文件可能会抛出 invalid multipart format: multipart: message too large 异常的问题。
  • 修复了小程序中请求返回值被错误地解析为 null 导致的问题。

3.4.0 (2017-11-13)

Features

  • 小程序中支持通过 onprogress 回调参数拿到文件上传进度。
  • 在 v3.1.1 中,我们在异常的信息 error.message 中附加了一些请求相关的信息。这可能会导致一些依赖对错误信息进行字符串匹配的逻辑出错。我们为这个问题提供了两种解决方案:
    1. 使用新增的 error.rawMessage 代替 error.message。此外我们推荐依赖 error.code 进行判断,而非对错误信息进行字符串匹配。
    2. 全局设置 AV.keepErrorRawMessage(true) 恢复 v3.1.1 之前的行为。

Bug Fixes

  • 修复了在 Node.js 中通过 Stream 构造 AV.File 可能会抛 Cannot read property 'match' of undefined 异常的问题。

3.3.1 (2017-10-25)

Bug fixes

  • 在 3.3.0 中,为了得到批量删除时每个对象的结果,我们修改了 AV.Object.destroyAll 的内部实现。这个改动会导致计费时按照删除的个数计算请求数而不是之前的只计算一次。在这个补丁中我们恢复了之前的逻辑。

3.3.0 (2017-10-24)

Features

  • AV.Object.saveAllAV.Object.fetchAll 失败时,抛出的异常 error 对象增加 results 属性,类型为 Array<AV.Object|Error>。通过这个属性,开发者可以知道哪些对象的操作成功了,哪些失败了。
  • AV.User 增加了 #associateWithAuthData#dissociateAuthData 用于关联、解绑第三方平台。原有的静态方法 AV.User.associateWithAuthData 已废弃。

Bug Fixes

  • 优化了关联对象保存时的逻辑,减少了一些不必要的保存请求,避免了在关联对象有循环依赖时可能会出现死循环的问题。
  • 修复了使用应用内社交模块 inboxQuery 查询时可能出现 URI too long 异常的问题。

3.2.1 (2017-09-19)

Bug fixes

3.2.0 (2017-09-11)

Features

  • AV.Object 增加了 #bitAnd#bitOr#bitXor 方法,支持对 Number 类型的字段进行位操作。
  • AV.File 增加了 #setUploadHeader 方法,支持为上传请求自定义 headers。

3.1.1 (2017-08-23)

Bug fixes

  • 修复了 SDK 在 iOS9 中抛 Attempting to change value of a readonly property 异常的问题。
  • 修复了在某些 ACL 设置下,AV.User.become 方法会被拒绝的问题。
  • 修复了使用 new AV.User(data, { parse: true }) 方式构造的 User 没有数据的问题。

3.1.0 (2017-08-09)

Bug Fixes

  • 修复了在某些运行环境中使用 LiveQuery 或 Captcha 功能时可能会出现 Object.assign 不存在的问题。

Features

  • AV.Object 增加了静态属性 query,该属性是一个 getter,每次访问该属性会返回一个当前类的 Query。

    class Post extends AV.Object {}
    // 等价于 const query = new AV.Query(Post);
    const query = Post.query;

3.0.4 (2017-08-01)

Bug fixes

  • 修复了 leanengine 中没有正确禁用 currentUser 的问题。

3.0.3 (2017-07-28)

Bug fixes

  • 修复了 AV.File 在浏览器中不支持通过 Blob 创建的问题。
  • 修复了一些 TypeScript 定义文件的问题。

3.0.2 (2017-07-10)

Bug fixes

  • 修复了 IE 下抛出 Promise 未定义异常的问题。
  • 修复了微信小程序一键登录时没有正确初始失败情况的问题。

3.0.1 (2017-06-21)

Bug fixes

  • 修复了美国节点文件上传失败的问题。
  • 修复了 React Native 中用户登录成功会导致 crash 的问题。

3.0.0 (2017-06-16)

Highlights

  • LiveQuery:通过订阅一个 Query,在其结果发生变动时实时得到通知。详见 《LiveQuery 开发指南》
  • 新的序列化反序列化方法:针对 AV.Object 重新设计了 #toJSON 方法,并提供了一对可靠的序列化反序列化方法。
  • AV.request 方法:公开了低抽象级别的 AV.request 方法,方便开发者直接调用 LeanCloud Rest API。

Breaking Changes

  • 重新设计了 AV.Object 序列化相关的方法:

    • 如果需要将 AV.Object 中的有效信息转换成 JSON Object,请使用 AV.Object#toJSON 方法。请注意通过此方法得到的 JSON 不包含对象的元信息,因此是不可逆的(无法转换回 AV.Object)。
    • 如果需要「存储」或「传输」AV.Object,请使用新增的 AV.Object#toFullJSON(序列化)与 AV.parseJSON(反序列化)方法。

    新版中的 AV.Object#toJSON 相比于 v2 有以下区别:

    • 如果对象某个字段类型是 Pointer,并且有内容(included),新版中会递归地输出这个字段的有效信息(旧版中会输出一个 Pointer 结构)

      new AV.Query('Child').include('father').first()
        .then(child => child.toJSON().father)
        .then(console.log);
      /*
      v3: {
        objectId: "58a461118d6d8100580a0c54",
        name: "John Doe",
        createdAt: "2017-02-15T14:08:39.892Z",
        updatedAt: "2017-02-16T10:49:00.176Z"
      }
      v2: {
        objectId: "58a461118d6d8100580a0c54",
        __type: "Pointer",
        className: "Parent",
      }
    • 如果字段的类型是 Date,新版中会输出该时间的 UTC 格式字符串(旧版中会输出一个 Date 结构)

      const child = new Child().set('birthday', new Data());
      console.log(child.toJSON().birthday);
      /*
      v3: "2011-11-11T03:11:11.000Z"
      v2: {
        __type: "Date",
        iso: "2011-11-11T03:11:11.000Z"
      }

    更多背景与技术细节请参考 #453.

  • 为了更好的隔离服务,我们为每个应用提供了独立的域名。对于小程序用户,请前往 《小程序域名白名单配置》 更新域名白名单。

  • 创建 Roleacl 参数不再是可选的。在 v2 中,如果不指定,SDK 会自动为其设置一个 public read-only 的默认 acl,在新版中必须显式的指定。

    // 之前的用法
    new AV.Role('admin');
    
    // 新版中等价于
    var acl = new AV.ACL();
    acl.setPublicReadAccess(true);
    new AC.Role('admin', acl);

Features

  • LiveQuery 功能允许开发者订阅一个 Query,在 Query 的结果发生变动时实时得到通知。

    • 增加了 Query#subscribe 方法,返回该 Query 对应的 LiveQuery 实例;
    • 增加了 LiveQuery 类,在 Query 结果变化时 SDK 会在 LiveQuery 实例上派发 createupdateenterleavedelete 等事件。
  • 开放了低抽象级别的 AV.request 方法,方便开发者直接调用 LeanCloud Rest API。

  • 增加了 AV.setServerURLs 方法,允许单独配置云函数等服务的域名以进行本地调试。

    AV.setServerURLs({
      engine: 'http://localhost:3000',
    });
  • 支持在 Node.js 中通过 Stream 构建 AV.File(仅支持中国节点)。

    const fs = require('fs');
    const readStream = fs.createReadStream('sample.txt');
    const file = new AV.File('filename', readStream);

Bug Fixes

  • 修复了在中国节点 Node.js 中上传文件会阻塞当前线程的问题。

测试版本的更新日志:

3.0.0 (2017-06-16)

Bug Fixes

  • 修复了上传文件 size 信息缺失的问题。
  • 修复了在中国节点 Node.js 中上传文件会阻塞当前线程的问题。

Features

  • 支持 LiveQuery。

  • 支持在 Node.js 中通过 Stream 构建 AV.File(仅支持中国节点)。

    const fs = require('fs');
    const readStream = fs.createReadStream('sample.txt');
    const file = new AV.File('filename', readStream);

Miscellanies

  • 包含了 v2.5.0 的新特性。

3.0.0-beta.3 (2017-06-01)

Features

  • LiveQuery

Miscellanies

  • 包含了 v2.3.0-v2.4.0 的新特性与修复。

3.0.0-beta.2 (2017-04-27)

Breaking Changes

  • 为了更好的隔离服务,我们为每个应用提供了独立的域名。对于小程序用户,请前往 《小程序域名白名单配置》 更新域名白名单。

  • 创建 Roleacl 参数不再是可选的。在 v2 中,如果不指定,SDK 会自动为其设置一个 public read-only 的默认 acl,在新版中必须显式的指定。

    // 之前的用法
    new AV.Role('admin');
    
    // 新版中等价于
    var acl = new AV.ACL();
    acl.setPublicReadAccess(true);
    new AC.Role('admin', acl);

Features

  • 开放了低抽象级别的 AV.request 方法,方便开发者直接调用 SDK 还不支持的 Rest API。

  • 增加了 AV.setServerURLs 方法,允许单独配置云函数等服务的域名。

    AV.setServerURLs({
      engine: 'http://localhost:3000',
    });

Miscellanies

  • 包含了 v2.1.3-v2.2.1 的新特性与修复。

3.0.0-beta.1 (2017-02-28)

Bug Fixes

  • 修复了 Query 时使用 Date 类型的条件会导致查询结果异常的问题

3.0.0-beta.0 (2017-02-22)

Breaking Changes

重新设计了 AV.Object 序列化相关的方法:

  • 如果需要将 AV.Object 中的有效信息转换成 JSON Object,请使用 AV.Object#toJSON 方法。请注意通过此方法得到的 JSON 不包含对象的元信息,因此是不可逆的(无法转换回 AV.Object)。
  • 如果需要「存储」或「传输」AV.Object,请使用新增的 AV.Object#toFullJSON(序列化)与 AV.parseJSON(反序列化)方法。

新版中的 AV.Object#toJSON 相比于 v2 有以下区别:

  • 如果对象某个字段类型是 Pointer,并且有内容(included),新版中会递归地输出这个字段的有效信息(旧版中会输出一个 Pointer 结构)

    new AV.Query('Child').include('father').first()
      .then(child => child.toJSON().father)
      .then(console.log);
    /*
    v3: {
      objectId: "58a461118d6d8100580a0c54",
      name: "John Doe",
      createdAt: "2017-02-15T14:08:39.892Z",
      updatedAt: "2017-02-16T10:49:00.176Z"
    }
    v2: {
      objectId: "58a461118d6d8100580a0c54",
      __type: "Pointer",
      className: "Parent",
    }
  • 如果字段的类型是 Date,新版中会输出该时间的 UTC 格式字符串(旧版中会输出一个 Date 结构)

    const child = new Child().set('birthday', new Data());
    console.log(child.toJSON().birthday);
    /*
    v3: "2011-11-11T03:11:11.000Z"
    v2: {
      __type: "Date",
      iso: "2011-11-11T03:11:11.000Z"
    }

更多背景与技术细节请参考 #453.

2.5.0 (2017-06-01)

Bug Fixes

  • 修复了查询 Role 时错误的打印了 deprecation 警告的问题

Features

  • User#follow 增加了一种重载,现在可以通过 options.attributes 参数为创建的 FollowerFollowee 增加自定义属性,方便之后通过 User#followerQueryUser#followerQuery 进行查询。

2.4.0 (2017-05-19)

Bug Fixes

  • 可能导致不兼容 修复了 Query#get 方法在目标对象不存在的情况下会返回一个没有数据的 AV.Object 实例的问题,现在该方法会正确地抛出 Object not found 异常。这个问题是在 2.0.0 版本中引入的。

Features

  • 增加了 Conversation#broadcast 方法用于广播系统消息

2.3.2 (2017-05-12)

Bug Fixes

  • 修复了获取图形验证码会导致栈溢出的问题。

2.3.0 (2017-05-11)

Features

  • 增加了 AV.Conversation 类。现在可以直接使用 SDK 来创建、管理会话,发送消息。
  • 改进了验证码 API。增加了 AV.Captcha,可以通过 AV.Captcha.request 方法获取一个 Captcha 实例。特别的,在浏览器中,可以直接使用 Captcha#bind 方法将 Captcha 与 DOM 元素进行绑定。

2.2.1 (2017-04-26)

Bug Fixes

  • 修复了 User.requestLoginSmsCodeUser.requestMobilePhoneVerifyUser.requestPasswordResetBySmsCode 方法 authOptions.validateToken 参数的拼写错误。

2.2.0 (2017-04-25)

Bug Fixes

  • 修复了 Safari 隐身模式下用户无法登录的问题

Features

  • 短信支持图形验证码(需要在控制台应用选项「启用短信图形验证码」)
    • 新增 Cloud.requestCaptchaCloud.verifyCaptcha 方法请求、校验图形验证码。
    • Cloud.requestSmsCodeUser.requestLoginSmsCodeUser.requestMobilePhoneVerifyUser.requestPasswordResetBySmsCode 方法增加了 authOptions.validateToken 参数。没有提供有效的 validateToken 的请求会被拒绝。
  • 支持客户端查询 ACL(需要在控制台应用选项启用「查询时返回值包括 ACL」)
    • 增加 Query#includeACL 方法。
    • Object#fetchFile#fetch 方法增加了 fetchOptions.includeACL 参数。

2.1.4 (2017-03-27)

Bug Fixes

  • 如果在创建 Role 时不指定 acl 参数,SDK 会自动为其设置一个「默认 acl」,这导致了通过 Query 得到或使用 Object.createWithoutData 方法得到 Role 也会被意外的设置 acl。这个版本修复了这个问题。
  • 修复了在 React Native for Android 中使用 blob 方式上传文件失败的问题

2.1.3 (2017-03-13)

Bug Fixes

  • 修复了调用 User#refreshSessionToken 刷新用户的 sessionToken 后本地存储中的用户没有更新的问题
  • 修复了初始化可能会造成 disableCurrentUser 配置失效的问题
  • 修复了 Query#destroyAll 方法 options 参数无效的问题

2.1.2 (2017-02-17)

Bug Fixes

  • 修复了文件上传时,如果 fileName 没有指定扩展名会导致上传文件 mime-type 不符合预期的问题
  • 修复了清空 ACL 部分对象的权限后没有正常删除对象的问题(by AntSworD

2.1.1 (2017-02-07)

Bug Fixes

  • 修复了使用 masterKey 获取一个 object 后再次 save 可能会报 ACL 格式不正确的问题。

2.1.0 (2017-01-20)

Bug Fixes

  • 修复了 File#toJSON 序列化结果中缺失 objectId 等字段的问题
  • 修复了使用 Query#containsAllQuery#containedInQuery#notContainedIn 方法传入大数组时查询结果可能为空的问题
  • 修复了文件上传失败后 _File 表中仍有可能残留无效文件记录的问题

Features

  • 增加了 User#refreshSessionToken 方法用于刷新用户的 sessionToken
  • 增加了 Query#scan 方法用于遍历 Class
  • 应用内社交模块增加了 Status.resetUnreadCount 方法用于重置未读消息数

2.0.1 (2017-01-12)

Bug Fixes

  • 修复了在 Node.js 中向国内节点上传文件抛异常的问题
  • 修复了小程序中不启用「ES6 转 ES5」选项时加载 SDK 抛异常的问题

2.0.0 (2017-01-09)

Highlights

  • 全面支持微信小程序:包括文件存储在内的所有功能均已支持微信小程序,用户系统还增加了小程序内一键登录的 API。详见 在微信小程序中使用 LeanCloud
  • Promise first:Promise 风格的异步 API 已被社区广泛接受,此前回调参数优先于其他参数的设计已过时,因此我们去掉了对 Backbone 回调风格参数的支持。
  • 支持对单次操作指定是否使用 masterKey:此前使用 masterKey 是全局生效的,会导致无法充分利用 ACL 等内建的权限控制机制。此项改进将其生效范围细化到了单次操作。
  • 移除 Node.js 0.12 支持:Node.js 0.12 LTS 已停止维护,请考虑 升级 Node.js 版本

Breaking Changes

  • 移除了 Node.js 0.12 的支持,请考虑 升级 Node.js 版本

  • 移除了所有 Backbone 回调风格的参数,请使用 Promise 处理异步操作的结果与异常:

    // Backbone callback 回调风格的参数的用法
    object.save(null, {
      success: function(object) {},
      error: function(error, object) {},
    });
    
    // 需要替换为
    object.save().then(function(object) {}, function(error) {});
  • AV.Promise 现在是一个满足 Promises/A+ 标准的实现,所有非标准的方法已被移除,所有非标准的行为已被修正。关于标准 Promise 的更多信息推荐阅读 《JavaScript Promise 迷你书》

  • AV.Query 中的大部分 API 启用了更加严格的参数检查。特别的,对于以下 API,当指定 value 的值为 undefined 时会抛出异常(之前会直接忽略这个条件或限制)

    • 参数形如 (key, value) 类型的条件限制 API,如 AV.Query#equalTo(key, value)
    • AV.Query#limit(value)
    • AV.Query#select(value)
  • AV.Query#get 方法现在尊重 Class 的 get 权限设置(之前检查的是 find 权限)

  • objectIdcreatedAtupdatedAt 现在是只读字段,尝试 set 这些字段时 SDK 会抛出异常

  • object.get('id')object.set('id', '') 现在将会正确的读、写数据表中的 id 字段(之前映射的是 objectId)。你现在依然可以使用 object.id 来访问数据的 objectId

  • 如果你 extend 的 AV.Object 子类重写了 validate 方法,当属性无效时现在需要 throw 一个 Error(之前是 return 一个 Error)。相应的,AV.Object#set 方法如果 set 的值无效,需要通过 try catch 捕获异常(之前通过检查返回值是 false)

    // 之前的用法
    var Student = AV.Object.extend('Student', {
      validate: function(attibutes) {
        if (attributes.age < 0) return new Error('negative age set');
      },
    });
    var tom = new Student();
    if (tom.set('age', -1) === false) {
      console.error('something wrong');
    } else {
      tom.save();
    }
    
    // 现在的用法
    var Student = AV.Object.extend('Student', {
      validate: function(attibutes) {
        if (attributes.age < 0) throw new Error('negative age set');
      },
    });
    var tom = new Student();
    try {
      tom.set('age', -1);
    } catch (error) {
      console.error(error.message);
    }
    tom.save();
  • 上传文件时不再额外地向文件的 metaData 中写入 mime_type,之前通过 metaData 获取 mime_type 的用法需要更新:

    // 之前的用法
    file.metaData('mime_type');
    
    // 现在的用法
    file.get('mime_type');
  • 移除了 deprecated 的 API,包括:

    • AV.Object#existed
    • AV.User.requestEmailVerfiy (typo)
    • AV.useAVCloudCN
    • AV.useAVCloudUS
    • AV._ajax
    • AV._request

Features

  • 支持微信小程序
  • 增加了 AV.User.loginWithWeapp()AV.User#linkWithWeapp() ,支持在微信小程序中登录
  • 增加了 AV.User#isAuthenticated(),该方法会校验 sessionToken 的有效性, 废弃 AV.User#authenticated()
  • 绝大部分会发起网络请求的 API(如保存一个对象)支持通过 option.useMasterKey 参数指定该次操作是否要使用 masterKey,设置了该选项的操作会忽略全局的 useMasterKey 设置
  • 去掉了 Object.destroyAll 方法要求所有删除的对象属于同一个 Class 的限制
  • Object.register() 方法增加了第二个参数允许指定所注册的 Class 的名字,详情参见 Object.register - API 文档
  • 上传文件的 mime_type 现在由服务端进行判断从而支持更多的文件类型
  • 增加了 sourcemaps

Bug Fixes

  • 修复了在进行以下操作时可能出现 URI too long 异常的问题
    • 使用 Query#containsAllQuery#containedInQuery#notContainedIn 方法时传入了一个大数组
    • 使用 Object.destroyAll 方法批量删除大量对象
  • 修复了 Object.set(key, value) 方法可能会改变(mutate)value 的问题
  • 修复了查询结果中 File 没有被正确解析的问题
  • 修复了在 React Native 中使用 AV.setProduction 方法会导致后续操作引起 crash 的问题
  • 修复了在 React Native 上传大文件可能出现 invalid multipart format: multipart: message too large 异常的问题
  • 修复了 AV.Insight.startJob 方法中 saveAs 参数未生效的问题
  • 修复了抛出 code == -1 的异常时 error.message 可能缺失的问题
  • 修复了应用内社交模块的方法在未登录状态下传入了 sessionToken 仍然抛未登录异常的问题

测试版本的更新日志:

2.0.0 (2017-01-09)

Bug Fixes

  • 修复了在 React Native 及小程序中上传大文件可能出现 invalid multipart format: multipart: message too large 异常的问题
  • 修复了某些情况下上传的文件 mime_type 不正确的问题

2.0.0-rc.0 (2016-12-30)

Breaking Changes

  • 移除了 Node.js 0.12 的支持,请考虑 升级 Node.js 版本

  • 上传文件时不再额外地向文件的 metaData 中写入 mime_type,之前通过 metaData 获取 mime_type 的用法需要更新:

    // 之前的用法
    file.metaData('mime_type');
    
    // 现在的用法
    file.get('mime_type');
  • (internal) AV._decode(key, value) 现在变更为 AV._decode(value[, key])

Features

  • 上传文件的 mime_type 现在由服务端进行判断从而支持更多的文件类型
  • 去掉了 Object.destroyAll 方法要求所有删除的对象属于同一个 Class 的限制
  • Object.register() 方法增加了第二个参数允许指定所注册的 Class 的名字,详情参见 Object.register - API 文档

Bug Fixes

  • 修复了在进行以下操作时可能出现 URI too long 异常的问题
    • 使用 Query#containsAllQuery#containedInQuery#notContainedIn 方法时传入了一个大数组
    • 使用 Object.destroyAll 方法批量删除大量对象
  • 修复了在 React Native 及小程序中使用 AV.setProduction 方法会导致后续操作引起 crash 的问题
  • 修复了 Object.set(key, value) 方法可能会改变(mutate)value 的问题
  • 修复了查询结果中 File 没有被正确解析的问题
  • 修复了 AV.Insight.startJob 方法中 saveAs 参数未生效的问题
  • 修复了抛出 code == -1 的异常时 error.message 可能缺失的问题

2.0.0-beta.6 (2016-11-30)

Bug Fixes

  • 修复了 Android 微信小程序上初始化失败的问题
  • 修复了小程序中使用应用内社交抛 AV is not defined 异常的问题

Features

  • 增加了 sourcemaps

2.0.0-beta.5 (2016-11-16)

Bug Fixes

  • 修复了在 Android 微信小程序上运行时抛 undefined is not a function 异常的问题

2.0.0-beta.4 (2016-11-11)

Breaking Changes

  • objectIdcreatedAtupdatedAt 现在是只读字段,尝试 set 这些字段时 SDK 会抛出异常
  • object.get('id')object.set('id', '') 现在将会正确的读、写数据表中的 id 字段(之前映射的是 objectId)。你现在依然可以使用 object.id 来访问数据的 objectId

Features

  • 增加了 AV.User.loginWithWeapp()AV.User#linkWithWeapp() ,支持在微信小程序中登录
  • 增加了 AV.User#isAuthenticated(),该方法会校验 sessionToken 的有效性, 废弃 AV.User#authenticated()

2.0.0-beta.3 (2016-11-8)

Bug Fixes

  • 修复了在微信小程序真机上运行时抛 ReferenceError: Can't find variable: FormData 异常的问题
  • 修复了 2.0.0-beta.0 中引入的 AV.Query#selectAV.Query#include 不支持多个参数的问题

2.0.0-beta.2 (2016-10-20)

Features

  • AV.File 支持微信小程序

2.0.0-beta.1 (2016-10-13)

Features

  • 支持微信小程序 0.10.101100

2.0.0-beta.0 (2016-9-29)

Breaking Changes

  • 移除了所有 Backbone 回调风格的参数,请使用 Promise 处理异步操作的结果与异常:

    // Backbone callback 回调风格的参数的用法
    object.save(null, {
      success: function(object) {},
      error: function(error, object) {},
    });
    
    // 需要替换为
    object.save().then(function(object) {}, function(error) {});
  • AV.Promise 现在是一个满足 Promises/A+ 标准的实现,所有非标准的方法已被移除,所有非标准的行为已被修正。关于标准 Promise 的更多信息推荐阅读 《JavaScript Promise 迷你书》

  • 如果你 extend 的 AV.Object 子类重写了 validate 方法,当属性无效时现在需要 throw 一个 Error(之前是 return 一个 Error)。相应的,AV.Object#set 方法如果 set 的值无效,需要通过 try catch 捕获异常(之前通过检查返回值是 false)

    // 之前的用法
    var Student = AV.Object.extend('Student', {
      validate: function(attibutes) {
        if (attributes.age < 0) return new Error('negative age set');
      },
    });
    var tom = new Student();
    if (tom.set('age', -1) === false) {
      console.error('something wrong');
    } else {
      tom.save();
    }
    
    // 现在的用法
    var Student = AV.Object.extend('Student', {
      validate: function(attibutes) {
        if (attributes.age < 0) throw new Error('negative age set');
      },
    });
    var tom = new Student();
    try {
      tom.set('age', -1);
    } catch (error) {
      console.error(error.message);
    }
    tom.save();
  • AV.Query 中的大部分 API 启用了更加严格的参数检查。特别的,对于以下 API,当指定 value 的值为 undefined 时会抛出异常(之前会直接忽略这个条件或限制)

    • 参数形如 (key, value) 类型的条件限制 API,如 AV.Query#equalTo(key, value)
    • AV.Query#limit(value)
    • AV.Query#select(value)
  • AV.Query#get 方法现在尊重 Class 的 get 权限设置(之前检查的是 find 权限)

  • (intarnal) AV.User#_linkWith 的第二个参数中的 options.authData 字段提升为第二个参数

    // 之前的用法
    user._linkWith('weixin', {
      authData: {
        access_token: 'access_token',
      },
    });
    
    // 现在的用法
    user._linkWith('weixin', {
      access_token: 'access_token',
    });
  • 移除了 deprecated 的 API,包括:

    • AV.Object#existed
    • AV.User.requestEmailVerfiy (typo)
    • AV.useAVCloudCN
    • AV.useAVCloudUS
    • AV._ajax
    • AV._request

Bug Fixes

  • 修复了应用内社交模块的方法在未登录状态下传入了 sessionToken 仍然抛未登录异常的问题

Features

  • 对象存储功能支持微信小程序
  • 绝大部分会发起网络请求的 API(如保存一个对象)支持通过 option.useMasterKey 参数指定该次操作是否要使用 masterKey,设置了该选项的操作会忽略全局的 useMasterKey 设置

1.4.0 (2016-9-1)

相比于 v1.4.0-beta.0:

  • 修复了 AV.File#save 方法的 onprogress 参数失效的问题

1.4.0-beta.0 (2016-8-23)

  • 支持 ES2015 的 extends 语法来声明 AV.Object 的子类,增加了 AV.Object.register 方法用于注册声明的子类。

    class Article extends AV.Object {}
    AV.Object.register(Article);
  • AV.Query 支持查询 AV.File

  • 修复多次调用 AV.Object.extend('ClassName') 后可能导致堆栈溢出的问题

  • 修复 AV.Query#addDescending 没有返回 query 的问题,现在支持链式调用了

  • 修复 React Native 0.32 中找不到 react-native 模块的问题

1.3.3 (2016-8-2)

  • 修复在 AV.Object 子类某属性的 getter 中调用 AV.Object#get 方法时调用栈溢出的问题

1.3.2 (2016-7-26)

  • 修复 1.3.1 中未彻底解决的 A promise was resolved even though it had already been resolved 异常问题

1.3.1 (2016-7-21)

  • 修复多次调用 AV.init 抛出 A promise was resolved even though it had already been resolved 异常的问题

1.3.0 (2016-7-20)

  • 增加 AV.Object.fetchAll() 方法
  • 修复抛出的异常没有堆栈信息的问题
  • 修复在某些异常情况下,发出的请求不带域名的问题

1.2.1 (2016-6-30)

  • 修复美国节点文件上传成功后 File 实例没有 id 的问题

1.2.0 (2016-6-29)

  • 增加 AV.User.associateWithAuthData() 方法
  • 修复美国节点文件上传失败的问题
  • 修复 AV.User.signUpOrlogInWithAuthData() 省略 callback 参数会报异常的问题
  • 修复 React Native 中 import leancloud-storage 抛 cannot read property "APIServerURL" for undefined 异常的问题

1.1.0 (2016-6-27)

  • 防止 SDK 覆盖全局变量 AV
  • Object.add、Object.addUnique、Object.remove 等方法支持从传入非数组类型的 value 参数
  • 修复路由缓存异常时,不再出现多次 410 错误请求
  • 美国节点上传到 S3 改为直接上传,不再通过服务器中转

1.0.0 (2016-5-30)

  • 弃用 AV.Error 对象,改为内部模块
  • 移除 AV.applicationProduction 改为 AV._config.applicationProduction 内部接口
  • 调整 npm 包名为 leancloud-storage

1.0.0-rc9.2 (2016-5-23)

  • 修复了上传文件成功却进入失败回调的问题。
  • 修复 AV.Object#fetch 在某些情况下抛出 fetchOptions.include.join is not a function 异常的问题。

1.0.0-rc9.1 (2016-5-17)

  • 修复了上传文件到 COS 时报错的问题。

1.0.0-rc9 (2016-5-16)

  • 修复了错误的 package.browser 字段引起的部分打包工具异常。
  • 修复浏览器中 ajax 方法中错误的转码方式。
  • 修复 AV.Object#get 方法返回部分字段类型异常。
  • 修复 AV.Object#fetch 方法 read sessionToken from undefined 的错误。
  • 支持节点动态路由。
  • 文件上传使用 https 协议。
  • 文件上传支持 React Native for Android。

1.0.0-rc8 (2016-4-6)

  • (BREAKING) 添加了 AV.init 方法,该方法接收一个名为 options 的参数字典,废弃 AV.initialize 方法。
  • (BREAKING) 为 AV.Object#save 方法的 options 参数添加了 fetchWhenSave 选项,废弃 AV.Object#fetchWhenSave 方法。
  • (BREAKING) 添加了 disableCurrentUser 选项(可在 AV.init 方法中设置),当开启时:
    • AV.User.current 和 AV.User.currentAsync 打印警告并返回 null。
    • signUp, logIn, fetch, become 等方法不再写入全局状态。
    • 发起请求时不再向服务器发送 installationId。
    • AV.File 不再会自动设置 owner, 请在 data 参数中传入 owner 选项(AV.User 对象)。
  • 为所有会发起网络请求的操作(save 等)的 options 参数添加了 sessionToken 选项,可通过传入该选项指定请求所使用的 sessionToken。
  • 添加了 AV.User.getSessionToken 方法。
  • 添加了 AV.User#logOut 这个实例方法(之前只有类方法)。
  • 为 AV.Object#save 方法的 options 参数添加了 query 选项,该次更新操作在对象最新状态满足 query 时才会执行。
  • 修正了在某些错误情况下返回值格式不正确的错误。
  • 使用了更加安全的鉴权机制,以降低 App Key 在传输过程中泄露的风险。
  • 移除了特殊跨域兼容实现,现在遵循 CORS。

1.0.0-rc7 (2016-2-16)

  • 添加 AV.Cloud.rpc 方法
  • 修复了 AV.User#fetch 不会运行回调函数的 bug。

1.0.0-rc6 (2016-2-1)

  • 修复了云引擎中文件上传到 AWS 的问题。
  • 修复了 AV.User#fetch 不支持 fetch options 的问题。
  • 修复了使用 Pointer 时可能出现类型错误的问题。

1.0.0-rc5 (2015-11-24)

  • AV.File 新增 fetch 方法。
  • 废弃 AV.Object 的 existed 方法。
  • 移除 AV.BigQuery 模块。该模块在 0.5.7 中废弃。
  • 提升了在 node 中运行的性能。
  • 修复了一些 IE 兼容性问题。

1.0.0-rc4 (2015-11-12)

  • (BREAKING) 移除了 av-core[-mini].js,请直接使用 av[-mini].js。移除了 CollectionRouter 等 Backbone 兼容模块,请直接使用 Backbone。
  • 新增第三方平台帐号登录 API:AV.User.signUpOrlogInWithAuthData()。 感谢 @jacktator 。
  • 修复海外节点文件上传方式错误的问题。

1.0.0-rc3 (2015-10-27)

  • 修复 AV._request 某些情况下无法正常工作的 Bug。
  • 修复某些登录 API 没有更新 currentUser 的问题
  • 修复 localStorage 没有生效的 Bug,感谢热心用户反馈。
  • AV.SearchQuery 增加 hasMore 和 reset 方法。

0.6.4 (2015-10-27)

  • 修复 localStorage 没有生效的 Bug,感谢热心用户反馈。
  • AV.SearchQuery 增加 hasMore 和 reset 方法。

1.0.0-rc2 (215-10-22)

  • 兼容 React Native 运行环境。
  • 修复 AV.Role 的兼容性问题。
  • 修复 AV._request 某些情况下无法正常工作的 Bug。

0.6.3 (2015-10-22)

  • 修复 AV.Role 的兼容性问题。

1.0.0-rc1 (215-10-22)

  • 兼容 React Native 运行环境。

0.6.2 (2015-10-22)

  • 修复 Follower/Followee 查询遇到 undefined 用户抛出异常的 bug。
  • 修复在无痕模式浏览器下无法正常运行的 Bug。
  • 修复 AV.File 保存可能导致堆栈溢出的 Bug。
  • AV.Role 增加默认 ACL 设置。

0.6.1 (2015-09-01)

  • 修复 AV.File 在 LeanEngine 中上传 Base64 图片数据损坏的 bug。

0.6.0 (2015-08-25)

  • AV.File 在浏览器环境下直接上传文件到七牛,再无大小和频率限制。
  • 新增 API AV.Cloud.getServerDate 用于获取当前服务器时间。
  • 修改美国节点 API 域名为 us-api.leancloud.cn
  • 使用 browserify 构建 SDK。
  • 相同应用重复初始化 SDK 避免告警日志。

0.5.8 (2015-08-5)

  • 修复 AV.Object.destroyAll 新版本无法工作的 Bug。

0.5.7 (2015-07-29)

  • AV.Promise 仅在非 node 环境(如浏览器)默认启用 PromiseA+ 兼容模式
  • 增加 AV.Promise.setDebugError 方法,用于在启用 PromiseA+ 模式的时候打印错误信息,方便调试
  • 重命名 AV.BigQuery 模块为 AV.Insight,保留兼容 AV.BigQuery,推荐修改。
  • 修复 fetchWhenSave 无法在创建对象的时候生效。
  • 当重复初始化 SDK 的时候,打印警告日志。
  • 修改默认 API 域名为 api.leancloud.cn。

0.5.5 (2015-06-29)

  • AV.Promise 启用兼容 Promise+ 模式。
  • 增加 AV.BigQuery 相关 API 用于发起离线分析和查询结果等。
  • 修正 AV.Query 的 get 方法在遇到 undefined objectId 运行结果不符合预期的 Bug
  • 修复 AV.File 无法作为数组保存的 Bug。

0.5.4 (2015-05-14)

  • 紧急修复 localStorage 模块大小写名称错误。

0.5.2 (2015-05-12)

  • 上传 sdk 到专门的 CDN 加速域名 https://cdn1.lncld.net/static/
  • 兼容 ReactNative 运行环境
  • 修复 AV.Query 的 addDescending 方法运行不符合预期的 Bug
  • AV.Promise 在兼容 Primise+ 模式下优先使用 setImmediate
  • AV.Object 的 fetch 方法新增重载方法,接收第一个参数是 fetchOptions ,设置 keys 或者 include 选项。
  • AV.Query 支持 sizeEqualTo 方法,查询数组列大小等于特定长度的对象。

0.5.1 (2015-03-27)

0.5.0 (2015-03-02)

  • 增强 AV.Promise,增加done,catch,finally,AV.Promise.race 等方法,兼容 Promise/A+
  • 修复更新对象可能更新没有变更的属性的 Bug,减少请求流量。

0.4.9 (2015-02-26)

  • 拆分 sdk,按照模块划分成多个文件。
  • 使用 gulp 构建 sdk,清理代码。
  • 修复事件流无法发送带有 AV.FileAV.Object 等类型的 Status。
  • 修复 node.js 环境下上传文件没有扩展名的 Bug。

0.4.7 (2015-01-23)

  • 修复页面跳转更新 user 导致 current user 属性丢失的 Bug。
  • 增加 AV.User.updatePassword 方法,根据老密码修改成新密码。
  • AV.Object 增加 getObjectId, getUpdatedAt, getCreatedAt 三个方法。
  • 增加 AV.User#signUpOrlogInWithMobilePhone 手机一键登录。
  • 一些内部改进和重构。

0.4.6 (2014-12-11)

  • 添加新方法 AV.File.createWithoutData(objectId),根据 objectId 构造 AV.File
  • 添加 AV.Query.and 方法用于复合查询
  • AV.File 支持 get/set ACL
  • 增加新方法 AV.setProduction(boolean) 用于设置生产环境或者测试环境。

0.4.5 (2014-10-29)

  • CQL 查询支持占位符,AV.Query.doCloudQuery 方法增加三个参数版本
  • AV.Push 增加 cql 属性说明,可以通过 CQL 指定推送查询条件。
  • 部分内部代码重构。

0.4.4 (2014-10-14)

  • 修复 node.js 下上传文件无法指定文件 mime type 的 Bug
  • 添加 AV.Object.new 函数用来创建对象,避免代码压缩带来的问题。

0.4.3

  • 添加 CQL 查询支持,增加 AV.Query.doCloudQuery 方法。

老版本的 changelog

https://download.avoscloud.com/sdk/javascript/changelog.txt