如何發行 Visual Studio 專案範本(project Template)

最近在學習 Microsoft Bot Framework 相關應用,其中官網上的 Startup 請大家下載一個 zip 放到指定的目錄(vs2015 放在 Documents\Visual Studio 2015\Templates\ProjectTemplates\Visual C#),接著就可以在 Visual Studio 上出現專案範本了。雖然滿容易的,但我隱約覺得也許有更好的方式。

準備 Project Template

這邊就使用 Bot Framework Downloads 當做範例

建立 VSIX 專案

  1. File –> New –> Project…

    newproject

  2. Templates –> Visual C# –> Extensibility –> VSIX

    addvsix

  3. 將從Microsoft Bot Framework 上下載回來的 Bot Application.zip 加入專案

    addzip

  4. Bot Application.zipCopy to Output Directory 屬性改為 Copy always

    copyalways

  5. 編輯 source.extension.vsixmanifest(Metadata)

    依序填入

    • 5-1. Product Name
    • 5-2. Product ID
    • 5-3. Author
    • 5-4. Version
    • 5-5. Description

      manifest

  6. 新增 source.extension.vsixmanifest(Assets)

    • 6-1. Assets –> New

      assetsnew

    • 6-2. 選擇 Type,Source,Path

      • Type : Microsoft.VisualStudio.ProjectTemplate
      • Source : File on filesystem
      • Path : 選擇 Bot Application.zip

        assetsdone

  7. Build project 在專案檔案位置的bin資料夾會產出 .vsix檔 ,即可用來安裝

發行至 Visual Studio Marketplace

  • 開始發行

    upload

  1. 選擇擴充功能類型–> 專案或文章範本

    extendtype

  2. 上傳檔案

    uploadfile

  3. 填寫基本資料

    • 描述要超過 280 字,記得同意投稿協議

      basicinfo

  4. 預覽

    readttopublish

  5. publish

    published

測試

  1. 套件管理員

    extensionmanager

  2. Visual Studio Gallery 搜尋 bot

    searchbot

  3. 新專案 –> 搜尋已安裝專案範本–> Bot Application

    bottemplate

  4. 成功產生 bot application 專案

    PROJECTOK

優缺點

  • 優點:用 VSIX(擴充套件) 來新增,不需額外下載及記憶 template 位置,方便大家使用.
  • 缺點:不像自行丟檔,可以有明顯的 template 位置,必需透過搜尋,新增時比較好找.

  • 我自行包裝的 VSIX 不會出現下圖 Bot applications 的分類(可能是我設定上的問題)

    templatefolder

參考資料

  1. Microsoft Bot Framework
  2. Bot Framework Downloads
  3. Getting Started with the VSIX Project Template
  4. Visual Studio Marketplace