VersioningDemos

版本控制演示

使用和不使用持續部署 (CD) 的 .NET Core 專案版本控制方法範例

如果您克隆此網站並在偵錯和發布模式下在本地運行它，您將看到不同的結果。您可以存取 https://versioningdemos.azurewebsites.net/ 上的即時版本，該版本已透過我的 Git 和 VSTS 產生版本資訊。

您會注意到，Microsoft 在自己的 .Net 庫中具有不同的版本控制策略，可能不是來自同一團隊。

.NET Core 程式集中通常會引用 3 個版本

• 檔案版本 - 用於查看哪個 DLL 較晚。
  • 它的模式xybr通常被認為是 Major.Minor.Build.Revision
• 產品版本 - 也稱為程序集中的資訊版本。這是用於描述目的的自由格式文字版本。
  • 目前其格式傾向遵循語意版本控制模式（由 GitHub 提出）
  • xyp-buildinfo主要.次要.補丁[-元資料]
  • 您可以在 semver.org 上閱讀更多內容
• 程序集版本 - 程序集的版本

您看到的用於檢索版本資訊的常規方法僅適用於某些用例，並且在放入庫中時會崩潰。

版本範例項目

所有這些項目都使用 .vbproj（也可能是 .csproj）文件，而不是以前使用 AssemblyInfo.cs 或 project.json 的技術

未設定任何內容 - 預設

• 預設為 1.0.0

設定值 - 手動

使用 Visual Studio UI（專案屬性/套件）

• 即使您不使用它來設定訊息，它也會顯示計算值
• 請小心，不要意外覆蓋其他地方計算的值
• 編輯.csproj

設定所有值 - Manual.AllDifferent

• 使用 Visual Studio 使用者介面
• 編輯.csproj

只需使用 VersionPrefix - VersionPrefix

版本後綴 - 版本後綴

建構修訂版 - 建構修訂版

• 透過實作 roslyn 的版本模式邏輯來複製建置和修訂通配符
• 使用 csproj 檔案中的計算

建置日期時間 - 建置日期時間

• 使用 x.YYYY.MDD.HHMM 建立自動值

Visual Studio 團隊服務建置 - VSTS

• 將配置的 BUILDNUMBER 從 VSTS 新增至 VersionSuffix

使用 Git 分支建置 Visual Studio Team Services - VSTS.WithGit

• 將 Git 分支加入版本後綴

標籤助手

使用 Taghelpers 時有幾個問題。

• 頁面最終被放置到與您預期不同的程序集中
• 在調試或發布中運行可能會給出不同的值和創建的程序集
• 將 TagHelper 放入外部庫中會變更目前執行的組件的結果