2024-12-23 11:44:48 +08:00
|
|
|
|
# 星云SDK
|
|
|
|
|
|
|
|
|
|
|
|
## 介绍
|
|
|
|
|
|
星云SDK是一款为开发者打造的智能锁SDK，旨在简化与智能锁与星云平台的交互。通过封装底层操作，使接入者无需关注锁的操作逻辑，能够将更多精力集中在业务开发中。
|
|
|
|
|
|
|
|
|
|
|
|
星云SDK项目可根据不同的打包命令生成用于不同平台的npm包，目前支持的平台有：uni，web。
|
|
|
|
|
|
|
|
|
|
|
|
## 文件说明
|
|
|
|
|
|
- `star-cloud`：星云SDK支持的对外暴露的功能，根据功能模块拆分成多个文件
|
|
|
|
|
|
- `uni`：星云SDK需要的uniapp平台的底层功能，如请求、缓存等。index.js为uni平台npm包的入口文件，可选择暴露哪些功能到uni平台
|
|
|
|
|
|
- `web`：星云SDK需要的web平台的底层功能，如请求、缓存等。index.js为web平台npm包的入口文件，可选择暴露哪些功能到web平台
|
|
|
|
|
|
- `api`: 星云内部接口请求地址
|
|
|
|
|
|
- `common`: 公共方法
|
|
|
|
|
|
- `constant`: 常量
|
|
|
|
|
|
- `env`: 环境配置，打包版本设置
|
|
|
|
|
|
- `export.js`: 根据不同平台暴露平台支持的功能
|
|
|
|
|
|
- `format.js`: 格式化数据相关公共方法
|
|
|
|
|
|
- `log.js`: 不同平台的日志上报方法
|
|
|
|
|
|
- `obfuscation.js`: 不同平台的混淆打包方法
|
|
|
|
|
|
- `star-cloud.js`: StarCloud类
|
|
|
|
|
|
|
|
|
|
|
|
## 使用方法
|
|
|
|
|
|
1. 安装npm包
|
|
|
|
|
|
```shell
|
|
|
|
|
|
npm install
|
|
|
|
|
|
```
|
|
|
|
|
|
2. 打包uni平台npm包
|
|
|
|
|
|
```shell
|
|
|
|
|
|
npm run uni-build
|
|
|
|
|
|
```
|
|
|
|
|
|
打包web平台npm包
|
|
|
|
|
|
```shell
|
|
|
|
|
|
npm run web-build
|
|
|
|
|
|
```
|
|
|
|
|
|
3. 发布npm包
|
|
|
|
|
|
进入dist目录，执行npm publish命令
|
|
|
|
|
|
```shell
|
|
|
|
|
|
cd dist
|
|
|
|
|
|
npm publish
|
|
|
|
|
|
```
|
|
|
|
|
|
若未登录npm账号，需先登录
|
|
|
|
|
|
```shell
|
|
|
|
|
|
npm login
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 调试方法
|
2025-01-07 18:11:07 +08:00
|
|
|
|
1. 执行想要调试的平台命令
|
|
|
|
|
|
```shell
|
|
|
|
|
|
npm run web-build
|
|
|
|
|
|
npm run uni-build
|
2024-12-23 11:44:48 +08:00
|
|
|
|
```
|
2025-01-07 18:11:07 +08:00
|
|
|
|
2. 将项目与调试项目放在同级目录下，在调试项目中执行npm命令
|
|
|
|
|
|
```shell
|
|
|
|
|
|
npm install ../[项目名称]
|
2024-12-23 11:44:48 +08:00
|
|
|
|
```
|
2025-01-07 18:11:07 +08:00
|
|
|
|
3. 即可在调试项目中用调用正式版npm包方法进行调试
|
2024-10-12 14:35:58 +08:00
|
|
|
|
|
