Qt-Version-Compatibility

From Qt Wiki
Revision as of 15:19, 4 March 2015 by AutoSpider (talk | contribs) (Convert ExpressionEngine links)
Jump to navigation Jump to search
This article may require cleanup to meet the Qt Wiki's quality standards. Reason: Auto-imported from ExpressionEngine.
Please improve this article if you can. Remove the {{cleanup}} tag and add this page to Updated pages list after it's clean.

Work In Progress

[toc align_right="yes" depth="3"]

Qt Version Compatibility

Qt uses a major.minor.patch numbering scheme for Qt releases. For example, Qt 5.0.1 represents the 1st patch release of Qt 5.0. Each release has restrictions on what kind of changes are acceptable, in order to provide a predictable and stable API. This enables users who are only interested in certain types of improvements to be sure that they won't be adversely affected by upgrading to a newer version.

We do our best to maintain compatibility between versions. However, in order to improve Qt it is sometimes necessary to break compatibility.

Major releases may break backwards binary and source compatibility, although source compatibility may be maintained.

Minor releases are backwards binary and source compatible.

Patch releases are both backwards and forwards binary and source compatible.

Binary Compatibility Guidelines

A library is binary compatible, if a program linked dynamically to a former version of the library continues running with newer versions of the library without the need to recompile.

- techbase.kde.org++

Below are examples of binary compatible and binary incompatible changes.

Compatible Changes

Incompatible Changes

Source Compatibility Guidelines

If a program needs to be recompiled to run with a new version of library but doesn't require any further modifications, the library is source compatible.

- techbase.kde.org++

Below are examples of source compatible and source incompatible changes.

Compatible Changes

Incompatible Changes

Compatibility in Modules

The modules in Qt Essentials have the same forward and backward compatibility promises as Qt 4: new Qt 5 minor releases will not break binary compatibility, and patch level releases are forward and backward compatible. Qt Add-On modules specify their compatibility promise separately.

Additional Information

For more information on which branch you should submit a change to depending on its compatibility, see the branch guidelines.

References

http://qt.io/groups/qt-contributors-summit-2011/wiki/Qt5ProductDefinition#a79cebd30df3933c09d6584eb0e9fa54