# LeanCloud JavaScript SDK

JavaScript SDK for LeanCloud.

## 安装

    // npm 安装
    npm install leancloud-storage --save
    // npm 安装 2.x 版本
    npm install leancloud-storage@2 --save

    // bower 安装
    bower install leancloud-storage --save

## 文档

- 安装文档
- 使用文档
- API 文档

## 支持

- 如果你发现了新的 bug，或者有新的 feature request，请新建一个 issue
- 在使用过程中遇到了问题时
  - 如果你是商用版用户，请新建一个工单。
  - 也可以在 论坛 提问、讨论。

## 贡献

如果你希望为这个项目贡献代码，请按以下步骤进行：

- `fork` 这个项目
- `npm install` 安装相关依赖
- 开发和调试
- 确保测试全部通过 `npm run test`，浏览器环境打开 `test/test.html`
- 提交并发起 `Pull Request`

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

    ├── dist                               // 编译之后生成的文件将会在此目录下
    │   ├── av.js                          // 浏览器版本
    │   ├── av-min.js
    │   ├── av-rn.js                       // React Native 版本
    │   ├── av-weapp.js                    // 小程序版本
    │   ├── av-weapp-min.js
    │   ├── node                           // 目录中为生成的 nodejs 版本代码
    │   └── ...
    ├── src
    │   ├── index.js                          // node.js 环境入口文件
    │   └── ...
    └── test                               // 单元测试

## 发布流程

1. 遵循 semver 提升版本号
   - src/version.js
   - package.json
   - bower.json
2. 对照 commit 历史写 changelog
3. 提交当前所有改动
4. 等待持续集成 pass
5. 使用 GitHub 基于 dist 分支发布一个 release（for bower）
6. Fetch and checkout remote `dist` branch 并确认该提交的内容是即将发布的版本
7. npm publish（`npm publish`，需 npm 协作者身份），如果是 pre-release 版本需要带 next tag
8. 发布到 CDN，需要七牛权限（执行 `gulp upload`）