經過了幾天的理論介紹,我們開始要進入建制專案的部分。
我們會先拿一個Asp .net Mvc的網站作為第一個要建制的專案,所以我們會先建立出來,然後在使用MSBuild帶來的幫助,幫我們快速建立專案
(之後下面提到的code都可以從這邊看到內容:github repo,這篇會是tag sample/chapter6)
MSBuild和Psake的關係
在我們往下之前,有一個關係要在說明一下。我們使用psake並不是說要完全放棄MSBuild,反而是兩個結合在一起得到兩者的好處。
首先,我們知道VS其實有很多不同類型的專案,而這些不同類型的專案在建制過程呼叫方式都完全不太一樣。因此,微軟提供了很多不同project的msbuild target(同等於task的概念)來處理 怎麼建制這些專案和要copy那些檔案。
因此,我們不會重複造車輪,而是直接使用MSBuild所帶來的便利。
不過這個時候會好奇,那當初不就直接用MSBuild就好?
原因非常簡單,要擴充MSBuild非常麻煩。需要用C#才有辦法寫,然後又要處理一堆xml。
反過來看psake,非常簡單,只要定義一個powershell script就好。
所以,接下來我們會看到MSBuild被執行就沒什麼好奇怪。
準備程式用於做建制測試
我們需要先把環境準備好方便接下來的測試。
首先我們先建立一個Asp .net Mvc的專案,先看看有web專案情況會如何。
我們會建立一個asp .net mvc的專案,並且包含預設的Test專案
開始建制我們的專案
基本上在建制專案的時候,有3個重要參數,說明一下:
- 建制模式 - 一般我們都會設定要用Debug還是Release(預設模式)
- 目標的platform - 一般有三個值,x64、x86和Any Cpu
- 建制結果的位置 - 要把建制結果放在那裡,以我們來說就是 .build\temp 裡面
有了這三個部分之後,我們就可以來調整我們Compile的Task
首先,剛剛提到的三個參數,第1和第2要增加,而第3我們已經有了。和其他參數一樣,我們會把這個加在properties
裡面,這樣才有可能可以把值覆蓋。
Properties{
...
$buildConfiguration = "Release"
$buildTarget = "Any CPU"
}
再來的會就是我們實際的Compile
task:
task Compile -depends Clean, Init -description "編譯程式碼" `
-requiredVariables solutionFile, buildConfiguration, buildTarget, buildTempDirectory `
{
Write-Host "開始建制檔案:$solutionFile"
msbuild $solutionFile "/p:Configuration=$buildConfiguration;Platform=$buildTarget;OutDir=$buildTempDirectory"
}
這邊使用到了msbuild
做實際的編譯,然後用到了requiredVariables
去做參數的驗證。
這個時候我們就可以去執行build.ps1
,會發現一切正常,但是有幾個小問題。
修正Compile時候出現的幾個小問題
MSBuild使用的.Net版本錯了
首先從build的日誌裡面可以看到,我們使用的MSBuild版本是4.6,但是我們的.Net Framework卻是4.0,但是實際上我們的project是用4.5.2寫的。如果用到4.5.2才有的功能, 很可能導致編譯錯誤。
這個很好解決,在Invoke-psake
有個參數叫做framework
,用這個可以設定build的target framework。
所以在build.ps1
Invoke-psake -buildFile .\default.ps1 -taskList Test `
-framework "4.5.2" `
-parameters @{
"solutionFile" = (Get-ChildItem("..\*.sln")).FullName |
Sort-Object $_ | select -Last 1
}`
-properties @{
"testMsg"="測試訊息"
}
Console看不出哪段是psake在執行
msbuild的內容比較多,造成看不太清楚那段屬於task記錄執行。不過psake有提供一個叫做FormatTaskName
,能夠定義Task執行的時候顯示的內容。
在default.ps1
可以增加以下方法
FormatTaskName ("`r`n`r`n" + ("-"*25) + "[{0}]" + ("-"*25))
結語
在這篇我們開始把psake和msbuild做了結合,並且把一個mvc網站建立了出來。
在下篇,我們會看看被compile出來的結果,和加入console和library專案,看看建制結果是否有不同。