UppercuT v1.0 and 1.1–Linux (Mono), Multi-targeting, SemVer, Nitriq and Obfuscation, oh my!

UppercuT v1 yoRecently UppercuT (UC) quietly released version 1 (in August). I’m pretty happy with where we are, although I think it’s a few months later than I originally planned. I’m glad I held it back, it gave me some more time to think about some things a little more and also the opportunity to receive a patch for running builds with UC on Linux. We also released v1.1 very recently (December).

UppercuT v1

Builds On Linux

Perhaps the most significant changes to UC going v1 is that it now supports builds on Linux using Mono! This is thanks mostly to Svein Ackenhausen for the patches and working with me on getting it all working while not breaking the windows builds!  This means you can use mono on Windows or Linux.

Notice the shell files to execute with Linux that come as part of UC now.

uc shell files

Multi-Targeting

Perhaps one of the hardest things to do that requires an automated build is multi-targeting. At v1 this is early, and possibly prone to some issues, but available. 

We believe in making everything stupid simple, so it’s as simple as adding a comma to the microsoft.framework property. i.e. “net-3.5, net-4.0” to suddenly produce both framework builds.

microsoft.framework

net-3.5,net-4.0

When you build, this is what you get (if you meet each framework’s requirements):

UC muli-targeting output

At this time you have to let UC override the build location (as it does by default) or this will not work. 

Semantic Versioning

By now many of you have been using UppercuT for awhile and have watched how we have done versioning. Many of you who use git already know we put the revision hash in the informational/product version as the last octet.

At v1, UppercuT has adopted the semantic versioning scheme. What does that mean?

This is a short read, but a good one: http://SemVer.org

SemVer (Semantic Versioning) is really using versioning what it was meant for. You have three octets. Major.Minor.Patch as in 1.1.0.  UC will use three different versioning concepts, one for the assembly version, one for the file version, and one for the product version.


All versions - The first three octects of the version are owned by SemVer.

  • Major.Minor.Patch
  • i.e.: 1.1.0

Assembly Version - The assembly version would much closer follow SemVer. Last digit is always 0.

  • Major.Minor.Patch.0
  • i.e: 1.1.0.0

File Version - The file version occupies the build number as the last digit.

  • Major.Minor.Patch.Build
  • i.e.: 1.1.0.2650

Product/Informational Version - The last octect of your product/informational version is the source control revision/hash.

  • Major.Minor.Patch.RevisionOrHash
  • i.e. (TFS/SVN): 1.1.0.235
  • i.e. (Git/HG): 1.1.0.a45ace4346adef0

SemVer is not on by default, the passive versioning scheme is still in effect. Notice that version.use_semanticversioning has been added to the UppercuT.config file (and version.patch in support of the third octet):

Versioning with added SemVer properties

Gems Support

Gems support was added at v1. This will probably be deprecated as some point once there is an announced sunset for Nu v1. Application gems may keep it around since there is no alternative for that yet though (CoApp would be a possible replacement).

Nitriq Support

Nitriq is a code analysis tool like NDepend. It’s built by Mr. Jon von Gillern. It uses LINQ query language, so you can use a familiar idiom when analyzing your code base. It’s a pretty awesome tool that has a free version for those looking to do code analysis!

To use Nitriq with UC, you are going to need the console edition.  To take advantage of Nitriq, you just need to update the location of Nitriq in the config:

Nitriq path

Then add the nitriq project files at the root of your source.

shows nitriq.nitriqProj and nitriq.nq

Please refer to the Nitriq documentation on how these are created.

UppercuT v1.1

Obfuscation

One thing I started looking into was an easy way to obfuscate my code. I came across EazFuscator, which is both free and awesome. Plus the GUI for it is super simple to use.

How do you make obfuscation even easier? Make it a convention and a configurable property in the UC config file!

obfuscate - even easier!

And the code gets obfuscated!

Closing

Definitely get out and look at the new release. It contains lots of chocolaty (sp?) goodness. And remember, the upgrade path is almost as simple as drag and drop! Open-mouthed smile

Print | posted @ Friday, January 14, 2011 5:26 PM

Comments have been closed on this topic.