Breeze Studio VS Code Extension

重要

发布扩展代码需要安装nodejs的LTS版本，下载地址

看扩展点列表

看扩展点需要连接至设备/环境

连接 web

1. Mac: command + shift + P, Windows: ctrl + shift + P, 打开 VS Code 命令工具，输入 breeze: start websocket server
2. 打开 Chrome，下载 Chrome 的 breeze 插件
3. Chrome 打开销售易页面
4. 右上角点击 breeze 插件小图标
5. 点击连接

连接 mobile

1. Mac: command + shift + P, Windows: ctrl + shift + P, 打开 VS Code 命令工具，输入 breeze: start websocket server
2. VS Code 命令工具输入 breeze: qr
3. 移动端扫描二维码获取ip地址和端口
4. websocket 连接（仅限局域网ip）

连接 h5 企微

1. Chrome 打开 https://crm.xiaoshouyi.com/bff/breeze/wxwork
2. 继续连接 web 的操作

扩展点列表

1. 点击 VSCode 最左边边栏的 breeze 图标
2. 从上到下数第一栏是 所有扩展点的列表
3. 点击扩展点 查看扩展点信息
4. 右键扩展点 可复制扩展点代码
5. 点击右上角刷新图标 刷新页面（测试设备换页时）

写扩展代码

写扩展代码需要登录

登录

1. Mac: command + shift + P, Windows: ctrl + shift + P, 打开 VS Code 命令工具
2. 输入 breeze: login
3. 在打开的 webview 里登录
4. 登入时需要的权限：后台"职能管理" => "功能权限" => "后台功能" => "开发者平台"中勾选任一职能

扩展代码列表

1. 点击最左边边栏的breeze图标

2. 从上到下数第二栏是 所有扩展代码的列表

   • h5 代表企业微信
   • web 代表网页
   • mobile 代表移动端Ap
   • .extensions 代表旧版全局代码

3. 新租户将不会看到旧版全局代码，旧租户可以继续开发旧版全局代码，但建议迁移到用于不同端的新版扩展代码

4. 每个扩展代码左边会有状态指示图标

   • 没有图标表示没有代码
   • 绿色的勾代表已保存/发布
   • 黄色的笔代表更改了代码但是未保存/发布

5. 当没有h5, web, mobile时，销售易会尝试加载 .extensions 旧版全局扩展代码

编辑，发布扩展代码

1. 点击扩展代码名称 编辑扩展代码
2. 点击 扩展代码名称右边 发布图标，发布扩展代码到服务器
3. 点击 扩展代码名称右边 保存图标，保存扩展代码到服务器（不发布）
4. 右键 扩展代码名称 可重置扩展代码到上次保存的代码
5. 点击 右上角 ☁️下载图标，重新获取线上配置（覆盖当前）
6. 点击 右上角 ☁️上传图标，发布所有扩展代码

在设备上调试

1. 连接web/移动端app
2. 点击扩展点列表右上角上传图标 上传到测试设备
3. 测试设备切换一下页面后生效，刷新页面失效