avoscloud-sdk

LeanCloud JavaScript SDK

JavaScript SDK for LeanCloud.

使用方法请看 官方文档

版本说明

• 0.x.y 版本，是不兼容 React Native 运行时的老版本 SDK，相对稳定，云引擎主要依赖这个分支版本。
• 1.0.0-x 版本，是我们最新开发的兼容 React Native 运行时的版本，处于开放测试阶段，欢迎大家尝试。我们最终将使用这个分支替代云引擎里的 0.x.y 版本。

可以使用以下命令安装 1.0.0-x 版本：npm install avoscloud-sdk@next。

贡献

• fork 这个项目
• npm install 安装相关依赖
• 浏览器环境执行 gulp dev，会自动启动 demo 目录，可在 test-es6.js 中修改和测试，test-es5.js 为自动生成的代码
• 确保测试全部通过 gulp test，浏览器环境打开 test/test.html
• 提交并发起 Pull Request
• 执行 gulp release 会生成全部版本的 SDK

项目的目录结构说明如下：

├── README.md                          // 说明文档
├── bower.json
├── changelog.md
├── dist                               // 编译之后生成的文件将会在此目录下
│   ├── av-es6.js                      // 合并后的完整源码（ES6 版本）
│   ├── av.js                          // 合并并编译后的完整源码（ES5 版本）
│   ├── av-min.js                      // 合并、压缩并编译后的源码（ES5 版本）
│   ├── node                           // 目录中为生成的 nodejs 版本代码
│   └── ...
├── gulpfile.js
├── src
│   ├── av-browser.js                  // 浏览器环境入口文件，将会被 browserify 编译
│   ├── av-browser-core.js             // 浏览器环境入口文件，只包含核心依赖，将会被 browserify 编译
│   ├── av.js                          // node.js 环境入口文件
│   ├── browserify-wrapper             // 目录中为针对 node.js 与浏览器环境之间差异的不同实现
│   └── ...
├── package.json
├── readme.txt
├── test                               // 单元测试
│   └── ...
└── tools                              // 构建中依赖的第三方工具

官方新版本发布流程

• 修改版本号
  • src/version.js
  • package.json
  • bower.json
• 修改 Changelog
• 打包（执行 gulp release）
• 提交当前所有代码
  • 版本号相关修改
  • 对照 commit 历史写 change log
  • dist/ 目录中的新代码
• 提交代码，发 Pull Request
• 通过 review，merge 代码
• Github 生成 release 包（for bower）
• 发布到 npm，需 npm 协作者身份（执行 npm publish）
• 发布到 CDN，需要七牛权限（执行 gulp upload）
• 提醒所有相关工程师完善文档

Changelog

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。