vscode插件開發（3）-打包發佈

發佈方式

發佈方式主要有3種，第一種是直接將開發好的插件文件夾發給使用者，使用者將文件夾放到vscode 插件文件目錄後重啓vscode即可，第二種是如果插件中有內部機密，可以打包vsix插件，第三種是發佈到擴展應用市場，我這裏選擇的發佈方式是通過註冊開發者賬號發佈到官方應用市場

流程

官方文檔流程

1. 註冊一個Microsoft賬號：https://marketplace.visualstudio.com/

2. 登錄後，點擊右上角的用戶名
   

3. 創建一個組織
   

4. 第一個continue是選擇同意條款，第二個continue上面的輸入框輸入組織名，下面我選擇的東亞
   
   

5. 創建一個新項目
   
   我這裏選的scrum，具體流程模型選項的深入理解：https://docs.microsoft.com/en-us/azure/devops/organizations/projects/create-project?view=azure-devops&tabs=preview-page

6. 獲取個人訪問令牌
   vsce只能使用個人訪問令牌發佈擴展
   新建令牌：
   
   
   有效期最長時間一年，Origanization要選All accessible origanizations每個組織都可以訪問它，Scopes選Full access允許所有訪問
   
   創建後會提示成功，圖片上的是發佈插件時需要用到的token，一定要自己記住，網站不會記錄，只顯示一次，每次發佈插件或者迭代更新的時候都要輸入這個token

vsce

vsce是用於打包，發佈和管理VS代碼擴展的命令行工具
下載安裝：(首先要安裝node)

npm install -g vsce

用法：

vsce --help				查看所有可用的vsce命令

命令：

• ls：列出會實際發佈的文件列表
• package：打包
• publish：發佈
• unpublish：插件下架
• list：列出某個發佈者所有發佈的
• ls-publishers：列出所有已知的發佈者
• create-publisher：創建一個新的發佈者
• delete-publisher：刪除一個發佈者
• login：登錄一個發佈者到發佈者列表中
• logout：退出發佈者

創建發佈者

vsce create-publisher xxxxxxxxx(發佈者名)
E-mail: xxxxxxxxxxxxxxxxx	//輸入email
Personal Access Token:	//將剛剛創建的token序列粘貼到這裏

創建成功後會默認登錄這個賬號，vsce會記住當前賬號的token令牌，接下來即可打包發佈，如果退出這個賬號，下次登錄的時候還是需要輸入token的

打包

vsce package

發佈

vsce publish

1. 打包發佈的文件中要有README.md、CHANGELOG.md和LICENSE
2. README.md的資源必須全部是HTTPS，如果是HTTP會發布失敗
3. README.md文件內容會顯示在插件主頁的細節一欄下
4. CHANGELOG.md文件內容會顯示在插件更改日誌中
5. 如果代碼放在了git倉庫，設置了repository字段，發佈前必須先git提交

最後

這樣就發佈成功了，幾分鐘後就可以在vscode的擴展中搜到啦
我開發的主題：Cool-girls-theme
大佬的參考鏈接：
VS Code 折騰記 - (10) 你想發佈自己搗鼓的snippets到VSCode插件市場!
VSCode插件開發全攻略（十）打包、發佈、升級

附：
(⊙o⊙)…打包的時候發現不會寫LICENSE，找了一個開源許可證MIT License如下，需要的同學可以直接cv到自己的項目裏，將第二行的名字換成自己的即可

MIT License

Copyright (c) 2020-present SuWanQing

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.