使用 SlowCheetah 轉換組態檔

上回介紹的幾個好用 Visual Studio 擴充工具當中的 SlowCheetah 的用法簡介。

其實官網就有介紹用法了,這裡只是記錄我對 NLog.config 做組態轉換的實驗過程。結論:SlowCheetah 真是好物!

對特定組態檔加入轉換功能

舉例來說,我想要在每次發布網站時,除了 web.config 之外,還要對 NLog.config 進行相應之組態檔轉換,那麼我可以在 Solution Explorer 中對 NLog.config 點右鍵,再點 Add Transform,如下圖:


第一次在專案中使用 SlowCheetah 的 Add Transform 功能時,會出現如下提示訊息,意思是為了加入組態檔轉換功能,此專案必須加入 SlowCheetah 的相關設定,問你是否真要這麼做。


選擇「是」之後,記得要把 Solution Explorer 的「Show All Files」功能開啟,才看得到它幫你產生的組態檔:


以下範例是我開啟 NLog.LocalDisk_Release.config 之後所編輯的內容:

<?xml version="1.0" encoding="utf-8" ?>
<!-- For more information on using transformations 
     see the web.config examples at http://go.microsoft.com/fwlink/?LinkId=214134. -->
<nlog xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform" xmlns="http://www.nlog-project.org/schemas/NLog.xsd">
    <rules xdt:Transform="Replace">
      <!-- add your logging rules here -->
      <logger name="*" minlevel="Debug" writeTo="file" />
      <logger name="*" minlevel="Warn" writeTo="eventLog" />
      <logger name="*" minlevel="Error" writeTo="mail" />
    </rules>
</nlog>

語法就跟我們在 web.config 組態轉換時所用的相同,不用另外學習新語法。

預覽和發布

編輯完成之後,可以對特定版本的組態檔預覽其轉換結果,操作如下圖所示:

預覽結果會以差異比對的方式呈現:


最後,試試直接用 Visual Studio 發布(publish)網站,然後查看發布的目標資料夾,裡面的 NLog.config 果然如預期地轉換成功了。Cool!

小提醒:
SlowCheetah 的組態檔轉換功能,在右鍵選單裡面的顯示名稱是「Add Transform」,而且無論是否已經產生好供轉換用的組態檔,此選項總是可點的(enabled)。Visual Studio 內建的組態檔轉換功能在右鍵選單裡面叫做「Add Config Transform」,且一旦所有供轉換的組態檔皆已產生,該選項就會灰掉(disabled)。

沒有留言:

技術提供:Blogger.
回頂端⬆️