Back to Qt.io
Contact Us Blog Download Qt

QOperatingSystemVersion Class

QOperatingSystemVersion 클래스는 운영 체제 버전에 대한 정보를 제공합니다. 더 보기...

헤더: #include <QOperatingSystemVersion>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
상속합니다: Q운영체제 버전 베이스

공용 형

enum OSType { Android, IOS, MacOS, TvOS, WatchOS, …, Unknown }

공용 함수

QOperatingSystemVersion(QOperatingSystemVersion::OSType osType, int vmajor, int vminor = -1, int vmicro = -1)
bool isAnyOfType(std::initializer_list<QOperatingSystemVersion::OSType> types) const
int majorVersion() const
int microVersion() const
int minorVersion() const
QString name() const
int segmentCount() const
QOperatingSystemVersion::OSType type() const
(since 6.1) QVersionNumber version() const

정적 공용 멤버

(since 6.1) const QOperatingSystemVersion Android10
(since 6.1) const QOperatingSystemVersion Android11
(since 6.5) const QOperatingSystemVersionBase Android12
(since 6.5) const QOperatingSystemVersionBase Android13
(since 6.7) const QOperatingSystemVersionBase Android14
(since 6.5) const QOperatingSystemVersionBase Android12L
const QOperatingSystemVersion AndroidJellyBean
const QOperatingSystemVersion AndroidJellyBean_MR1
const QOperatingSystemVersion AndroidJellyBean_MR2
const QOperatingSystemVersion AndroidKitKat
const QOperatingSystemVersion AndroidLollipop
const QOperatingSystemVersion AndroidLollipop_MR1
const QOperatingSystemVersion AndroidMarshmallow
const QOperatingSystemVersion AndroidNougat
const QOperatingSystemVersion AndroidNougat_MR1
const QOperatingSystemVersion AndroidOreo
(since 6.1) const QOperatingSystemVersion AndroidOreo_MR1
(since 6.1) const QOperatingSystemVersion AndroidPie
(since 6.0) const QOperatingSystemVersion MacOSBigSur
const QOperatingSystemVersion MacOSCatalina
const QOperatingSystemVersion MacOSHighSierra
const QOperatingSystemVersion MacOSMojave
(since 6.3) const QOperatingSystemVersion MacOSMonterey
(since 6.8) const QOperatingSystemVersionBase MacOSSequoia
const QOperatingSystemVersion MacOSSierra
(since 6.5) const QOperatingSystemVersionBase MacOSSonoma
(since 6.4) const QOperatingSystemVersionBase MacOSVentura
const QOperatingSystemVersion OSXElCapitan
const QOperatingSystemVersion OSXMavericks
const QOperatingSystemVersion OSXYosemite
const QOperatingSystemVersion Windows7
const QOperatingSystemVersion Windows8
const QOperatingSystemVersion Windows10
(since 6.3) const QOperatingSystemVersionBase Windows11
(since 6.3) const QOperatingSystemVersionBase Windows10_1809
(since 6.3) const QOperatingSystemVersionBase Windows10_1903
(since 6.3) const QOperatingSystemVersionBase Windows10_1909
(since 6.3) const QOperatingSystemVersionBase Windows10_20H2
(since 6.3) const QOperatingSystemVersionBase Windows10_2004
(since 6.3) const QOperatingSystemVersionBase Windows10_21H1
(since 6.3) const QOperatingSystemVersionBase Windows10_21H2
(since 6.5) const QOperatingSystemVersionBase Windows10_22H2
(since 6.4) const QOperatingSystemVersionBase Windows11_21H2
(since 6.4) const QOperatingSystemVersionBase Windows11_22H2
(since 6.6) const QOperatingSystemVersionBase Windows11_23H2
(since 6.8.1) const QOperatingSystemVersionBase Windows11_24H2
const QOperatingSystemVersion Windows8_1
QOperatingSystemVersion current()
QOperatingSystemVersion::OSType currentType()

상세 설명

QSysInfo 의 다른 버전 함수와 달리 QOperatingSystemVersion 은 운영 체제 버전(커널 버전 번호나 마케팅 버전이 아닌)에 따라 동작을 변경하거나 API 또는 기능 활성화 여부를 결정하는 데 일반적으로 사용되는 developers 전체 버전 번호에 대한 액세스를 제공합니다.

현재 Android, Apple 플랫폼(iOS, macOS, tvOS, watchOS 및 visionOS) 및 Windows가 지원됩니다.

majorVersion(), minorVersion(), microVersion() 함수는 운영 체제 버전 번호의 일부를 기준으로 반환합니다:

플랫폼Value
안드로이드QVersionNumber 를 사용하여 android.os.Build.VERSION.RELEASE를 구문 분석한 결과(전자가 실패할 경우 주 버전 및 부 버전 구성 요소를 결정하기 위해 android.os.Build.VERSION.SDK_INT로 폴백).
Apple 플랫폼majorVersion, minorVersion, 및 NSProcessInfo.operatingSystemVersion의 patchVersion을 사용합니다.
WindowsRtlGetVersion의 dwMajorVersion, dwMinorVersion 및 dwBuildNumber - 이 함수는 애플리케이션이 해당 버전의 OS에 대해 나타나지 않는 경우 실제 버전 번호를 숨기는 GetVersionEx 아래의 심과 달리 항상 기본 운영 체제의 버전 번호를 반환한다는 점에 유의하십시오.

QOperatingSystemVersion은 버전 번호와 OS 유형을 모두 저장하므로 비교를 수행할 때 OS 유형을 고려할 수 있습니다. 예를 들어, macOS Sierra(v10.12)를 실행하는 macOS 시스템에서 다음 표현식은 표현식의 왼쪽(10)에 있는 개체의 주 버전 번호 구성 요소가 오른쪽(9)에 있는 개체보다 크더라도 false 을 반환합니다:

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

이렇게 하면 여러 운영 체제에 대한 표현식을 논리 OR 연산자로 결합해도 여전히 예상대로 작동할 수 있습니다. 예를 들어

    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
    }

보다 순진한 비교 알고리즘은 Mac OS 9를 포함한 모든 버전의 macOS에서 참을 잘못 반환할 수 있습니다. 이 동작은 비교 중인 QOperatingSystemVersion 인스턴스의 OS 유형이 일치하지 않을 때마다 false 을 반환하도록 비교 연산자를 오버로드함으로써 이루어집니다. 이로 인해 x 및 y 의 동일한 인스턴스에 대해 x >= y 및 x < y 가 모두 false 인 경우가 발생할 수 있습니다.

멤버 유형 문서

enum QOperatingSystemVersion::OSType

이 열거형은 QOperatingSystemVersion 에서 지원하는 다양한 운영 체제 제품군에 대한 상징적 이름을 제공합니다.

Constant값설명
QOperatingSystemVersion::Android6Google Android 운영 체제입니다.
QOperatingSystemVersion::IOS3Apple iOS 운영 체제.
QOperatingSystemVersion::MacOS2Apple macOS 운영 체제입니다.
QOperatingSystemVersion::TvOS4Apple tvOS 운영 체제.
QOperatingSystemVersion::WatchOS5Apple watchOS 운영 체제.
QOperatingSystemVersion::VisionOS7Apple visionOS 운영 체제.
QOperatingSystemVersion::Windows1Microsoft Windows 운영 체제.
QOperatingSystemVersion::Unknown0알 수 없거나 지원되지 않는 운영 체제.

멤버 기능 문서

[constexpr] QOperatingSystemVersion::QOperatingSystemVersion(QOperatingSystemVersion::OSType osType, int vmajor, int vminor = -1, int vmicro = -1)

OS 유형 osType 과 각각 메이저, 마이너 및 마이크로 버전 번호 vmajor, vminor 및 vmicro 로 구성된 QOperatingSystemVersion을 구성합니다.

[static] QOperatingSystemVersion QOperatingSystemVersion::current()

현재 OS와 해당 버전 번호를 나타내는 QOperatingSystemVersion 을 반환합니다.

currentType()도 참조하세요 .

[static constexpr] QOperatingSystemVersion::OSType QOperatingSystemVersion::currentType()

QOperatingSystemVersion 인스턴스를 구성하지 않고 현재 OS 유형을 반환합니다.

current()도 참조하세요 .

bool QOperatingSystemVersion::isAnyOfType(std::initializer_list<QOperatingSystemVersion::OSType> types) const

QOperatingSystemVersion 에서 식별된 OS 유형이 types 의 OS 유형과 일치하는지 여부를 반환합니다.

[constexpr] int QOperatingSystemVersion::majorVersion() const

메이저 버전 번호, 즉 운영 체제 버전 번호의 첫 번째 세그먼트를 반환합니다.

지정된 운영 체제의 주 버전 번호는 기본 클래스 설명서를 참조하세요.

-1은 알 수 없거나 없는 버전 번호 구성 요소를 나타냅니다.

version(), minorVersion() 및 microVersion()도 참조하세요 .

[constexpr] int QOperatingSystemVersion::microVersion() const

마이크로 버전 번호, 즉 운영 체제 버전 번호의 세 번째 세그먼트를 반환합니다.

지정된 운영 체제의 마이크로 버전 번호는 기본 클래스 설명서를 참조하세요.

-1은 알 수 없거나 없는 버전 번호 구성 요소를 나타냅니다.

version(), majorVersion() 및 minorVersion()도 참조하세요 .

[constexpr] int QOperatingSystemVersion::minorVersion() const

부 버전 번호, 즉 운영 체제 버전 번호의 두 번째 세그먼트를 반환합니다.

주어진 운영 체제에서 부 버전 번호가 무엇인지에 대해서는 기본 클래스 설명서를 참조하세요.

-1은 알 수 없거나 없는 버전 번호 구성 요소를 나타냅니다.

version(), majorVersion() 및 microVersion()도 참조하세요 .

QString QOperatingSystemVersion::name() const

QOperatingSystemVersion 에 의해 식별된 OS 유형의 문자열 표현을 반환합니다.

type()도 참조하세요 .

[constexpr] int QOperatingSystemVersion::segmentCount() const

버전 번호에 저장된 정수 개수를 반환합니다.

[constexpr] QOperatingSystemVersion::OSType QOperatingSystemVersion::type() const

QOperatingSystemVersion 에 의해 식별된 OS 유형을 반환합니다.

name()도 참조하세요 .

[since 6.1] QVersionNumber QOperatingSystemVersion::version() const

운영 체제의 버전 번호를 반환합니다.

지정된 운영 체제의 버전 번호는 메인 클래스 설명서를 참조하십시오.

이 함수는 Qt 6.1에 도입되었습니다.

majorVersion(), minorVersion() 및 microVersion()도 참조하십시오 .

멤버 변수 문서

[since 6.1] const QOperatingSystemVersion QOperatingSystemVersion::Android10

이 변수는 안드로이드 10(버전 10.0, API 레벨 29)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.1에 도입되었습니다.

[since 6.1] const QOperatingSystemVersion QOperatingSystemVersion::Android11

이 변수는 안드로이드 11(버전 11.0, API 레벨 30)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.1에 도입되었습니다.

[since 6.5] const QOperatingSystemVersionBase QOperatingSystemVersion::Android12

이 변수는 안드로이드 12(버전 12.0, API 레벨 31)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.5에 도입되었습니다.

[since 6.5] const QOperatingSystemVersionBase QOperatingSystemVersion::Android13

이 변수는 안드로이드 13(버전 13.0, API 레벨 33)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.5에 도입되었습니다.

[since 6.7] const QOperatingSystemVersionBase QOperatingSystemVersion::Android14

이 변수는 안드로이드 14(버전 14.0, API 레벨 34)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.7에 도입되었습니다.

[since 6.5] const QOperatingSystemVersionBase QOperatingSystemVersion::Android12L

이 변수는 안드로이드 12L(버전 12.0, API 레벨 32)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.5에 도입되었습니다.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidJellyBean

이 변수는 안드로이드 젤리빈(버전 4.1, API 레벨 16)에 해당하는 버전을 보유합니다.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidJellyBean_MR1

이 변수는 안드로이드 젤리빈, 유지 관리 릴리스 1(버전 4.2, API 레벨 17)에 해당하는 버전을 보유합니다.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidJellyBean_MR2

이 변수는 안드로이드 젤리빈, 유지 관리 릴리스 2(버전 4.3, API 레벨 18)에 해당하는 버전을 보유합니다.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidKitKat

이 변수는 안드로이드 킷캣에 해당하는 버전(버전 4.4 및 4.4W, API 레벨 19 및 20)을 보유합니다.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidLollipop

이 변수는 안드로이드 롤리팝(버전 5.0, API 레벨 21)에 해당하는 버전을 보유합니다.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidLollipop_MR1

이 변수는 안드로이드 롤리팝, 유지 관리 릴리스 1(버전 5.1, API 레벨 22)에 해당하는 버전을 보유합니다.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidMarshmallow

이 변수는 안드로이드 마시멜로(버전 6.0, API 레벨 23)에 해당하는 버전을 보유합니다.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidNougat

이 변수는 안드로이드 누가(버전 7.0, API 레벨 24)에 해당하는 버전을 보유합니다.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidNougat_MR1

이 변수는 Android 누가, 유지 관리 릴리스 1(버전 7.0, API 레벨 25)에 해당하는 버전을 보유합니다.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidOreo

이 변수는 안드로이드 오레오(버전 8.0, API 레벨 26)에 해당하는 버전을 보유합니다.

[since 6.1] const QOperatingSystemVersion QOperatingSystemVersion::AndroidOreo_MR1

이 변수는 Android Oreo_MR1(버전 8.1, API 레벨 27)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.1에 도입되었습니다.

[since 6.1] const QOperatingSystemVersion QOperatingSystemVersion::AndroidPie

이 변수는 안드로이드 파이(버전 9.0, API 레벨 28)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.1에 도입되었습니다.

[since 6.0] const QOperatingSystemVersion QOperatingSystemVersion::MacOSBigSur

이 변수는 macOS Big Sur(버전 11)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.0에 도입되었습니다.

const QOperatingSystemVersion QOperatingSystemVersion::MacOSCatalina

이 변수는 macOS 카탈리나(버전 10.15)에 해당하는 버전을 보유합니다.

const QOperatingSystemVersion QOperatingSystemVersion::MacOSHighSierra

이 변수는 macOS High Sierra(버전 10.13)에 해당하는 버전을 보유합니다.

const QOperatingSystemVersion QOperatingSystemVersion::MacOSMojave

이 변수는 macOS Mojave(버전 10.14)에 해당하는 버전을 보유합니다.

[since 6.3] const QOperatingSystemVersion QOperatingSystemVersion::MacOSMonterey

이 변수는 macOS Monterey(버전 12)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.3에 도입되었습니다.

[since 6.8] const QOperatingSystemVersionBase QOperatingSystemVersion::MacOSSequoia

이 변수는 macOS 세쿼이아(버전 15)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.8에 도입되었습니다.

const QOperatingSystemVersion QOperatingSystemVersion::MacOSSierra

이 변수에는 macOS Sierra(버전 10.12)에 해당하는 버전이 저장됩니다.

[since 6.5] const QOperatingSystemVersionBase QOperatingSystemVersion::MacOSSonoma

이 변수는 macOS 소노마(버전 14)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.5에 도입되었습니다.

[since 6.4] const QOperatingSystemVersionBase QOperatingSystemVersion::MacOSVentura

이 변수는 macOS Ventura(버전 13)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.4에 도입되었습니다.

const QOperatingSystemVersion QOperatingSystemVersion::OSXElCapitan

이 변수에는 OS X El Capitan(버전 10.11)에 해당하는 버전이 저장됩니다.

const QOperatingSystemVersion QOperatingSystemVersion::OSXMavericks

이 변수에는 OS X 매버릭스(버전 10.9)에 해당하는 버전이 저장됩니다.

const QOperatingSystemVersion QOperatingSystemVersion::OSXYosemite

이 변수에는 OS X 요세미티(버전 10.10)에 해당하는 버전이 저장됩니다.

const QOperatingSystemVersion QOperatingSystemVersion::Windows7

이 변수는 Windows 7(버전 6.1)에 해당하는 버전을 보유합니다.

const QOperatingSystemVersion QOperatingSystemVersion::Windows8

이 변수는 Windows 8(버전 6.2)에 해당하는 버전을 보유합니다.

const QOperatingSystemVersion QOperatingSystemVersion::Windows10

이 변수에는 일반 Windows 10(버전 10.0)에 해당하는 버전이 저장됩니다.

[since 6.3] const QOperatingSystemVersionBase QOperatingSystemVersion::Windows11

이 변수는 Windows 11의 초기 릴리스(버전 10.0.22000)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.3에 도입되었습니다.

[since 6.3] const QOperatingSystemVersionBase QOperatingSystemVersion::Windows10_1809

이 변수는 Windows 10 2018년 10월 업데이트 버전 1809(버전 10.0.17763)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.3에 도입되었습니다.

[since 6.3] const QOperatingSystemVersionBase QOperatingSystemVersion::Windows10_1903

이 변수는 Windows 10 2019년 5월 업데이트 버전 1903(버전 10.0.18362)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.3에 도입되었습니다.

[since 6.3] const QOperatingSystemVersionBase QOperatingSystemVersion::Windows10_1909

이 변수는 Windows 10 2019년 11월 업데이트 버전 1909(버전 10.0.18363)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.3에 도입되었습니다.

[since 6.3] const QOperatingSystemVersionBase QOperatingSystemVersion::Windows10_20H2

이 변수는 Windows 10 2020년 10월 업데이트 버전 20H2(버전 10.0.19042)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.3에 도입되었습니다.

[since 6.3] const QOperatingSystemVersionBase QOperatingSystemVersion::Windows10_2004

이 변수는 Windows 10 2020년 5월 업데이트 버전 2004(버전 10.0.19041)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.3에 도입되었습니다.

[since 6.3] const QOperatingSystemVersionBase QOperatingSystemVersion::Windows10_21H1

이 변수는 Windows 10 2021년 5월 업데이트 버전 21H1(버전 10.0.19043)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.3에 도입되었습니다.

[since 6.3] const QOperatingSystemVersionBase QOperatingSystemVersion::Windows10_21H2

이 변수는 Windows 10 2021년 11월 업데이트 버전 21H2(버전 10.0.19044)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.3에 도입되었습니다.

[since 6.5] const QOperatingSystemVersionBase QOperatingSystemVersion::Windows10_22H2

이 변수는 Windows 10 2022년 10월 22일 업데이트 버전 22H2(버전 10.0.19045)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.5에 도입되었습니다.

[since 6.4] const QOperatingSystemVersionBase QOperatingSystemVersion::Windows11_21H2

이 변수는 Windows 11 버전 21H2(버전 10.0.22000)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.4에 도입되었습니다.

[since 6.4] const QOperatingSystemVersionBase QOperatingSystemVersion::Windows11_22H2

이 변수는 Windows 11 버전 22H2(버전 10.0.22621)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.4에 도입되었습니다.

[since 6.6] const QOperatingSystemVersionBase QOperatingSystemVersion::Windows11_23H2

이 변수는 Windows 11 버전 23H2(버전 10.0.22631)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.6에 도입되었습니다.

[since 6.8.1] const QOperatingSystemVersionBase QOperatingSystemVersion::Windows11_24H2

이 변수는 Windows 11 버전 24H2(버전 10.0.26100)에 해당하는 버전을 보유합니다.

이 문서는 Qt 6.8.1에 도입되었습니다.

const QOperatingSystemVersion QOperatingSystemVersion::Windows8_1

이 변수는 Windows 8.1(버전 6.3)에 해당하는 버전을 보유합니다.

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.