We use custom msbuild projects to automate the whole building process of Math.NET, including build verification tests, generating the documentation and even packing the release zip files.
System Requirements: One-Time Setup
- Ensure the Microsoft .NET Framework SDK 2.0 or newer is installed.
- Add the SDK Path to your PATH System Environment Variable (the SDK path should look similar to
C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\)
Beside that, in order to build and test your modifications you also need to generate personal test keys. For your own security you should change them from time to time - to do that, repeat the following step every few months or so:
- (Re)generate your personal test keys: Run CreateNewPersonalTestKey.bat
Build Math.NET
For a normal incremental build:
- Run PackageName_Build.bat. For Math.NET Iridium that would be Iridium_Build.bat.
If you want to rebuild from scratch instead:
- Run PackageName_Build_FromScratch.bat, e.g. Iridium_Build_FromScratch.bat.
Run the Math.NET Unit Tests
- Simply run PackageName_Test.bat, e.g. Iridium_Test.bat.
Generate Api Reference/Documentation
We use
Sandcastle to generate the documentation. All steps have been automated in our build scripts:
One-Time Setup
- Install Microsoft HTML Help Workshop
- Run Documentation_Initialize.bat. (this might run for some minutes.)
Build Documentation for the current checkout/revision
- Build the package, if not yet done, using PackageName_Build.bat. For Math.NET Iridium that would be Iridium_Build.bat.
- Run PackageName_Documentation.bat. For Math.NET Iridium that would be Iridium_Documentation.bat.