摘要

本文主要介绍了vscode 插件开发的流程,以及一些小的技巧!开发中使用到的是vscode、node以及一些依赖。针对快速预览,我在这次项目中使用到的是http serve以及socket,为什么会使用到socket,本文会详细讲到

说明

本次项目的诞生主要是因为懒,在重复又重复的工作中开始有些厌烦,很早就萌生了一键开发、快速生成、便捷修改、模块化的概念。然而在落地页中这些都不能像使用框架那么容易实现。所以这次偶然间遇到了vscode插件可以实现部分功能。我就开始了其妙之旅。

开发

一、准备工作

1、vscode插件开发我们需要申请微软的开发token,用于打包、上线使用,没有这个token无法完成打包! 移步至:Microsoft vscdeo 开发者管理系统

创建一个projects
step-01.jpg
进入个人 token页
step-02.jpg
申请一个token

step-03.jpg


得到token,这里一定要注意复制并保存token ,要不然关闭后就找不到了就得重新再申请一个token!


step-04.jpg

2、 vscode插件生产工具:官方推荐使用Yeoman 和 VS Code Extension Generator。用如下命令安装:

// 安装自动化工具
npm install -g yo generator-code

// 生成开发项目文件
yo code


// 运行

     _-----_     ╭──────────────────────────╮
    |       |    │   Welcome to the Visual  │
    |--(o)--|    │   Studio Code Extension  │
   `---------´   │        generator!        │
    ( _´U`_ )    ╰──────────────────────────╯
    /___A___\   /
     |  ~  |
   __'.___.'__
 ´   `  |° ´ Y `

? What type of extension do you want to create? (Use arrow keys)
> New Extension (TypeScript)
  New Extension (JavaScript)
  New Color Theme
  New Language Support
  New Code Snippets
  New Keymap
  New Extension Pack
(Move up and down to reveal more choices)

//在os系统上通过上下键来选择要创建的类型
//在win系统上输入1、2、3后按回车来选择

至此开发所需的准备已做好,生成的项目目录结构如下:

├── .vscode      // 资源配置文件
├── CHANGELOG.md // 更改记录文件,会展示到vscode插件市场
├── extension.js // 拓展源代码文件
├── jsconfig.json
├── package.json // 资源配置文件
├── README.md    // 插件介绍文件,会展示到vscode插件市场
├── test         // 测试文件
└── vsc-extension-quickstart.md;


二、项目配置

让我们打开package.json文件!



1、 下图是我们最后开发好的效果,在侧边栏上有两个按钮,一个是复制使用,一个是预览使用。点开复制专题按钮后是两个栏目,一个是模板,一个是历史项目文件夹名称。


null


2、 下图是我们状态栏的代码,红框1中是vscode 侧边活动栏的按钮配置代码,里面有名称,icon图片!篮框2中是点开后的栏目,里面有名称,以及执行任务的id,打开vscode后会执行id对应的程序方法!


null




3、 下图是默认文件夹地址,主要是用于获取用户的项目目录!后期用户使用时是可以在vscode 的settings.json 文件中配置,非常方便。


null


4、 下图是我们的项目依赖,项目依赖分为两部分,一部分是开发使用,一部分是项目使用,也就是打包后也需要使用的依赖!这些是要放到dependencies里面的。
在安装时作者遇到过cnpm安装不成功的情况,改用npm安装后就可以了


null


三、强撸代码



1、 下面是我们extension.js文件中部分代码片段拿来说明,主要也就是这两段代码的一些功能在项目中使用!

// 这里生成的代码是 hzcj-project-vs-cli.view 当用户点击文件夹名称时会调用这个方法
createCommand(context, 'hzcj-project-vs-cli.view', function(args) {
    if(!liveView.pageIsOpen){
        cp.exec('start http://127.0.0.1:8108/index.html'); 
    }
    liveView.socket.emit('message',"http://localhost:8109/" + args +"/index.html")
})

// 这里的代码是生栏目中的项目目录,会在栏目中显示,并且携带了方法名称
vscode.window.registerTreeDataProvider(
    'hzcj-project-vs-view.special',
    new SpecialTreeData({root: conf.project, command: 'hzcj-project-vs-cli.view'}),
);



2、 下面是creat.js文件中部分代码片段,主要是用于复制粘贴文件使用!

const path = require('path');
const shell = require('shelljs');
const mkdirp = require('mz-modules/mkdirp');

module.exports = class Download {
  constructor() {}

  copy(sourceDir, targetDir, option = { dir: '', hide: true }) {
  
  }
  formatNumber  (n){
   
  }
  getDate(){
   
  }
  async init(demoPath, projectPath, pkgName) {
    const self = this;
    let projectName =  self.getDate()  +"-"+ pkgName ;
    const sourceDir = path.join(projectPath, projectName);
    await mkdirp(sourceDir);
    self.copy(demoPath, sourceDir);

    return sourceDir;
  }
};



3、 下面是LiveView.js文件中部分代码片段,主要是用于快速预览使用!


const fs = require('fs');
var http=require('http')
var sio=require('socket.io')
const cp = require('child_process');
const vscode = require('vscode');

module.exports = class LiveView {
    constructor(){
        this.clientServe = null
        this.projectServe = null
        this.socket = null
        this.pageIsOpen = false
        this.conf = vscode.workspace.getConfiguration('hzcj') ;
    }
    init(path){
        this.creatClientServe(path);
        this.creatProjectServe();
        this.creatSocket();
        // return this;
    }
    creatClientServe(path){
        // 客户端窗口 服务
        this.clientServe = http.createServer((req,res)=>{
            var url = req.url;
            let isScoket = url.indexOf('socket.io/?EIO') >-1?true:false;
            if(url.indexOf('socket.io/?EIO')>-1){
                return;
            }
            
            if(url=='/' || url.indexOf('html') > -1 && !isScoket){
                res.writeHead(200,{'Content-Type':'text/html'});
                fs.readFile(path + '/src/index.html', function(err, data) {
                    if (err) {
                        console.error(err);
                        return;
                    }
                    res.end(data);
                });
            }else if(url != '/' && !isScoket){
                var surl = url;
                var type = surl.substr(surl.lastIndexOf(".")+1,surl.length)
                res.writeHead(200,{'Content-type':"text/"+type});
                fs.readFile(path +"/src"+ surl, function(err, data) {
                    if (err) {
                        console.error(err);
                        return;
                    }
                    res.end(data);
                });
            }
        }).listen(8108);//创thhp建服务器
        // 打开页面
        cp.exec('start http://127.0.0.1:8108/index.html'); 
    }
    creatProjectServe(){
        this.projectServe= http.createServer((req,res)=>{
            var url = decodeURI(req.url);
            //  console.log("==========url=",__dirname,url)
             // respone.writeHead(200,{'Content-Type':'text/html'});
            
            if(url=='/' || url.indexOf('html') > -1){
                res.writeHead(200,{'Content-Type':'text/html'});
                fs.readFile(this.conf.project  + url, function(err, data) {
                    if (err) {
                        console.error(err);
                        return;
                    }
                    res.end(data);
                });
            }else if(url != '/'){
                var surl = url;
                var type = surl.substr(surl.lastIndexOf(".")+1,surl.length)
                res.writeHead(200,{'Content-type':"text/"+type});
                fs.readFile(this.conf.project  + surl, function(err, data) {
                    if (err) {
                        console.error(err);
                        return;
                    }
                    res.end(data);
                });
            }
        }).listen(8109)
    }

    creatSocket(){
        this.socket = sio.listen(this.clientServe)//监听http服务器
        // console.log("=====listen===openServer")
        this.socket.on('connection', ()=> {
            this.socket.emit('message','服务器socket工作中!');
            this.pageIsOpen  = true;
            this.socket.on('my other event', function (data) {
              console.log(data);
            });
            this.socket.on('disconnect', function () { // 这里监听 disconnect,就可以知道谁断开连接了
                console.log("=====socket===:断开连接了");
                this.pageIsOpen  = false;
            });
            
          });
    }
}
;

egsong
19 声望1 粉丝