SpecFlow and SpecFlow+ Runner Versioning

We hear you and have to admit that it is currently difficult to know which version of the SpecFlow+ Runner is compatible with which SpecFlow version. Therefore, we are changing the SpecFlow versions that are supported by the SpecFlow+ Runner.

To make the version compatibility easier to understand, setup or upgrade a project, we have made the following changes:

  • From SpecFlow 3.3 onwards SpecFlow and SpecFlow+ Runner will have the same Major.Minor version number
  • From SpecFlow+ Runner 3.3 onwards SpecFlow+ Runner supports only the latest SpecFlow version

That is also the reason why we are jumping straight from SpecFlow 3.1 to 3.3. To use the SpecFlow+ Runner with earlier versions of SpecFlow, the old versions are still available on NuGet.org.

.NET supported Versions

From SpecFlow 3.3 onwards we are changing our supported .NET versions. This hasn’t been changed since SpecFlow 2.0 back in 2015.

.NET Core

For .NET Core we are now following the Microsoft .NET Core Support policy. This means from SpecFlow 3.3 onwards we will support the current supported versions from Microsoft .NET Core 2.1 and .NET Core 3.1.

.NET Framework

We are changing the minimum supported version from .NET Framework 4.5 to .NET Framework 4.6.1. Microsoft already stopped the support for .NET Framework 4.5 back in 2016.

If you still need support for older version of .NET Core and .NET Framework, you can still use older versions of SpecFlow and SpecFlow+ Runner from NuGet.org.

If you have any problems with upgrading to the latest versions of SpecFlow and SpecFlow+ Runner or if you want provide feedback to our versioning changes, please let us know at support@specflow.org!

We have introduced a new license model for SpecFlow+ and SpecMap. This new licensing model is account-based instead of requiring a license key. You need to sign up for a free personal SpecFlow account in order to use SpecFlow+ and SpecMap. Learn more about the SpecFlow account here

What are the benefits?

Signing up for a free SpecFlow account allows you to use the previously paid SpecFlow+ (Runner and LivingDoc) and SpecMap products for free. You no longer need to wait for us to process your request for a license manually and can expand your use of the software to more users as required. We also plan to offer exclusive additional benefits to help you boost your productivity and get the most out of SpecFlow and SpecMap.

Migrate to the SpecFlow Account

In order to migrate from an existing active SpecFlow+ or SpecMap license key to the new SpecFlow Account follow the step-by-step instructions below.

SpecFlow+ Runner

Migrate from an active license key for the SpecFlow+ Runner to the SpecFlow account:

  1. Update to the latest SpecFlow+Runner NuGet Runner package
  2. Unregister your license key – Follow the instructions here
  3. Return to your IDE and run your scenarios
  4. Open the URL from the console message in your browser
    You are displayed with a “Welcome Page”. Click on Sign in with Microsoft to continue

    Test- Output window in Visual Studio
  5. Sign in with your Microsoft account. It can be a personal or corporate/enterprise account. If you are already signed in to your Microsoft account, this should happen automatically – you might need additional permissions from your Active Directory admin. Learn more about admin consents here
  6. You will be taken to a setup page where you can set up your SpecFlow account. Enter your details to sign up for a free SpecFlow account.
  7. After you finished the sign-up, return to your IDE and run your scenarios again.

Important Note for Active Directory Approvals: It might be possible, that your Active Directory admin needs to grant you and your team permission to use the SpecFlow+ Runner due to your organizations’ Active Directory configuration. Learn more about admin consents here

SpecFlow+ LivingDoc

Migrate from an active license key for SpecFlow+ LivingDoc to the new SpecFlow account:

  1. Update to the latest version of SpecFlow+ LivingDoc – usually happens automatically for Azure DevOps
  2. Start SpecFlow+ LivingDoc (under Overview| SpecFlow+ LivingDoc in Azure DevOps)
  3. Click on Issued to
  4. Clear the Issued to field
  5. Update
  6. Click on Sign in with Microsoft.
  7. Sign in with your Microsoft account. It can be a personal or corporate/enterprise account. If you are already signed in, this should happen automatically – you might need additional permissions from your Active Directory admin. Learn more about admin consents here
  8. You will be taken to a setup page where you can set up your SpecFlow account. Enter your details to sign up for a free SpecFlow account.
  9. Return to SpecFlow+ LivingDoc and refresh your browser.

Important Note for Active Directory Approvals: It might be possible, that your Active Directory admin needs to grant you and your team permission to use the SpecFlow+ LivingDoc due to your organizations’ Active Directory configuration. Learn more about admin consents here

SpecMap

Migrate from an active license key for SpecMap to the new SpecFlow account:

  1. Update to the latest version of SpecMap – usually happens automatically for Azure DevOps
  2. Start SpecMap (under Boards| SpecMap in Azure DevOps)
  3. Click on the Help – ? – icon in the toolbar
  4. Click on Issued to
  5. Clear the Issued to field
  6. Save
  7. Click on Sign in with Microsoft.
  8. Sign in with your Microsoft account. It can be a personal or corporate/enterprise account. If you are already signed in, this should happen automatically – you might need additional permissions from your Active Directory admin. Learn more about admin consents here
  9. You will be taken to a setup page where you can set up your SpecFlow account. Enter your details to sign up for a free SpecFlow account.
  10. Return to SpecMap and refresh your browser.

Important Note for Active Directory Approvals: It might be possible, that your Active Directory admin needs to grant you and your team permission to use the SpecMap due to your organizations’ Active Directory configuration. Learn more about admin consents here

Do you have any further questions?

We want to make the transition as easy as possible. If you have any questions or concerns, please take a look at our FAQs or get in touch with us (support@specflow.org).

We have introduced a new license model for SpecFlow+ and SpecMap. This new licensing model is account-based instead of requiring a license key. You need to sign up for a free personal SpecFlow account in order to use SpecFlow+ and SpecMap.

What are the benefits?

Signing up for a free SpecFlow account allows you to use the previously paid SpecFlow+ (Runner and LivingDoc) and SpecMap products for free. You no longer need to wait for us to process your request for a license manually and can expand your use of the software to more users as required. We also plan to offer exclusive additional benefits to help you boost your productivity and get the most out of SpecFlow and SpecMap.

Requirements

In order to license SpecFlow+ and SpecMap with the new license model:

  • A free Microsoft account is required. This can be your already existing personal or corporate/enterprise Microsoft Account. If you do not yet have a Microsoft account, you can create one for free.
  • Access to the internet is needed from your work environment. If you are working in an offline environment, please get in touch with us at support@specflow.org for information on how to license your software without an internet connection.
  • If you previously purchased a license from TechTalk, the terms and conditions and privacy policy have changed following the acquisition of SpecFlow and SpecMap by Tricentis. You will need to accept these new terms when signing up.

In order to migrate from an existing active SpecFlow+ or SpecMap license key to the new SpecFlow account follow the step-by-step instructions in our migration guide here

Sign up for an account

Depending on the product you are using, the steps you need to take are different. If you are new to SpecFlow, start with our easy to follow step-by-step Getting Started first and learn how to setup SpecFlow and the SpecFlow+ Runner.

SpecFlow+ Runner

If SpecFlow+ Runner is unlicensed, a message is written to the console when you try to execute your tests with SpecFlow+ Runner. You will be asked to sign up for a SpecFlow account or to sign in with your existing account. To see this, you need at least version 3.2.13 of the SpecFlow+ Runner.

In Visual Studio it looks like this:

  1. Open the URL from the message in your browser. In Visual Studio you can click the link while pressing the CTRL-key.
  2. You are displayed with a “Welcome Page”. Click on Sign in with Microsoft to continue.
  3. Sign in with your Microsoft account. It can be a personal or corporate/enterprise account. If you are already signed in to your Microsoft account, this should happen automatically – you might need additional permissions from your Active Directory admin. Learn more about admin consents here
  4. You will be taken to a setup page where you can set up your SpecFlow account. Enter your details to sign up for a free SpecFlow account.
  5. After you finished the sign-up, return to your IDE and run your scenarios again.

Important Note for Active Directory Approvals: It might be possible, that your Active Directory admin needs to grant you and your team permission to use the SpecFlow+ Runner due to your organizations’ Active Directory configuration. Learn more about admin consents here

Note for Build Agents: These steps should not be necessary on a build server. If you are seeing the console output regarding a missing account on your build server, please contact us and let us know what build server you are using.

SpecFlow+ LivingDoc

If you start SpecFlow+ LivingDoc without a valid license, you will be asked to sign in with your Microsoft Identity and set up your SpecFlow account. You can download SpecFlow+ LivingDoc from the Microsoft Marketplace here.

To create your account:

  1. Start SpecFlow+ Living Doc (under Overview | SpecFlow+ LivingDoc in Azure DevOps).
  2. Click on Sign in with Microsoft.
  3. Sign in with your Microsoft account. It can be a personal or corporate/enterprise account. If you are already signed in, this should happen automatically – you might need additional permissions from your Active Directory admin. Learn more about admin consents here
  4. You will be taken to a setup page where you can set up your SpecFlow account. Enter your details to sign up for a free SpecFlow account.
  5. Return to SpecFlow+ LivingDoc and refresh your browser.

Important Note for Active Directory Approvals: It might be possible, that your Active Directory admin needs to grant you and your team permission to use the SpecFlow+ LivingDoc due to your organizations’ Active Directory configuration. Learn more about admin consents here

Do you have any further questions?

We want to make the transition as easy as possible.  If you have any questions or concerns, please take a look at our FAQs or get in touch with us (support@specflow.org).

Are you new to SpecFlow? Start with our easy to follow step-by-step Getting Started first and learn how to setup SpecFlow, the SpecFlow+ Runner and SpecFlow+ LivingDoc.