Building Math.NET Filtering
If you do not want to use the official binaries, or if you like to modify, debug or contribute, you can compile locally either using Visual Studio or manually with the build scripts.
VisualStudio or Xamarin Studio
We clearly separate dependency management from the IDE, you should therefore
run restore.cmd
or restore.sh
once after every git checkout in order to restore
the dependencies exactly as defined. Otherwise Visual Studio and other IDEs
may fail to compile or provide correct IntelliSense.
Tests can be run with the usual integrated NUnit test runners or ReSharper.
MSBuild or XBuild
Instead of a compatible IDE you can also build the solutions directly with
msbuild
, or on Mono with xbuild
. You may need to run restore.cmd
or
restore.sh
before, once after every git checkout in order to restore the dependencies.
1: 2: 3: |
|
FAKE
The fully automated build including unit tests, documentation and api reference, NuGet and Zip packages is using FAKE.
FAKE itself is not included in the repository but it will download and bootstrap
itself automatically when build.cmd is run the first time. Note that this step
is not required when using Visual Studio or msbuild
directly.
1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: |
|
If the build or tests fail claiming that FSharp.Core was not be found, see fsharp.org or install the Visual F# 3.0 Tools directly.
Creating a Release
While only maintainers can make official releases published on NuGet and referred to from the website, you can use the same tools to make your own releases for your own purposes.
Versioning is controlled by the release notes. Before building a new version,
first add a new release header and change notes on top of the RELEASENOTES.md
document in the root directory. The fake builds pick this up and propagate it
to the assembly info files automatically.
The build can then be launched by calling:
1: 2: 3: |
|
The build script will print the current version as part of the the header banner, which is also included in the release notes document in the build artifacts. Example:
1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: |
|
The artifacts are then ready in the out/packages
directory.
Official Release Process (Maintainers only)
Update
RELEASENOTES.md
file with relevant changes, attributed by contributor (if external). Set date.Update
CONTRIBUTORS.md
file (viagit shortlog -sn
)-
Build Release:
1:
build.sh All release
- Commit and push release notes and (auto-updated) assembly info files with new "Release: v1.2.3" commit
-
Publish Release:
1: 2: 3: 4: 5:
build.sh PublishDocs build.sh PublishApi build.sh PublishTag build.sh PublishMirrors build.sh PublishNuGet
In theory there is also a
Publish
target to do this in one step, unfortunately publishing to the NuGet gallery is quite unreliable. - Create new Codeplex and GitHub release, attach Zip files (to be automated)
Copy artifacts to release archive (to be automated)
Consider a tweet via @MathDotNet
Consider a post to the Google+ site