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
상속: QOperatingSystemVersionBase

공개 유형

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
(since 6.12) const QOperatingSystemVersionBase MacOSGoldenGate
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.10) const QOperatingSystemVersionBase MacOSTahoe
(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
(since 6.11) const QOperatingSystemVersionBase Windows11_25H2
const QOperatingSystemVersion Windows8_1
QOperatingSystemVersion current()
QOperatingSystemVersion::OSType currentType()

상세 설명

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

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

majorVersion(), minorVersion() 및 microVersion() 함수는 다음 기준에 따라 운영 체제 버전 번호의 각 부분을 반환합니다:

플랫폼값
AndroidQVersionNumber 를 사용하여 android.os.Build.VERSION.RELEASE를 파싱한 결과. 전자가 실패할 경우, 메이저 및 마이너 버전 구성 요소를 결정하기 위해 android.os.Build.VERSION.SDK_INT로 대체됩니다.
Apple 플랫폼majorVersion, minorVersion, 그리고 NSProcessInfo.operatingSystemVersion의 patchVersion
WindowsRtlGetVersion의 dwMajorVersion, dwMinorVersion 및 dwBuildNumber — 이 함수는 항상 기본 운영 체제의 버전 번호를 반환하는 반면, GetVersionEx의 내부 쉘은 애플리케이션이 해당 OS 버전에 대해 매니페스트가 등록되지 않은 경우 실제 버전 번호를 숨긴다는 점에 유의하십시오

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

   bool ios_higher_then_9 = 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 버전에서 잘못된 true 값을 반환했을 수 있습니다. 이러한 동작은 비교 대상인 QOperatingSystemVersion 인스턴스의 OS 유형이 일치하지 않을 때마다 false 을 반환하도록 비교 연산자를 오버로딩함으로써 구현됩니다. 이로 인해 x >= y와 x < y가 모두 x 및 y 의 동일한 인스턴스에 대해 false 가 될 수 있다는 점에 유의하십시오.

멤버 유형 문서

enum QOperatingSystemVersion::OSType

이 열거형은 QOperatingSystemVersion 에서 지원하는 다양한 운영 체제 계열에 대한 기호 이름을 제공합니다.

상수값설명
QOperatingSystemVersion::Android6Google Android 운영 체제.
QOperatingSystemVersion::IOS3Apple iOS 운영 체제.
QOperatingSystemVersion::MacOS2Apple macOS 운영 체제.
QOperatingSystemVersion::TvOS4애플 tvOS 운영 체제.
QOperatingSystemVersion::WatchOS5애플 watchOS 운영 체제.
QOperatingSystemVersion::VisionOS7애플 visionOS 운영 체제.
QOperatingSystemVersion::Windows1마이크로소프트 윈도우 운영 체제.
QOperatingSystemVersion::HarmonyOS (since Qt 6.12)8하모니OS(HarmonyOS) 운영 체제.
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

이 변수는 Android 10(버전 10.0, API 레벨 29)에 해당하는 버전을 저장합니다.

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

[since 6.1] const QOperatingSystemVersion QOperatingSystemVersion::Android11

이 변수는 Android 11(버전 11.0, API 레벨 30)에 해당하는 버전을 저장합니다.

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

[since 6.5] const QOperatingSystemVersionBase QOperatingSystemVersion::Android12

이 변수는 Android 12(버전 12.0, API 레벨 31)에 해당하는 버전을 저장합니다.

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

[since 6.5] const QOperatingSystemVersionBase QOperatingSystemVersion::Android13

이 변수는 Android 13(버전 13.0, API 레벨 33)에 해당하는 버전을 저장합니다.

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

[since 6.7] const QOperatingSystemVersionBase QOperatingSystemVersion::Android14

이 변수는 Android 14(버전 14.0, API 레벨 34)에 해당하는 버전을 저장합니다.

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

[since 6.5] const QOperatingSystemVersionBase QOperatingSystemVersion::Android12L

이 변수는 Android 12L(버전 12.0, API 레벨 32)에 해당하는 버전을 저장합니다.

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

const QOperatingSystemVersion QOperatingSystemVersion::AndroidJellyBean

이 변수는 Android Jelly Bean(버전 4.1, API 레벨 16)에 해당하는 버전을 저장합니다.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidJellyBean_MR1

이 변수는 Android Jelly Bean 유지 관리 릴리스 1(버전 4.2, API 레벨 17)에 해당하는 버전을 저장합니다.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidJellyBean_MR2

이 변수는 Android Jelly Bean 유지 관리 릴리스 2(버전 4.3, API 레벨 18)에 해당하는 버전을 저장합니다.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidKitKat

이 변수는 Android KitKat(버전 4.4 및 4.4W, API 레벨 19 및 20)에 해당하는 버전을 저장합니다.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidLollipop

이 변수는 Android Lollipop(버전 5.0, API 레벨 21)에 해당하는 버전을 저장합니다.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidLollipop_MR1

이 변수는 Android Lollipop 유지보수 릴리스 1(버전 5.1, API 레벨 22)에 해당하는 버전을 저장합니다.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidMarshmallow

이 변수는 Android Marshmallow(버전 6.0, API 레벨 23)에 해당하는 버전을 저장합니다.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidNougat

이 변수는 Android Nougat(버전 7.0, API 레벨 24)에 해당하는 버전을 저장합니다.

const QOperatingSystemVersion QOperatingSystemVersion::AndroidNougat_MR1

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

const QOperatingSystemVersion QOperatingSystemVersion::AndroidOreo

이 변수는 Android Oreo(버전 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

이 변수는 Android Pie(버전 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 Catalina(버전 10.15)에 해당하는 버전이 저장되어 있습니다.

[since 6.12] const QOperatingSystemVersionBase QOperatingSystemVersion::MacOSGoldenGate

이 변수는 macOS Golden Gate(버전 27)에 해당하는 버전을 저장합니다.

이 변수는 Qt 6.12에서 도입되었습니다.

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 Sequoia(버전 15)에 해당하는 버전을 저장합니다.

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

const QOperatingSystemVersion QOperatingSystemVersion::MacOSSierra

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

[since 6.5] const QOperatingSystemVersionBase QOperatingSystemVersion::MacOSSonoma

이 변수는 macOS Sonoma(버전 14)에 해당하는 버전을 저장합니다.

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

[since 6.10] const QOperatingSystemVersionBase QOperatingSystemVersion::MacOSTahoe

이 변수는 macOS Tahoe(버전 26)에 해당하는 버전을 저장합니다.

이 변수는 Qt 6.10에서 도입되었습니다.

[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 Mavericks(버전 10.9)에 해당하는 버전을 저장합니다.

const QOperatingSystemVersion QOperatingSystemVersion::OSXYosemite

이 변수는 OS X Yosemite(버전 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월 업데이트 버전 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에서 도입되었습니다.

[since 6.11] const QOperatingSystemVersionBase QOperatingSystemVersion::Windows11_25H2

이 변수는 Windows 11 버전 25H2(버전 10.0.26200)에 해당하는 버전을 저장합니다.

이 변수는 Qt 6.11에서 도입되었습니다.

const QOperatingSystemVersion QOperatingSystemVersion::Windows8_1

이 변수에는 Windows 8.1(버전 6.3)에 해당하는 버전이 저장되어 있습니다.

© 2026 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.