Skip to main content

範本設定檔定義

常見設定內容

template.json

名稱描述
identity此範本的唯一名稱
author範本的作者
classifications定義的值會顯示為 dotnet new 中的 Tags
name範本的名稱。當使用 dotnet new 和 Visual Studio 時,此名稱作為範本名稱顯示
groupIdentity此範本所屬群組的 ID。這允許將多個範本顯示為一個,並基於範本選項決定使用哪一個
tags常見的標籤包括:language, type。
-language: 指定範本使用語言。
- type: 指定範本類型 (project, item, solution)
shortName在 CLI 中可以使用該簡短名稱指定範本
postActions允許在建立後執行操作
constraints範本限制,可以指定作業系統或是 SDK 版本。 參考
sources可以對範本的來源目錄做設定,也可以根據條件設定不同的情境處理邏輯。
例如:開發範本過程,需要排除指定目錄下的資料 (bin/, obj/, .vs/...),可以透過exclude設定

ide.host.json

名稱描述
icon設定 IDE 上面的圖標

完整 Schema

Schema(template.json)
Schema(ide.host.json)

官方說明文件

範本的功能非常的強大,還有很多東西可以去做調整設定,甚至可以設定參數,根據使用者選擇不同的參數,調整實際上範本的輸出,如果想進一步了解的話,強烈建議可以參考下面的內容,基本上應該都在這邊會有說明。

Template wiki
template.json
官方範本參考