This article will help you upgrade your solutions templates safely and easily to the latest major or minor version. The latest templates can be found on our repository and the latest nightly build can be found here. The first thing to do is to download the template framework you wish to update.
After the templates have been downloaded and extracted. Remove or Replace the old templates with the new ones keeping the same folder structure or simply update your CodeSmith Generator Project File(s) to point to the updated templates. If you have custom made changes, this is where you merge in your changes.
I recommend using our templates via git.
This will ensure easy upgradability while keeping any custom changes. To update
all you need to do is run
git pull from the command line.
The next step is to remove any template dependent references from your Visual Studio Project so the new references can be updated. These references would include the CodeSmith.Data assembly if you are using PLINQO or the Csla assembly. Both of these assemblies can be found in the Common folder in the root of the template directory. This can be done by clicking on your project references and clicking remove. The references will be automatically added when you run the templates. Please note that if the paths are the same then you can skip this step, but I recommend completing this step just to be on the safe side.
Lastly, if you have any build breaks fix them by compiling. You shouldn’t have any build breaks but this can happen if you are migrating to the next major version (E.G. 4.0).
If you encounter any bugs after upgrading please let us know by contacting support.