如何发布一个vscode插件

3,476 阅读2分钟

当你开发完一个vscode插件后,需要把他上传到市场,这里做一下上传的记录,方便以后观看。

vsce

这是一个命令行工具,用来打包/发布/管理插件的命令行工具

# 安装
npm install -g vsce

发布

vscode使用Azure DevOps Services | Microsoft Azure来管理插件,需要也只能通过使用个人访问令牌 - Azure DevOps | Microsoft Docs来发布插件。

获取个人访问令牌

首先在Azure DevOps上创建组织,然后创建一个项目

然后创建个人访问令牌,注意这里的权限范围选择MarketPlace > Manage即可

image.png image.png

创建publisher

publisher是用来发布插件到vscode插件市场的身份,每个插件都需要在package.json里包含publisher这个字段。

你需要再Manage Extensions | Visual Studio Marketplace创建一个publisher,这里需要注意的是这里必须使用刚才创建个人访问令牌的微软账号,这里的publisher需要和你package.json里的publisher字段一样

创建完后,我们验证下:

vsce login <publisher name>

然后会让你输入刚刚创建的个人访问令牌,输入后出现下面类似提示表示正常:

The Personal Access Token verification succeeded for the publisher '你取的publisher名字'.

发布插件

vsce publish

如果你刚刚没有使用vsce login xxx, 那么这里会先让你输入个人访问令牌

注意,登录时报错403或401,大概率是创建令牌的时候,没有在组织那栏选择All accessible organizations

你也可以选择直接在Manage Extensions | Visual Studio Marketplace手动上传插件:

image.png

自动升级插件版本

当你想发布新插件时,可以指定major,minor,path来自动升级版本。例如如果你想要把当前插件版本从1.0.0变到1.1.0, 那就使用如下指令:

vsce publish minor

在发布插件前,它会自动去更新package.json内的版本。

你也可以直接输入指定的版本:

vsce publish 2.0.1

参考资料