ADAPT

Building the Framework

The ADAPT Framework requires the .NET Core 2.x SDK and the .NET 4.5.1 SDK to be built correctly. It is possible to build the projects with just the .NET Core 2.x SDK if you use the .NET CLI and use the -Framework flag.

CI Builds

The ADAPT Framework has it's tests run every time any code changes through a GitHub Actions pipeline.

Release Builds

The ADAPT Framework is built by creating a GitHub Release that triggers a GitHub Actions pipeline. The release tag version should conform to the pattern vX.X.X-alphaX for an alpha release, vX.X.X-betaX for a beta release, vX.X.X-rcX for a release candidate release and vX.X.X for a production release. The job takes the release tag version and publishes a NuGet package using that.

An example would be that the release tag version v1.2.3-beta2 will create a NuGet package with the version 1.2.3-beta2 and the assemblies would have the file version 1.2.3.N where N is the GitHub Actions run number.

Local Builds

The ADAPT Framework can be built locally on a developer machine if the repository is cloned.

Visual Studio Code

Open the repository directory with Visual Studio Code
Run the Build or Test task

Visual Studio 2017

Open ADAPT.sln in the repository directory with Visual Studio 2017
Run the Build > Rebuild Solution command

.NET CLI

Navigate to the repository directory in a shell
Run dotnet build ./ADAPT.sln -c Debug for a debug build
Run dotnet build ./ADAPT.sln -c Release for a release build (with the addition argument /p:Version=<VERSION> if you want a version other than 0.0.0)

NuGet Package

Make sure that the code has been build for the Release configuration
Navigate to the repository directory in a shell
Run nuget pack ./AgGatewayADAPTFramework.nuspec -outputdirectory ./dist (with the addition argument -version <VERSION> if you want a package version other than 0.0.0)