Installing the Licensing Tool (V3.0 & 3.1)¶
This is only needed for SpecFlow+ 3.1 and earlier. From SpecFlow 3.2 onwards you need to sign up for a free SpecFlow account in order to use SpecFlow+. Learn more about the SpecFlow account here.
SpecFlow.Plus.License¶
Until SpecFlow+ 3.1, licenses need to be registered using the SpecFlow.Plus.License tool. It is used to assign, remove and display the current licensing status of a machine.
Setup¶
Prerequisites¶
SpecFlow.Plus.License requires the .NET Core SDK 2.1 or higher to be installed. Information on setting up the .NET Core SDK can be found in the official Microsoft guide.
Installing SpecFlow.Plus.License¶
To install SpecFlow.Plus.License:
- Open a command prompt.
- Run the following command:
dotnet tool install --global SpecFlow.Plus.License
Note: If you want to install a specific version, use the--version
option to specify the desired version:dotnet tool install --global SpecFlow.Plus.License --version <desired version>
- You can test that the installation was successfull and display your license status using the following command:
specflow-plus-license about
Uninstalling SpecFlow.Plus.License¶
To uninstall SpecFlow.Plus.License:
- Open a command prompt.
- Run the following command:
dotnet tool uninstall --global SpecFlow.Plus.License
Updating SpecFlow.Plus.License¶
To update SpecFlow.Plus.License:
- Open a command prompt.
- Run the following command:
dotnet tool update --global SpecFlow.Plus.License
Migrating Previous Licenses¶
Prior to SpecFlow 3, license keys were stored in the registry. However the .NET Core licensing tool cannot access licenses stored in the registry. If you intend to use SpecFlow+ with .NET Core and have already registered your license key, you can migrate your old key using the following command:
specrun migrate-license
This will copy your existing license from the registry to a local file that can be read by the .NET Core licensing tool.