就像 chrome 插件使用 manifest.json 来管理插件的配置一样，vscode 的插件也有一个 manifest，而且就叫 package.json，在这里，我们可以除了可以配置插件的名字，版本号，icon 外，还可以配置插件提供哪些功能，乃至发布所需要的信息。所有字段可以查看 官方文档，本文只谈其中几个与开发发布相关的字段。

Activation Events 是 package.json 里的一个字段，决定了用户安装了一个插件之后，插件什么时候激活，然后开始工作。比如安装之后已启动 vscode 就激活，可以这么写：

  1. "activationEvents": [
  2.     "*"
  3. ]

如果希望启动完成后激活可以使用 onStartupFinished;

在打开某个类型的文件时激活，如 log 文件：

  1. ...
  2. "activationEvents": [
  3.     "onLanguage:log"
  4. ]
  5. ...

更多启动事件可参考 https://code.visualstudio.com/api/references/activation-events

Contribution Points 可以理解为我们开发的插件要提供什么能力，我们可以在多个方面来拓展 vscode，大到支持一门语言的语法高亮和 lint，小到提供一个命令或者按钮，都在这里定义。比如提供一个命令：

  1. {
  2.  "contributes": {
  3.    "commands": [
  4.      {
  5.        "command": "extension.sayHello",
  6.        "title": "Hello World", // 提供更友好的名称
  7.        "category": "Hello",
  8.        "icon": {
  9.          "light": "path/to/light/icon.svg",
  10.          "dark": "path/to/dark/icon.svg"
  11.        }
  12.      }
  13.    ]
  14.  }
  15. }

为了实现 extension.sayHello，我们在 extension.ts 通过 commands.registerCommand 来实现这个命令：

  1. vscode.commands.registerCommand('extension.sayHello',() => {
  2. 	console.log('hello world');
  3.    vscode.window.showInformationMessage('hello!')
  4. })
  5.

这样当我们 ctrl+shift+p 并输入 sayHello 时，就会执行插件 sayHello 对应的函数。

我们还可以在右键菜单中插入一个选项：

  1. "menus": {
  2.       "explorer/context": [
  3.         {
  4.           "when": "resourceScheme == file",
  5.           "command": "extension.base64",
  6.           "group": "base64"
  7.         }
  8.       ]
  9.     }

上面 这个 json 表示在 vscode 的文件管理器中，添加一个将文件转换成 base64 的右键菜单。效果如下：
uploading-image-819282.png

完整代码见 img2base64，所有的 contribute point 见 https://code.visualstudio.com/api/references/contribution-points

发布主要是用到 vsce 这个工具进行发布。主要会用到几个命令:

  1. vsce create-publisher (publisher name) #创建一个publisher
  2. vsce login (publisher name) # 使用publisher name登录
  3. $ cd myExtension
  4. $ vsce package
  5. # myExtension.vsix generated
  6. $ vsce publish
  7. # <publisherID>.myExtension published to VS Code MarketPlace

然后建议先完整看一遍官方的发布到插件市场的 教程。需要注意的地方是在生成 token 的时候，需要严格按照文档来操作，如果后续发布时遇到的登录报 401 的问题，请参考下面的链接。

  • engines

用于标记插件所需的最低版本，如果没有使用很新的 api，建议还是往下设几个版本，以支持不是最新的 vscode，如果没有使用不兼容的 api, 设成 * 也可以

  1. 	"engines": {
  2. 		"vscode": "*"
  3. 	}
  • token 401 问题
    确保你的 token 生成时 orgnization 选的是 All accessiable orgnizations，

https://github.com/microsoft/vscode-vsce/issues/11

希望本文可以帮助大家少踩些坑（完）

版权声明：本文为imgss原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://www.cnblogs.com/imgss/p/13503637.html