VSCode插件开发全攻略之打包、发布、升级的详细教程
⼀、发布⽅式
插件开发完了,如何发布出去分享给他⼈呢?主要有3种⽅法:
⽅法⼀:直接把⽂件夹发给别⼈,让别⼈到vscode的插件存放⽬录并放进去,然后重启vscode,⼀般不推荐;
⽅法⼆:打包成vsix插件,然后发送给别⼈安装,如果你的插件涉及机密不⽅便发布到应⽤市场,可以尝试采⽤这种⽅式;
⽅法三:注册开发者账号,发布到官⽹应⽤市场,这个发布和npm⼀样是不需要审核的。
⼆、本地打包
⽆论是本地打包还是发布到应⽤市场都需要借助vsce这个⼯具。
安装:
npm i vsce -g
打包成vsix⽂件:
vsce package
打包的时候如果没有设置repository会有提⽰,所以最好设置⼀下。
⽣成好的vsix⽂件不能直接拖⼊安装,只能从扩展的右上⾓选择Install from VSIX安装:
三、发布应⽤市场
Visual Studio Code的应⽤市场基于微软⾃⼰的Azure DevOps,插件的⾝份验证、托管和管理都是在这⾥。
要发布到应⽤市场⾸先得有应⽤市场的publisher账号;⽽要有发布账号⾸先得有Azure DevOps组织;⽽创建组织之前,⾸先得创建Azure账号;创建Azure账号⾸先得有Microsoft账号;是不是有点晕,梳理⼀下:
⼀个Microsoft账号可以创建多个Azure组织;⼀个组织可以创建多个publisher账号;同时⼀个组织可以创建多个PAT(Personal Access Token,个⼈访问令牌);
注册账号
点击继续,默认会创建⼀个以邮箱前缀为名的组织。
创建令牌
默认进⼊组织的主页后,点击右上⾓的Security:
点击创建新的个⼈访问令牌,这⾥特别要注意Organization要选择all accessible organizations,Scopes要选择Full access,否则后⾯发布会失败。
创建令牌成功后你需要本地记下来,因为⽹站是不会帮你保存的。
创建发布账号
获得个⼈访问令牌后,使⽤vsce以下命令创建新的发布者:
vsce create-publisher your-publisher-name
your-publisher-name必须是字母数字下划线,这是全⽹唯⼀的账号,然后会依次要求输⼊昵称、邮箱、令牌:
创建成功后会默认登录这个账号,接下来你可以直接发布了,当然,如果你是在其它地⽅创建的,可以试⽤vsce login your-publisher-name来登录。
发布
发布很简单:
vsce publish
vscode⾥⾯也能搜到了:
发布注意事项README.md⽂件默认会显⽰在插件主页;README.md中的资源必须全部是HTTPS的,如果是HTTP会发布失败;CHANGELOG.md会显⽰在变更选项卡;如果代码是放在git仓库并且设置了repository字段,发布前必须先提交git,否则会提⽰Git working directory not clean;
另外,如前⾯所说,如果Organization没有选择all accessible organizations,或者Scopes没有选择Full access,发布的时候可能会报如下错误:
3.4.2增量发布
版本号:major.minor.patch
如果想让发布之后版本号的patch⾃增,例如:1.0.2 -> 1.0.3,可以这样:
vsce publish patch
执⾏这个命令后会⾃动修改package.json⾥⾯的版本号。同理,vsce publish minor也是可以的。
3.5取消发布
vsce unpublish (publisher name).(extension name)
3.6更新
如果修改了插件代码想要重新发布,只需要修改版本号然后重新执⾏vsce publish即可。
4.插件升级
4.1发布到了应⽤市场
如果发布到了应⽤市场,那么⼀般来说会⾃动检测有没有新版本,有的话会⾃动⽆感知升级,但具体什么时候会去检测我还没有研究过,已经确定的是在扩展⾯板搜索插件名字会⾃动检测,重启vscode 也会检测。
4.2如果是本地打包
如果是打包成vsix,那么只能⾃⼰实现升级检测功能呢,通过对⽐服务器上某个⽂件的版本号,具体我就不细讲了。
总结
安装应用商店到此这篇关于VSCode插件开发全攻略(⼗)打包、发布、升级的⽂章就介绍到这了,更多相关VSCo
de打包、发布、升级内容请搜索以前的⽂章或继续浏览下⾯的相关⽂章希望⼤家以后多多⽀持!
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论