vscode插件开发-发布插件

安装vsce

vsce是“Visual Studio Code Extensions”的缩写，是一个用于打包、发布和管理VS Code扩展的命令行工具。

确保您安装了Node.js。然后运行：

npm install -g @vscode/vsce

您可以使用vsce轻松打包和发布扩展：

// 打包插件生成name.vsix文件 
vsce package 

// 发布插件 
vsce publish

vsce还可以搜索、检索元数据和取消发布扩展。有关所有availablevsce命令的参考，请运行vsce --help。

发布扩展

Visual Studio Code使用Azure DevOps进行其市场服务。这意味着通过Azure DevOps提供扩展的身份验证、托管和管理。

vsce只能使用个人访问令牌发布扩展。您需要至少创建访问令牌一个才能发布扩展。

如果不想创建访问令牌可以通过Visual Studio Marketplace手动发布扩展。

获取访问令牌

首先，按照文档在Azure DevOps中创建自己的组织。在以下示例中，组织名称为vscode。请注意，组织的名称不一定与您的出版商名称相同

从您组织的主页（例如：https://dev.azure.com/vscode），打开您的个人资料图像旁边的用户设置下拉菜单，然后选择个人访问令牌：编辑在个人访问令牌页面上，选择新令牌：
在创建新的个人访问令牌模式中，为令牌选择以下详细信息：
1. Name: 任意名称
2. Organization: 不重复的组织
3. Expiration (optional): 为令牌设置所需的到期日期
4. Scopes：定义范围：
  1. 单击下方的Show all scopes(显示全部)链接
  2. 在范围列表中，滚动到Marketplace并选择Manage
点击创建。您将看到您新创建的个人访问令牌。将其复制到安全位置，您需要它来创建publisher。

创建一个publisher

publisher是一个可以向Visual Studio Code市场发布扩展的身份。每个扩展都需要在其package.json文件包含一个publisher属性。

创建publisher：

转到Visual Studio Marketplace出版商管理页面
使用您在上一节中用于创建个人访问令牌的同一微软帐户登录
单击左侧窗格中的Create publisher。
在新页面中，指定新发布者的强制性参数-Name和Id（分别为Name和ID字段）：
1. Name：您的publisher的唯一名称，将与您的扩展一起显示在Marketplace中。
2. ID：Marketplace中publisher的唯一标识符，将用于您的扩展URL。创建后无法更改ID。以下是Docker扩展的发布者标识符和名称示例：
其他字段可选填。
点击创建

使用vsce验证新创建的publisher。在您的终端中，运行以下命令，当出现提示时，键入上一步中创建的个人访问令牌：

// Id为publisher Id
vsce login Id

https://marketplace.visualstudio.com/manage/publishers/
Personal Access Token for publisher '<publisher id>': ****************************************************

The Personal Access Token verification succeeded for the publisher '<publisher id>'.

验证后，您就可以发布扩展了。

手动发布

// 打包插件生成name.vsix文件 
vsce package

访问Visual Studio Marketplace，并登陆上一节中创建的Microsoft账户，然后点击右上角的Publish extension

如果我们按照上文创建了publisher，就会直接进入到下面的页面，我们点击New extension选择Visual Studio Code上传我们打包好的以vsix为后缀的文件即可

上传成功后我们就可以在插件库中看见我们上传的插件了（上传后大概五到十分钟就可以在vscode中搜索到我们上传的插件了）

更新扩展

修改package.json中的version。

重新运行vsce package打包自动发布或直接运行vsce publish