VsCode插件开发之插件初步通讯

时间 2019-12-05

标签 vscode 插件开发初步通讯繁體版

原文原文链接

参考了Egret Wing，想像Egret Wing那样在上方titlebar最右边上面增长一个menu(这个menu相对于一个按钮，当点击这个按钮时会出现一个window弹框，这个window弹框里就包含相关的表单信息以供登陆或者注册使用。我是以这个做为参考模板的。可是目前进展并非很顺。因而我经过插件的方式暂时性解决了这个问题。可是以为还不是想要的那样。javascript

Egret Wing是这样的，如图所示:css

不得不认可一点Egret Wing改造的挺不错的，不愧是对VsCode进行魔改。html

今天先说一下经过插件通讯。vue

我主要参考的是一个叫小茗同窗的插件开发，并改造其插件来达到个人目的。java

这个小茗同窗我以为他写的插件开发，我以为不是特别详细全面，固然，参考意义仍是有的。node

他的插件开发目录以下:jquery

他的插件github地址为:https://github.com/sxei/vscode-plugin-demo.gitgit

他的插件能够在VsCode插件扩展中搜到(搜到后安装，而后直接在下载成功的插件的基础上改造)，例如:github

那么说说我是如何改造它的呢？web

我主要改造它这么几个地方？

一个是图标，另一个修改它的html界面(主要是修改custom-welcome.html)，同时我要和还改了package.json文件。

插件开发能够用TypeScript，也能够用JavaScript。

若是是用TypeScript的话，一般扩展脚本文件是extension.ts形式存在，若是是JavaScript，则是以extension.js的形式存在。

在此我想强调的是改他人插件或者本身编写插件，以ts为例，主要把握也就两个文件，一个是extension.ts，另外一个就是package.json。

如何从0开发以插件的相关视频，感兴趣的能够看看，感受仍是有必定的启发的:https://v.qq.com/x/page/k08220bdz3s.htmlb

我改造后的插件代码，放在个人我的github上，你们能够将其下载下来放入，以下两个文件中(任意一个都行):

注意:

.vscode文件夹:官方插件下载好默认放入的目录。

.vscode-oss-dev:下载源码，本身编译，下载插件放置的目录。

本身编译的不知道因为什么缘由不能直接联网通讯搜索一些应用市场下载的插件。

一般状况下(以.vscode-oss-dev为例)，git clone下来个人插件地址，而后将其移植到这个目录就能看到对应的效果，效果图以下:

个人VsCode插件地址为:https://github.com/youcong1996/study_simple_demo/tree/vscode-plugin-communication

将其克隆下来放入.vscode或者.vscode-oss-dev中的extensions目录下便可起做用。

另外有一点要强调的是，若是是vscode非本身编译的，须要重启一下vscode，若是是本身编译的话，监听须要暂时中断从新输入(yarn watch)。

接下来讲说我修改的三个地方。

1.修改package.json(包含图标一块儿说了及其点击登陆的同时展现对应的左侧栏sidebar)

{
    "name": "vscode-plugin-demo",
    "displayName": "vscode-plugin-demo",
    "description": "VSCode插件demo",
    "keywords": [
        "vscode",
        "plugin",
        "demo"
    ],
    "version": "1.0.3",
    "publisher": "sxei",
    "engines": {
        "vscode": "^1.27.0"
    },
    "categories": [
        "Other"
    ],
    "icon": "images/icon.png",
    "activationEvents": [
        "*"
    ],
    "main": "./src/extension",
    "contributes": {
        "configuration": {
            "type": "object",
            "title": "Code插件demo",
            "properties": {
                "vscodePluginDemo.yourName": {
                    "type": "string",
                    "default": "guest",
                    "description": "你的名字"
                },
                "vscodePluginDemo.showTip": {
                    "type": "boolean",
                    "default": true,
                    "description": "启动时显示自定义欢迎页"
                }
            }
        },
        "commands": [
            {
                "command": "extension.sayHello",
                "title": "Hello，小茗同窗"
            },
            {
                "command": "extension.demo.getCurrentFilePath",
                "title": "获取当前文件(夹)路径"
            },
            {
                "command": "extension.demo.testMenuShow",
                "title": "这个菜单仅在JS文件中出现",
                "icon": {
                    "light": "./images/tool-light.svg",
                    "dark": "./images/tool-light.svg"
                }
            },
            {
                "command": "extension.demo.openWebview",
                "title": "打开WebView"
            },
            {
                "command": "extension.demo.showWelcome",
                "title": "显示自定义欢迎页"
            }
        ],
        "keybindings": [
            {
                "command": "extension.sayHello",
                "key": "ctrl+f10",
                "mac": "cmd+f10",
                "when": "editorTextFocus"
            },
            {
                "command": "extension.demo.openWebview",
                "key": "ctrl+f9",
                "mac": "cmd+f9",
                "when": "editorTextFocus"
            }
        ],
        "menus": {
            "editor/context": [
                {
                    "when": "editorFocus",
                    "command": "extension.sayHello",
                    "group": "navigation@6"
                },
                {
                    "when": "editorFocus",
                    "command": "extension.demo.getCurrentFilePath",
                    "group": "navigation@5"
                },
                {
                    "when": "editorFocus && resourceLangId == javascript",
                    "command": "extension.demo.testMenuShow",
                    "group": "z_commands"
                },
                {
                    "command": "extension.demo.openWebview",
                    "group": "navigation"
                }
            ],
            "editor/title": [
                {
                    "when": "editorFocus && resourceLangId == javascript",
                    "command": "extension.demo.testMenuShow",
                    "group": "navigation"
                }
            ],
            "editor/title/context": [
                {
                    "when": "resourceLangId == javascript",
                    "command": "extension.demo.testMenuShow",
                    "group": "navigation"
                }
            ],
            "explorer/context": [
                {
                    "command": "extension.demo.getCurrentFilePath",
                    "group": "navigation"
                },
                {
                    "command": "extension.demo.openWebview",
                    "group": "navigation"
                }
            ]
        },
        "snippets": [
            {
                "language": "javascript",
                "path": "./snippets/javascript.json"
            },
            {
                "language": "html",
                "path": "./snippets/html.json"
            }
        ],
        "viewsContainers": {
            "activitybar": [
                {
                    "id": "beautifulGirl",
                    "title": "测试",
                    "icon": "images/beautifulGirl.svg"
                }
            ]
        },
        "views": {
            "beautifulGirl": [
                {
                    "id": "测试001",
                    "name": "test"
                },
                {
                    "id": "测试002",
                    "name": "test"
                },
                {
                    "id": "测试003",
                    "name": "test"
                }
            ]
        },
        "iconThemes": [
            {
                "id": "testIconTheme",
                "label": "测试图标主题",
                "path": "./theme/icon-theme.json"
            }
        ]
    },
    "scripts": {
        "postinstall": "node ./node_modules/vscode/bin/install",
        "test": "node ./node_modules/vscode/bin/test"
    },
    "devDependencies": {
        "typescript": "^2.6.1",
        "vscode": "^1.1.6",
        "eslint": "^4.11.0",
        "@types/node": "^7.0.43",
        "@types/mocha": "^2.2.42"
    },
    "license": "SEE LICENSE IN LICENSE.txt",
    "bugs": {
        "url": "https://github.com/sxei/vscode-plugin-demo/issues"
    },
    "repository": {
        "type": "git",
        "url": "https://github.com/sxei/vscode-plugin-demo"
    },
    "homepage": "https://github.com/sxei/vscode-plugin-demo/blob/master/README.md",
    "__metadata": {
        "id": "ac2b7b16-d87f-4e51-87a8-37011e8aa713",
        "publisherId": "cdd0fc1d-3acf-4250-a09b-95545e29bdbc",
        "publisherDisplayName": "小茗同窗"
    }
}

在package.json我也就修改了这么几个地方，一个是views(这个view一般主要用于展现左侧的sidebar视图)，一个是viewsContainers(我主要修改beautifulGirl.svg)。

修改后的效果分别以下所示:

2.通讯(修改custom-welcome.html)

通讯我目前采用最原始的javascript的ajax请求，其实jQuery及其vue.js的异步通讯也是能够的。

这个custom-welcome.html你能够理解成它就是一个webview。

custom-welcome.html文件内容以下:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>自定义欢迎页</title>
    <link rel="stylesheet" href="../../lib/bootstrap-3.3.1/css/bootstrap.min.css">
    <link rel="stylesheet" href="../../lib/layui/css/layui.css">
    <style>
        html, body, #app {
            height: 100%;
        }
        ::-webkit-scrollbar {
            width: 10px;
            height: 10px
        }

        ::-webkit-scrollbar-track {
            border-radius: 10px;
            background-color: #d8dce5
        }

        ::-webkit-scrollbar-thumb {
            border-radius: 5px;
            background-color: #adadad
        }

        ::-webkit-scrollbar-thumb:hover {
            background-color: #929292
        }

        ::-webkit-scrollbar-thumb:active {
            background-color: #666363
        }

        ::-webkit-scrollbar-corner {
            background-color: #535353
        }

        ::-webkit-scrollbar-resizer {
            background-color: #ff6e00
        }
        .page-title {
            margin-bottom: 20px;
        }

        .control-label {
            font-weight: normal;
        }

        .btn-primary {
            background-color: #1890ff;
            border-color: #1890ff;
            outline: none;
        }

        .btn-primary:focus,
        .btn-primary:hover {
            background-color: #40a9ff;
            border-color: #40a9ff;
            outline: none;
        }

        .btn-primary.active,
        .btn-primary:active {
            background-color: #096dd9;
            border-color: #096dd9;
            color: #fff;
            outline: none;
        }
    </style>
</head>

<body>
    <div id="app" class="container-fluid">
        <h3 class="page-title">自定义欢迎页</h3>
        <p class="alert alert-success" style="width: 300px;">{{userName}}，{{time}}好！
        <span id="info"></span>
        </p>
        <form class="form-horizontal">
            <div class="form-group">
                <div class="col-sm-6">
                    <div id="form">
                        <form>
                            <p>用户名:<input type="text" id="userName" style="color:black;"/></p>
                            <p>密&nbsp;&nbsp;码&nbsp;&nbsp;:<input type="password" id="password" style="color:black;"/></p>
                            <p>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<input type="button" style="color:black;" value="提交" onclick="test()"/>
                        <input type="button" value="打开" onclick="openLogin()"/>
                         </form>
                    </div>
                    <div class="checkbox">
                        <label>
                            <input type="checkbox" v-model="show"> 启动时显示自定义欢迎页
                            &nbsp;&nbsp;
                            <input type="button" onclick="register()" value="退出"/>
                        </label>
                    </div>
                </div>
            </div>
        </form>



    </div>
    <script src="../../lib/jquery/jquery.min.js"></script>
    <script src="../../lib/bootstrap-3.3.1/js/bootstrap.min.js"></script>
    <script src="../../lib/vue-2.5.17/vue.js"></script>
    <script src="../../src/view/custom-welcome.js"></script>
    <script src="../../lib/layui/layui.js"></script>
    <script src="../../lib/layer/layer-v3.1.1/layer/mobile/layer.js"></script>
    <script>
    function openLogin(){
        layui.use('layer', function(){
          var layer = layui.layer;
    
          layer.open({
                type: 2,
                title: 'Login',
                fix: false,
                maxmin: true,
                shadeClose: true,
                shade: 0.8,
                area: ['500px', '500px'],
                content: 'login.html',
                end: function () {
                   location.reload();
                }
            });
        });
    }

    function test(){
           var userName = document.getElementById("userName").value;

           if(userName != null && userName != undefined){
            var xhr = new XMLHttpRequest();
                xhr.onreadystatechange = function () {
                if (xhr.readyState == 4) {
                if ((xhr.status >= 200 && xhr.status < 300) || xhr.status == 304) {
                $("#info").html("登陆成功");
                $("#form").hide();
                
                console.log('test:'+xhr.status);
                console.log(xhr.responseText);
                } else {
                console.log("请求成功：" + xhr.status);
                }
                }
                };
                xhr.open("POST", "http://www.test.com/test-web/sysUser/getUserCodeByInfo?userCode=2", true);
                xhr.send(null);
                
            }else{
                layui.use('layer', function(){
                
                var layer = layui.layer;
                
                layer.msg('userName为必填项');
                }); 
            }

           }
    function register(){
        $("#info").html("");
        $("#form").show();
    }
                
    </script>
</body>

</html>

这个html在浏览器上看到的效果以下所示:

目前这仅仅是一个很初级的(蹩脚通讯)，后续我将会继续补充对VsCode的源码解析及其插件开发相关的详细说明，因为目前掌握的比较分散不够系统，暂时延后讲解。