Versioning: Difference between revisions

From SweepMe! Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 4: Line 4:


To get informed about new versions, follow us on [https://www.linkedin.com/company/sweepme LinkedIn] or [https://twitter.com/sweep_me_net Twitter].
To get informed about new versions, follow us on [https://www.linkedin.com/company/sweepme LinkedIn] or [https://twitter.com/sweep_me_net Twitter].
== Versions ==
{| class="wikitable"
|+ Caption text
|-
! Version !! First release !! End of support !! Changes
|-
| 1.5.6 || coming soon || not defined yet || https://sweep-me.net/changes/version_1-5-6
|-
| 1.5.5 || October 2020 || December 2023 || https://sweep-me.net/changes/version_1-5-5
|-
| 1.5.4 || April 2019 ||December 2020 || not available
|}


== Version number ==
== Version number ==

Revision as of 13:26, 26 July 2023

Last updated for: Version 1.5.5

SweepMe! is under continuous development. This article will inform you about the meaning of the version number and how to handle different SweepMe! versions in order to simplify the migration to a newer version.

To get informed about new versions, follow us on LinkedIn or Twitter.


Versions

Caption text
Version First release End of support Changes
1.5.6 coming soon not defined yet https://sweep-me.net/changes/version_1-5-6
1.5.5 October 2020 December 2023 https://sweep-me.net/changes/version_1-5-5
1.5.4 April 2019 December 2020 not available

Version number

A SweepMe! version consists of 4 number e.g. 1.5.3.23

The positions have the following meaning:

  1. The first number is related to the basic architecture of SweepMe! and this number would change if we would rebuild SweepMe! from scratch.
  2. The second number indicates a major change of the program that typically involves larger compatibility breaks.
  3. The third number refers to the development of new features, contents, optimizations etc. Smaller compatibility breaks are possible but we try to keep the program downward compatible as much as possible.
  4. The last number corresponds to the iterative bugfixing and testing that has been done so far for the version related to the first three numbers.

Version handling

Multiple versions of SweepMe! can be installed on one computer at the same time. To keep track of all versions we recommend the following directory structure:

C:\SweepMe!\SweepMe!_x.x.x.x

where x.x.x.x is the version number. If you like to change to a newer version, you can install it in parallel to your existing version in order to test your settings. It might happen that some adaptions are needed to make your old settings working again. Learn more here in our migration guide. If everything works again, the old version can be removed just by deleting the folder. SweepMe! does not change the registry of the operating system, so that uninstalling SweepMe! via the operating systems is not needed.

Starting from version 1.5.4, the folder will only contain three numbers:

C:\SweepMe!\SweepMe!_x.x.x

Update vs. Upgrade

As the last number of the version is related to bugfixes, you can always update SweepMe! e.g. from version 1.5.3.15 to version 1.5.3.16 or higher without having trouble with changes in the program. If you encounter any bugs, please check first whether any download for your version, e.g. 1.5.3.x is available.

An upgrade is basically done if not just the last number of the version changes, e.g. a change from version 1.5.3.x to version 1.5.4.x. In that case, you have to read the pages of changes and the migration guide to make sure that you do not miss any relevant changes.

Support policy

So far, we are developing 1.5 versions, like 1.5.3.x, 1.5.4.x, 1.5.5.x, and 1.5.6.x which means that we introduce new features but do not introduce major breaks. Here, we always maintain and fix the latest 1.5.x version and we encourage users to upgrade to the latest 1.5.x version for which we provide fixes of bugs and security issues.

Once, we release a 1.6 version, we will support the last 1.5.x version for a couple of time, to allow users that purchased a bundle of add-on modules to be able to use it. As there is no plan to release a 1.6 version, we did not define an end of support for 1.5 yet.

Modules & Devices

Modules and Devices are versioned via our server when they are uploaded by the maintainer. Each version has an ID and a name that is based on the date of the upload, e.g. '2019-11-02' if the upload was at the 2nd November of 2019. If there are multiple uploads of the same module or device at the same day, the name gets an suffic, e.g. '2019-11-02-r2'

You can download and update Modules and Devices via the Version manager that comes with SweepMe!.