Build a new release

Prerequisites

Ensure the following software is installed:

• HTML Help Workshop 1.3
• Sandcastle Help File Builder

Prepare master branch

For SSH.NET we're always building our releases from the master branch, hence the following steps need to be taken to prepare this branch:

1. Ensure any commits, that are part of the scope of the release, are merged from the develop branch to the master branch.
2. Switch to the master branch.
3. Make sure you have no local changes.
4. Pull any changes from remote.
5. Update the following custom attributes in src/Renci.SshNet/Properties:
   • AssemblyCopyright
   • AssemblyVersion
   • AssemblyFileVersion
   • AssemblyInformationalVersion
6. Commit and push changes to master branch.

Build modern TFM support

1. Switch to master branch on your host machine.
2. Make sure you have no local changes.
3. Pull any changes from remote.
4. Start a Developer Command Prompt for VS2019.
5. Navigate to the Build folder of the SSH.NET checkout directory.
6. Execute the following command:

msbuild /p:ReleaseVersion=<version> /t:CleanModern /t:PreparePackageModern

Build classic TFM support

1. Launch VM containing necessary software for building the assemblies for classic target framework.
2. Switch to master branch.
3. Make sure you have no local changes.
4. Pull any changes from remote.
5. Start a Developer Command Prompt for VS2015.
6. Navigate to the Build folder of the SSH.NET checkout directory.
7. Execute the following command:

msbuild /p:ReleaseVersion=<version> /t:CleanClassic /t:PreparePackageClassic

8. Copy the content of the <SSH.NET checkout>/Build/target/nuget-<version> folder to the following directory on your host machine:

<SSH.NET checkout directory>\build\target\nuget-<version>