zoo-vscode-extension README

政采云前端团队内部 vscode 插件，该插件主要解决开发中的场景里面涉及到的各种问题的辅助帮助。

该插件从以下功能去切入到开发场景

功能

云长发布

远端云长构建项目并且发布能力

前置条件

• [x] 政采云内部员工使用，因为必须要有域账号

  插件会尝试登陆，如果失败会出现对话框重新输入用户名和密码，并且之后也能在“设置”页面中修改用户名和密码

• [x] 项目必须在敦煌中注册过，如果没有请移步到敦煌

• [x] 本人必须要有当前项目的权限，如果没有请在敦煌中为当前项目加入当前使用者

• [x] git 需要以 ssh 方式验证，如果仍然使用 https 的请切换回 ssh 方式

功能介绍

• 普通云长发布

  • 展开“云长发布”，选择对于的分支，选择需要发布的环境，点击按钮发布

    

• 最近高频环境快速构建

  • 展开“云长发布”，展开最近高频构建环境，选择需要发布的环境，点击按钮发布

  • 备注：里面会根据最近 5 次当前分支的构建记录做去重处理，并且鼠标移动到环境上会出现该环境的最近一次构建信息。里面包括最近一次构建人，构建 commiId

    

• 任务栏快速构建

  • 上面这两种构建方式为了更快的构建，我们也在任务栏中增加了他们的对应入口，点击他们和在视图栏流程一模一样，只是为了让大家更加的方便去构建。
  • 普通构建快速入口
  • 最近高频环境快速入口

• 构建过程实时显示

  • 开始构建之后，任务栏中会实时更新进度状态，点击可以打开一个 tab 里面会展示整个构建的状态，该状态信息和云长实时同步

    

    

本地发布

本地构建项目并且发布能力

前置条件

• 目前只支持小程序本地发布构建，自动识别是否为小程序项目，如果是小程序项目则该功能会出现在左侧视图栏里

• 本插件是以命令行的方式调起本地微信小程序开发工具

  • [x] 小程序发布依赖本地微信开发者工具，如未安装 请前去下载
  • [x] 检查开发者工具设置：需要在开发者工具的设置 -> 安全设置中开启服务端口。

功能介绍

• 一键构建小程序

  • 选择需要构建的本地目标分支

  • 点击 图标开发发布

  • 选择本次构建类型，自动生成版本号

    

  • 填写本次构建描述

  • 开始构建插件会有如下提示

    

  • 构建过程中点击任务栏中可以看到具体构建流程

  • 构建流程显示如下

    

• 多项目小程序设置隔离

  • 点击任意窗口中的
  • 展开“本地发布”
  • 设置 dev，test，staging，prod 四个环境中上传小程序 AppId 和部署小程序 AppId
    • 上传小程序 Appid 为你是开发者的小程序 appid，只有开发者才能上传
    • 部署小程序 Appid 为你需要部署的 appid，和是否为开发者不相关

路由

展示当前项目中路由，并且提供直接切换到路由对于的文件的能力

前置条件

• 必须是要用 zoo cli 标准脚手架构建出来的项目
• reactjs 查找 src/routes 文件夹下面的每个子文件夹的 index.js
• vue 查找 src/routes.js
• Uniapp 查找 src/pages.json

功能介绍

• 快速跳转路由对于的文件

  

proxy 配置

修改项目中 config/proxy.js 实现快速切换项目环境和账号

前置条件

• 必须是要用 zoo cli 标准脚手架构建出来的项目
• 查找 config/proxy.js
• 查找 package.json 中的 repository.url/name
• 敦煌中针对自己的项目维护了账号

功能介绍

• 快速切换账号环境 点击 实现切换

  • 首先敦煌在自己项目下维护好角色
    • 入口
    • 找到自己的项目并且将账号关联在自己的项目下
    • 如果没有对应的账号点击 切换到账号管理页面 进入账号管理页面
    • 点击新增在环境下维护好自己的账号
    • 维护好后再点击 切换到项目关联账户页面
    • 再给自己的项目绑定账号,最终效果如下
    • 在 VSCode 中就可以看到维护的额角色

前端组建库

快速打开前端组建库

前置条件

• 公司内网

功能介绍

• 快速展示前端组建库 点击 开发组建库

  

设置

设置配置

功能介绍

• 小程序发布设置

• 域账号设置

历史版本

0.1.19

功能:

1. 新增图片上传 cdn 快捷入口（快捷键：cmd+shift+2；右键:上传）

0.1.18

功能:

1. 更改代码片段数据从 git 仓库获取
2. 增加代码片段埋点

V 0.1.17

功能:

1. 增加代码片段功能

V 0.1.9

功能:

1. 增加云长构建的终止功能

bug:

1. 修复云长构建中，构建失败后，构建进程无法终止的情况

V 0.1.6

bug:

1. 增加云长接口 fap 前缀

V 0.1.5

bug:

1. 修复切换分支导致频繁触发“应用未找到”弹框问题

V 0.1.4

功能:

1. 增加 proxy 代理，账号切换模块，可以快速切换环境和账号
2. 增加前端组建看模块，可以快速找到前端需要的组建库
3. 增加构建前后自定义钩子能力
4. 增加构建中图标提示

bug:

1. 修复部分机芯无法启动问题

V 0.1.3

功能:

1. 增加小程序发布时如果模板已满的话可以删除无用版本的能力

bug:

1. 修复首次打开时候没有自动显示仓库问题
2. 修复取消登录的情况下，点击再次刷新没有重新要求输入用户名密码问题
3. 修复在无权限下再敦煌添加之后，点击刷新无法更新项目权限问题

V 0.1.2

bug:

1. 向下兼容到 1.23

V 0.1.1

功能:

1. 增加无权限和未录入项目提示
2. 调整错误信息内容展示

V 0.1.0

功能:

1. 重构流程页面
2. 增加真线文案提示 y

bug:

1. 修复标题和刷新按钮图片问题
2. 修复设置不显示问题
3. 修复浅色主题不显示图标问题

V 0.0.8

功能:

1. 全新的云长编辑流程展示页面
2. 增加市场中插件图片显示

bug:

1. 修复“设置”，“发布”图标丢失问题

V 0.0.7

bug:

1. 修复应用市场中没有图标问题

V 0.0.6

功能：

1. 增加状态栏快速唤起云长构建功能
2. 增加状态栏快速根据最近构建分支快速构建
3. 新增”最近高频构建环境“
4. 在成功提示框和重复构建提示框中增加当前构建项目信息的提示
5. 新增自动更新远端分支
6. 新增不同项目自带不同配置（目前只能在小程序构建中才能看的出）

Bug:

1. 修复息屏问题
2. 修复 input 无法失去焦点关闭
3. 修复 git restore 命令不兼容问题
4. 修复取消选择”已有镜像“之后仍然构建问题

V 0.0.5

功能：

1. 增加云长构建
2. 增加本地构建
3. 增加路由能力
4. 增加设置