在 Jenkins 中使用 MSBuild 進行建置。
1、環境配置
專案使用 Visual Studio 進行開發,需要使用 MSBuild 進行建置,選擇安裝「MSBuild」與「Visual Studio」其中一種。
1.1 MSBuild
在 Jenkins 伺服器主機上安裝符合開發環境的 MSBuild。
- Visual Studio 2015:Microsoft Build Tools 2015。
- Visual Studio 2017:Build Tools for Visual Studio 2017。
1.2 Visual Studio
在 Jenkins 伺服器主機上安裝符合開發環境的 Visual Studio。
2、Jenkins 套件管理
由 Jenkins 主畫面依序點選「管理 Jenkins」 → 「管理外掛程式」,進入「Jenkins 套件」管理頁面。
2.1 安裝 MSBuild plugin
點選「可用的」頁籤,輸入過濾條件「MSBuild」,選取【MSBuild】並按下【下載並於重新啟動後安裝】。
套件安裝過程中會將相依套件一併載入安裝,安裝完成後顯示「下載成功。下次啟動後就會生效。」。
當套件與相依套件全部下載完成後,按下【當安裝完成且沒有工作正在執行時,重啟 Jenkins】重新啟動 Jenkins。
3、Jenkins 工具組態設定
由 Jenkins 主畫面依序點選「管理 Jenkins」 → 「Global Tool Configuration」,進入「Jenkins 工具組態」設定頁面。
3.1 設定 MSBuild plugin
頁面中有標示為 MSBuild 的區塊(安裝 MSBuild plugin 產生的區塊),按下【新增 MSBuild】,輸入「Name」與「Path to MSBuild」。
- Visual Studio MSBuild 預設路徑
- 2015(x86):C:\Program Files (x86)\MSBuild\14.0\Bin\MSBuild.exe
- 2015(x64):C:\Program Files (x86)\MSBuild\14.0\Bin\amd64\MSBuild.exe
- 2017(x86):C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\MSBuild\15.0\Bin\MSBuild.exe
- 2017(x64):C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise\MSBuild\15.0\Bin\amd64\MSBuild.exe
4、工作組態設定
由 Jenkins 主畫面依序點選「Lab.Jenkins_VisualStudio」(前面新增的工作名稱) → 「組態」,進入「工作組態」設定頁面。
4.1 建置
點選「建置」頁籤,按下【新增建置步驟】 → 【Build a Visual Studio project or solution using MSBuild】(安裝 MSBuild plugin 產生的選項),選擇「MSBuild Version」,輸入「MSBuild Build File」,按下【儲存】儲存工作組態設定。
- MSBuild Version:在【3.1 設定 MSBuild plugin】中設定。
- MSBuild Build File:可輸入專案或方案路徑,路徑可以是相對路徑(相對於工作區域)或是絕對路徑。
4.2 工作建置
按下【馬上建置】,此時此項工作會使用 MSBuild Version 對 MSBuild Build File 進行建置。
- MSBuild Version:在【3.1 設定 MSBuild plugin】中設定,在【4.1 建置】中選擇。
- MSBuild Build File:在【4.1 建置】中設定。
在建置歷程的建置結果列表中,點選建置結果可以查看更詳細的建置紀錄。
點選「Console Output」,進入「終端機輸出」頁面,可以看到此次此項工作使用 MSBuild Version 對 MSBuild Build File 進行建置。
- Jenkins Plugins:MSBuild
嘗試將自己的理解寫成文字紀錄,資料來源均來自於網路。
如有理解錯誤、引用錯誤或侵權,請多加指正與告知,讓我有更多的進步與改進的空間,謝謝!