Build And Release

Development Environment

uml4net is developed using Visual Studio 2022.

The following tools are used by the Starion Group development team:

• Visual Studio 2022 Professional (Community Edtion will work as well)
• Jetbrains Rider
• Resharper Ultimate 2024.2.1 or later
• Git Extensions

Build

The uml4netsolution contains two build configurations:

• debug: used while developing new features
• release: used to create a build for release

Release

The uml4net libraries are released as nuget packages on https://nuget.org. The release process is automated with a Github Action that is invoked manually and is provided the version number: https://github.com/STARIONGROUP/uml4net/actions/workflows/release.yml

Before a release can be made, the following steps shall be followed and executed:

1. Run all unit tests and verify that they pass (with the exception of those tests that may need a running server)
2. Make sure the version numbers of the projects are incremented when things have changed; the project makes use of SEMVER.
3. Update the <PackageReleaseNotes> in the .csproj files; this will be visible on https://nuget.org and the content will be used to create a draft release note when invoking the release Github Action

Execute the release action once this has completed do the following steps

1. Via the GitHub web-ui, update the draft release. The description includes the contents of the for each project in the solution
2. rebase master from development and push to remote