QOperatingSystemVersion露

PyQt5.QtCore.QOperatingSystemVersion

Description露

The QOperatingSystemVersion class provides information about the operating system version.

Unlike other version functions in QSysInfo, QOperatingSystemVersion provides access to the full version number that developers typically use to vary behavior or determine whether to enable APIs or features based on the operating system version (as opposed to the kernel version number or marketing version).

This class is also a complete replacement for QSysInfo::macVersion and QSysInfo::windowsVersion, additionally providing access to the third (micro) version number component.

Presently, Android, Apple Platforms (iOS, macOS, tvOS, and watchOS), and Windows are supported.

The majorVersion(), minorVersion(), and microVersion() functions return the parts of the operating system version number based on:

Platforms	Value
Android	result of parsing android.os.Build.VERSION.RELEASE using QVersionNumber, with a fallback to android.os.Build.VERSION.SDK_INT to determine the major and minor version component if the former fails
Apple Platforms	majorVersion(), minorVersion(), and patchVersion from NSProcessInfo.operatingSystemVersion
Windows	dwMajorVersion, dwMinorVersion, and dwBuildNumber from RtlGetVersion - note that this function ALWAYS return the version number of the underlying operating system, as opposed to the shim underneath GetVersionEx that hides the real version number if the application is not manifested for that version of the OS

Because QOperatingSystemVersion stores both a version number and an OS type, the OS type can be taken into account when performing comparisons. For example, on a macOS system running macOS Sierra (v10.12), the following expression will return false even though the major version number component of the object on the left hand side of the expression (10) is greater than that of the object on the right (9):

#     QOperatingSystemVersion::current() >= QOperatingSystemVersion(QOperatingSystemVersion::IOS, 9)

This allows expressions for multiple operating systems to be joined with a logical OR operator and still work as expected. For example:

#     auto current = QOperatingSystemVersion::current();
#     if (current >= QOperatingSystemVersion::OSXYosemite ||
#         current >= QOperatingSystemVersion(QOperatingSystemVersion::IOS, 8)) {
#         // returns true on macOS >= 10.10 and iOS >= 8.0, but false on macOS < 10.10 and iOS < 8.0
#     }

A more naive comparison algorithm might incorrectly return true on all versions of macOS, including Mac OS 9. This behavior is achieved by overloading the comparison operators to return false whenever the OS types of the QOperatingSystemVersion instances being compared do not match. Be aware that due to this it can be the case x >= y and x < y are BOTH false for the same instances of x and y.

Enums露

OSType

This enum provides symbolic names for the various operating system families supported by QOperatingSystemVersion.

Member	Value	Description
Android	6	The Google Android operating system.
IOS	3	The Apple iOS operating system.
MacOS	2	The Apple macOS operating system.
TvOS	4	The Apple tvOS operating system.
Unknown	0	An unknown or unsupported operating system.
WatchOS	5	The Apple watchOS operating system.
Windows	1	The Microsoft Windows operating system.