Backwards Compatibility between Cycle 2.21 and Previous Versions

Backwards Compatibility between Cycle 2.21 and Previous Versions

This article is in reference to Bug 9924: Null values in the default path settings cause incompatibility with opening projects between versions. 


Cycle 2.21 introduced some new default setting values for the cycle2settings.json file that are incompatible between versions. This causes difficulties with users downgrading from Cycle 2.21 to an earlier version if the need arises. Users will find that when installing an earlier version (for example, Cycle 2.19), they will not be able to open or create a new project. 


When a user encounters this issue it is because there are some values in their cycle2settings.json file that are incompatible between versions. In particular, this would be any setting where the default value is displayed as “null”: 

  •  "CustomChromeBrowserLocation" : null

  •  "IEDriverLocation" : null

  •  "EdgeDriverLocation" : null

  •  "ChromeDriverLocation" : null


Note that if a user is a brand new user who started working with Cycle in Cycle 2.21 or later they are more likely to encounter this scenario. A user who was on a previous version of Cycle prior to Cycle 2.21 would have inherited their old cycle2settings.json file from previous versions, which would avoid this issue. 


To fix this: 

  1. Close Cycle 

  2. Navigate to C:\Users\<USERNAME>\AppData\Roaming\Cycle\config

  3. Delete the cycle2settings.json file 

  4. Reopen Cycle

    • Related Articles

    • TLS and SSL Errors With Connection Steps in versions Cycle 2.10+

      The Java version shipped with Cycle was updated with the Cycle 2.10 release. As a result, you may receive error message similar to the example messages below when running steps to establish DB connections in Cycle 2.10+: javax.net.ssl.SSLException ...

    • How To Access the Cycle E-Learning Platform (Cycle University)

      The Cycle User Portal was retired with the release of Cycle 2.9.2. The former Cycle E-Learning platform was retired along with the Cycle User Portal. Training materials can be found in the new Cycle University platform. Cycle Labs - Cycle University ...

    • Educate your team: Training your Cycle Users

      Cycle training is an important first step to get your Cycle users up to speed on how to create your Cycle tests. Access to Cycle University is available through the Cycle Labs website. Cycle Labs - Cycle University Please use your Cycle Cloud ...

    • Getting Started with Cycle 2

      Log In to Cycle Cloud In order to get started with Cycle 2, you will need to sign up for a Cycle Cloud account, and then download Cycle 2 from Cycle Cloud. The sign up process requires you to verify your email address. Please note, the email address ...

    • How to use Cycle with a Shared Repository.

      Problem With multiple developers and testers working on the same Cycle project, it's a struggle to keep everyone up to date with the latest Features and Settings. Solution Using a shared repository such as Git or Subversion when developing features ...