This package enables you to transform your app.config or any other XML file based on the build configuration. It also adds additional tooling to help you create XML transforms.. Written by: Sayed Ibrahim Hashimi, Chuck England and Bill Hiebert
Terrific work -- the only problem with web.config can be solved with a little trickery (http://stackoverflow.com/questions/16225304/using-slowcheetah-config-transforms-on-web-config-in-a-3-5-web-forms-app).
Very useful. I like that it looks at the Publish Profiles, although be cautious when you rename a Profile, it does not rename the previously generated transform files. But you can always regenerate and delete the old.
Simply does not work with ClickOnce. I have not found any information that shows how to make XML transformations work with ClickOnce. You can run the transform preview and it looks correct, but the .config.deploy file generated by ClickOnce is the original, untransformed config file. Very frustrating and completely unusable in my situation.
A real must if you wish to deploy to different machine with different configuration settings stored inside some other [filename].config. Still wonder why Microsoft don't have this functionality out of the box.
I spent an afternoon trying to get this going for a team project. After a fair while thrashing with the already-mentioned "The SlowCheetah.Xdt.TransformXml" task could not be loaded from the assembly" problem, I eventually solved it by deleting the %localappdata%\Microsoft\MsBuild\Slowcheetah folder and it semed to resolve itself on my local machine and I was allowed to build and run stuff. I then deployed this to my colleagues who didn't have the plugin, under the impression that the NuGet package would make everything alright. No joy, regardless of what I tried. I'm now having to see if I can hand-roll a solution for changing config settings for people. Gets 2 stars because I like the idea and it kind of worked on my machine.
We are encountering the following error on many computer, we just downloaded the latest version, and we are trying it on VS2013:
The "SlowCheetah.Xdt.TransformXml" task could not be loaded from the assembly C:\Users\Ahmad\AppData\Local\Microsoft\MSBuild\SlowCheetah\v2.5.10\SlowCheetah.Xdt.dll. Could not load file or assembly 'file:///C:\Users\Ahmad\AppData\Local\Microsoft\MSBuild\SlowCheetah\v2.5.10\SlowCheetah.Xdt.dll' or one of its dependencies. The system cannot find the file specified. Confirm that the <UsingTask> declaration is correct, that the assembly and all its dependencies are available, and that the task contains a public class that implements Microsoft.Build.Framework.ITask.
We tried to search the path, there is two folders:
C:\Users\Ahmad\AppData\Local\Microsoft\MSBuild\SlowCheetah\v22.214.171.124; this contains the vs extension,
C:\Users\Ahmad\AppData\Local\Microsoft\MSBuild\SlowCheetah\v2.5.10; this contains a copy of my project !!! what is that?
I am getting the following build error
Error 28 Could not copy "bin\Debug\app.config" to "C:\Users\ara\AppData\Local\Microsoft\MSBuild\SlowCheetah\v2.5.10\bin\Debug\app.config". Exceeded retry count of 10. Failed.
If I delete all files (except 2 files) in
then I can build the project. However, after that I cannot build another project in the same solution
Error 17 Could not copy the file "bin\Debug" to the destination file "C:\Users\ara\AppData\Local\Microsoft\MSBuild\SlowCheetah\v2.5.10\bin\Debug", because the destination is a folder instead of a file. To copy the source file into a folder, consider using the DestinationFolder parameter instead of DestinationFiles.
Why is this happening? It seems like the SlowCheetah is trying to write the projects output to the same directory.
I don't know if this is relevant, when I run install-package SlowCheetah I get the following:
PM> install-package SlowCheetah
'SlowCheetah 126.96.36.199' already installed.
[ProjectName] already has a reference to 'SlowCheetah 188.8.131.52'.
Failed to generate binding redirects for '[ProjectName]'. 'Microsoft.Tools.WindowsInstallerXml.VisualStudio.WixProjectNode' does not contain a definition for 'References'
Great tool! One problem though: When you try to transform a root-element Visual Studio tells me: Could not write Destination file: Object reference not set to an instance of an object.
I'm using VS2012 Update 3 and SlowCheetah 184.108.40.206 (NuGet package). An example of my config file (Invoice.Debug.config):
<?xml version="1.0" encoding="utf-8" ?>
<InvoicePaymentService xmlns:xdt="http://schemas.microsoft.com/XML-Document-Transform" cancelUrl="http://mysite.nl/winkelen/geannuleerd/" returnUrl="http://onderwijsadvies.preview.gengu.nl/winkelen/bedankt/" debug="False" testMode="True" xdt:Transform="Replace">
I've tested it with multiple config files and settings. Re-created the transforms etc...
Not sure if the installer got botched, but after upgrading to 2.5.10 from 220.127.116.11, our test machine began to copy files into a C:\Users\user.x.name\AppData\Local\Microsoft\MSBuild\SlowCheetah\v2.5.10 directory. The files it copied were the project files that were being built. I was able to work around the issue by defining the SlowCheetahToolsPath in the SlowCheetah.Transforms.targets file to define the tool path. Is there something I can do so I don't have to hack the targets file manually in order to get SC to work?
After both a VS restart and machine restart, SC is still creating a v2.5.10 directory next to the v1 directory in the user profile\local\microsoft\msbuild\slowcheetah directory. The contents of the directory seem to be all of the project files for any project that contains transforms. They get copied over each other as a project with a transform is processed. When I uninstall and reinstall SC, the problem persists.
I worked around this problem with a conditional Using in my SC tarets file. Stick these two lines in @ line 36 in your C:\Users\<you>\AppData\Local\Microsoft\MSBuild\SlowCheetah\v1\SlowCheetah.Transforms.targets file. The 2nd using will use the correct v1 location.
<UsingTask TaskName="SlowCheetah.Xdt.TransformXml" AssemblyFile="$(sc-MSBuildLibPathLocal)SlowCheetah.Xdt.dll" Condition="Exists('$(sc-MSBuildLibPathLocal)SlowCheetah.Xdt.dll')"/>
<UsingTask TaskName="SlowCheetah.Xdt.TransformXml" AssemblyFile="SlowCheetah.Xdt.dll" Condition="Exists('SlowCheetah.Xdt.dll')"/>
I'm getting the following error message when trying to use SlowCheetah 2.5.10:
Error 45 The "SlowCheetah.Xdt.TransformXml" task could not be loaded from the assembly C:\Users\hrcorval\AppData\Local\Microsoft\MSBuild\SlowCheetah\v2.5.10\SlowCheetah.Xdt.dll. Could not load file or assembly 'file:///C:\Users\hrcorval\AppData\Local\Microsoft\MSBuild\SlowCheetah\v2.5.10\SlowCheetah.Xdt.dll' or one of its dependencies. The system cannot find the file specified. Confirm that the <UsingTask> declaration is correct, that the assembly and all its dependencies are available, and that the task contains a public class that implements Microsoft.Build.Framework.ITask.TestSuitesUI
This problem was not happening when using version 2.5.5, and it started happening after updating to this version.
Are you using Ncrunch?
If you are you must include the slowcheetah package in Ncrunch.
You didn't have to do this in verison 2.5.5
I'm not using Ncrunch yet, I'm just using NUnit framework. What I did was to install the SlowCheetah package from Visual Studio Gallery, add transforms in the configuration file and compile the solution.
I'm currently using VS Ultimate 2012 with .Net fwk 4.5
I'm new to SlowCheetah and was wondering if someone could provide a simple example for me. I've setup a simple C# app, and I added one setting to the settings called ServerName. In the App.Config file I see:
<setting name="ServerName" serializeAs="String">
I've right clicked on App.config and created the transform files and I see them. I'm having trouble with the syntax of the transform. I've tried several variations, but I think:
<add key="ServerName" value="DevServer" xdt:Transform="Replace" xdt:Locator="Match(key)"/>
<add name="ServerName" xdt:Transform="Replace" xdt:Locator="Match(name)">
Should be correct but it's not working. What am I missing?
Thanks in advance for your help!
Okay, I figured it out:
<setting name="ServerName" serializeAs="String" xdt:Transform="Replace">
works. Is this the best way?
My example above is missing an xdt:Locator and will drive you nuts. here's some example transforms which are working for me:
<!-- We don't want to change the Flow Through setting so nothing special has to be done -->
<!-- To Delete a setting, use the Transform Remove -->
<setting name="DeleteThisSetting" xdt:Transform="Remove" xdt:Locator="Match(name)"/>
<!-- To Change a Setting, use the Transform Replace -->
<setting name="ATweakedSetting" serializeAs="String" xdt:Transform="Replace" xdt:Locator="Match(name)">
<value>This Setting was tweaked in app.debug.config</value>
<!-- To Add a Setting, Use Transform Insert-->
<setting name="AnotherAddedSetting" serializeAs="String" xdt:Transform="Insert">
<value>This Setting was added in app.debug.config.</value>
<!-- if you want to get REAL picky on where it goces, use Insert After -->
<!-- The xpath expression does the heavy lifting -->
<setting name="AnotherAddedSettingPlacedAfterServerName" serializeAs="String"
<value>This Setting was added in app.debug.config.</value>
Basically I'm trying to integrate into build process on TFS and I'm following instructions from a blog post you had. It is not showing the extra project that you are mentioning in the post.
Please see question on StackOverflow.
Is it possible to create transform that doesn't depend on configuration?
I need to make transform for localization purposes.
I have file Data.xml and I need a transform Data.ru-RU.xml which will replace some values in source file and produce output localized file Data.ru-RU.xml
This means that I need original file Data.xml to be included in project as well as translated one Data.ru-RU.xml
Love the product, and have been using it for a while with great success. After an update today though my Azure Worker Role project no longer builds with the following error:
Error 21 The "SlowCheetah.Xdt.TransformXml" task could not be loaded from the assembly C:\Users\idrennan\AppData\Local\Microsoft\MSBuild\SlowCheetah\v2.5.10\SlowCheetah.Xdt.dll. Could not load file or assembly 'file:///C:\Users\idrennan\AppData\Local\Microsoft\MSBuild\SlowCheetah\v2.5.10\SlowCheetah.Xdt.dll' or one of its dependencies. The system cannot find the file specified. Confirm that the <UsingTask> declaration is correct, that the assembly and all its dependencies are available, and that the task contains a public class that implements Microsoft.Build.Framework.ITask. InternalServices
Could you provide any guidance as to the cause? Also, below is the relevant line(s) in my .proj file that seem to now be causing the issue:
<SlowCheetahTargets Condition=" '$(SlowCheetahTargets)'=='' ">$(LOCALAPPDATA)\Microsoft\MSBuild\SlowCheetah\v1\SlowCheetah.Transforms.targets</SlowCheetahTargets>
<Import Project="$(SlowCheetahTargets)" Condition="Exists('$(SlowCheetahTargets)')" />
This is the error that my colleague was experiencing. I bet if you look in that directory (C:\Users\idrennan\AppData\Local\Microsoft\MSBuild\SlowCheetah\v2.5.10) you'll find a copy of the project files you were building at the time the build failed.
It seems that necessary files are placed at %APPDATA%\..\Local\Microsoft\MSBuild\SlowCheetah\v1. Copy files from the folder to %APPDATA%\..\Local\Microsoft\MSBuild\SlowCheetah\v2.5.10.
List of files:
This solved the problem you stated for me. However, I continue to get following error, for which I have not found any solution:
The "SlowCheetah.Xdt.TransformXml" task was not found. Check the following: 1.) The name of the task in the project file is the same as the name of the task class. 2.) The task class is "public" and implements the Microsoft.Build.Framework.ITask interface. 3.) The task is correctly declared with <UsingTask> in the project file, or in the *.tasks files located in the "C:\Windows\Microsoft.NET\Framework\v4.0.30319" directory.
Hey, if you are running Ncrunch then it's causing the build error.
Install version 18.104.22.168 (important to get that version cause verison 22.214.171.124 and 126.96.36.199 doesn't work) of slowcheetah and include the package in Ncrunch and it will work again. :)
So following Zendu's suggestion worked (this is a clan install computer btw).
I copied the files from the v1 folder to the v2.5.10, restarted VS, and then it seemed to work.
Sayed-Ibrahim-Hashimi - hopefully this gives you enough info to troubleshoot/fix the issue.
Can SlowCheetah transform app.config for WCF projects when published using the file publish method.
I currently have Version 2.5.10 installed and it does not appear to be transforming an publish for my WCF project.
We have multiple target environments (DEV/QA, etc.). Since the only things that change are configuration settings (nothing done with precompilation statements) we'd rather not have to have a configuration per environment; seems like a waste to recompile for each environment since the code is the same. We'd also like to minimize the customization of the SlowCheetah.Transforms.targets file. Is there a recommended way to compile the code once and get SlowCheetah to create transformed config files for multiple environments?
Thanks in advance
No, I haven't. I was hoping to get a reply from Sayed but never did. I know I could do it by customizing the targets file to use a custom variable like $(Environment) instead of $(Configuration) but I was hoping to not customize anything so that I wouldn't have to revisit the targets file to check for possible conflicts.
Overall, I do like SlowCheetah I just really dislike how it and XML Transforms overall are married to build configurations. The binaries for us are not different per environment. The only thing that is different is just the configs. We currently use XML Preprocess and so far, I'm thinking we're going to stick to it.
This is exactly the problem I'm experiencing. I'm trying to overcome the problem by only referencing the SlowCheetah target, but that doesn't work:
MSBuild [path to project file] /t:TransformAllFiles /p:Configuration=Release
I found a pretty decent work around for this, while still using SlowCheetah.
I created some afterbuild events:
<TransformXml Source="web.config" Transform="Web.Staging.config" Destination="webstaging.config" />
<TransformXml Source="web.config" Transform="Web.Release.config" Destination="Webrelease.config" />
With the devops tool we are using (Buildmaster) The files are renamed and replaced on the correct environments.
It's not ideal, but you still have central config files (web.config and umbracoSettings.config), and you only have to manage the changes in the XMLtransform files.