이 페이지에서

Qt 6.11의 새로운 기능

Qt 6.11의 새로운 모듈

Qt 6.11에는 다음과 같은 모듈이 추가되었습니다:

  • Qt Canvas Painter - Qt Quick 및 QRhi 기반 렌더 타깃을 위한 가속화된 2D 페인팅 솔루션입니다.
  • Qt OpenAPI - 일반적으로 RESTful API에 사용되는 Qt HTTP 클라이언트를 생성하는 업스트림 Open API 생성기의 확장 기능입니다.
  • Qt TaskTree - 비동기 작업 워크플로를 구성하고 실행할 수 있는 선언적 방식을 제공합니다.
  • Qt Labs StyleKit - 일련의 공유 디자인 속성을 통해 Qt Quick Controls 의 스타일링을 간소화하는 전용 스타일링 API입니다.

새로운 모듈들은 기술 미리보기( Technology Preview) 단계에 있으며, 해당 API는 Qt의 호환성 보장 대상에서 제외됩니다. 하지만 모듈을 더욱 개선하기 위한 피드백을 적극 환영합니다! Qt 지원 센터, Qt 버그 트래커, Qt 포럼 또는 링크된 블로그 게시물의 댓글을 통해 언제든지 의견을 보내 주시기 바랍니다.

Qt Canvas Painter 모듈

Qt Canvas Painter는 Qt Quick 및 QRhi 기반 렌더 타겟을 위한 가속화된 2D 페인팅 솔루션입니다. 개요에 대해서는 Qt Canvas Painter 블로그 시리즈도 참조하십시오.

Qt OpenAPI 모듈

Qt OpenAPI는 Open API 생성기를 확장하여, 주로 RESTful API에 사용되는 Qt HTTP 클라이언트를 생성합니다. 문서 외에도 ‘Qt 6의 OpenAPI 지원을 통한 REST 향상’ 블로그 게시물에서 좋은 개요를 확인할 수 있습니다.

Qt TaskTree 모듈

Qt TaskTree는 C++에서 비동기 작업 워크플로를 구성하고 실행할 수 있는 선언적 방식을 제공합니다. 개요는 ‘소개’ 블로그 게시물 시리즈를 참조하십시오.

Qt Labs StyleKit 모듈

Qt Labs StyleKit은 일련의 공유 디자인 속성을 통해 Qt Quick Controls 의 스타일링을 간소화하는 전용 스타일링 API입니다.

Qt 6.11의 새로운 기능

ActiveQt 모듈

주목할 만한 변경 사항은 없습니다.

Qt Bluetooth 모듈

주목할 만한 변경 사항은 없습니다.

Qt CoAP Module

Qt Core 모듈

  • QDate 은 이제 약한 증감(weakly incrementable)이 가능해졌습니다. 즉, 선행 및 후행 증감(감소) 연산자를 구현하며, C++20의 ` std::views::iota`에서 사용할 수 있습니다.
  • QJniObject 이제 반환 유형으로 std::expected (또는 이에 상응하는 유형)을 사용하여 API를 호출할 수 있으며, 이 경우 Java 예외는 프레임워크에서 처리되지 않고 예기치 않은 결과로 호출자에게 다시 전달됩니다.
  • QRangeModel::ItemAccess 다중 역할 항목 유형의 역할 데이터에 접근하기 위한 사용자 정의 지점을 제공합니다.
  • QRangeModel 이제 C++20 std::views::filter 과 같이 상수 std::begin/end 구현을 제공하지 않는 C++ 범위에서도 사용할 수 있습니다.
  • 다중 역할 항목에 대해 동일한 ` QObject ` 하위 클래스를 사용하는 범위의 경우, 새로운 ` QRangeModel::autoConnectPolicy `을 `Full` 또는 `OnRead`로 설정하여 ` QObject ` 항목의 모든 노출된 속성에 대한 `changed-signals`를 해당 ` dataChanged()` 신호 발신에 연결할 수 있습니다.
  • QRangeModelAdapter QRangeModel 가 처리하는 범위에 대해 일반적인 C++ 컨테이너 API를 제공하며, 사용자 코드가 를 직접 다룰 필요 없이 변경 시 관련 신호가 발신되도록 보장합니다. 이 새로운 클래스는 기술 미리보기 단계에 있습니다. QModelIndex QAbstractItemModel
  • Windows에서 Qt는 이제 CMake로 빌드된 실행 파일을 위해 애플리케이션 매니페스트를 자동으로 생성합니다. 이 매니페스트는 PROJECT_VERSION 에서 애플리케이션 버전을 파생하고, CMake 변수를 통해 프로젝트 식별자 및 실행 수준의 사용자 지정을 지원하며, Windows 10 및 Windows 11과의 호환성을 선언하고, longPathAware 를 활성화합니다.

Qt Concurrent 모듈

주목할 만한 변경 사항은 없습니다.

Qt D-Bus 모듈

주목할 만한 변경 사항은 없습니다.

Qt Graphs 모듈

Qt GRPC 모듈

  • QtGrpc 에 새로운 클라이언트 가로채기(Client Interception) 메커니즘을 추가하여, 발신 요청 및 수신 응답을 가로채고 수정할 수 있게 되었습니다.
  • Qt 6.11에서는 QGrpcCallOptions 및 QGrpcChannelOptions 에 대한 비교 연산자(operator== 및 operator!=)가 추가되어, 옵션 객체 간의 직접적인 동일성 검사를 수행할 수 있게 되었습니다.
  • QGrpcOperation 클래스는 서버 초기 메타데이터가 수신되는 즉시 RPC 핸들러에 알리는 serverInitialMetadataReceived() 신호를 도입합니다.
  • QGrpcChannelOptions 또한 QGrpcCallOptions 클래스는 이제 서버 응답에 프로토콜 관련 메타데이터를 포함할지 여부를 제어하는 filterServerMetadata() 및 setFilterServerMetadata() 메서드를 제공합니다.
  • QtGrpc 네임스페이스에는 서비스 이름, 메서드 이름 및 통신 패턴을 사용하여 gRPC 메서드를 설명하는 RpcType 열거형과 RpcDescriptor 구조체가 도입되었습니다.

Qt GUI 모듈

  • 도킹 위젯이 도킹 상태와 플로팅 상태 사이를 전환할 때, 도킹 창 프레임워크에서 새로운 QAccessible::RoleChange 유형의 접근성 이벤트가 발생합니다.
  • Qt Quick Controls 의 Switch 유형에서는 새로운 접근성 역할 Switch 이 사용됩니다.
  • 새로운 접근성 속성 ` Orientation `는 슬라이더 및 유사한 컨트롤이 접근성 클라이언트에 자신의 방향을 보고하는 데 사용됩니다.
  • QRawFont 글리프 인덱스에 대한 ` glyphCount()`을 가져오고 ` glyphName()`를 조회하는 API가 추가되었습니다.
  • QTextCharFormat font features 및 을 설정하는 새로운 API가 추가되었습니다. variable axes

Qt Help 모듈

주목할 만한 변경 사항은 없습니다.

Qt HTTP Server 모듈

  • HTTP/1.0 클라이언트에 대한 지원이 추가되었습니다.
  • Qt 6.11에서는 QHttpServerConfiguration 에 구성 가능한 요청 크기 제한이 도입되어, 애플리케이션이 과도한 크기의 요청으로부터 보호할 수 있게 되었습니다. 새로운 메서드로는 setMaximumUrlSize(), setMaximumTotalHeaderSize(), setMaximumHeaderFieldSize(), setMaximumHeaderFieldCount() 및 setMaximumBodySize()가 있습니다. 제한을 초과하면 서버는 적절한 HTTP 오류 코드(414, 431 또는 413)로 응답합니다.
  • 이제 라우트 핸들러는 ` QFuture<void> `를 반환하고, 다른 스레드에서 ` QHttpServerResponder&&` 인수를 사용하여 응답할 수 있으므로, CPU 집약적인 요청 처리를 메인 서버 스레드에서 분리할 수 있습니다. HTTP/2 연결의 경우 여러 요청을 동시에 처리할 수 있는 반면, HTTP/1.x 연결은 요청을 순차적으로 처리하지만 백그라운드 처리의 이점은 여전히 누릴 수 있습니다. 소켓 I/O는 항상 QHttpServer 스레드에서 처리됩니다.
  • isResponseCanceled QHttpServerResponder 에 ()가 추가되어, 핸들러가 클라이언트의 연결이 끊어진 시점을 감지하고 불필요한 처리를 피하기 위해 조기에 종료할 수 있게 되었습니다.

Qt Image Formats 모듈

일부 번들된 타사 모듈이 업데이트되었습니다. ‘라이선스 변경 사항’을 참조하십시오.

Qt Lottie Animation

  • 경로 채우기 규칙에 대한 지원이 추가되었습니다.
  • 빌드 시 Lottie를 QML로 변환하기 위한 CMAKE 명령어 qt_target_qml_from_lottie가 추가되었습니다.
  • lottietoqml 및 VectorImage 백엔드는 더 이상 기술 미리보기가 아닙니다.
  • VectorImage: 경로를 따라 도형을 애니메이션 처리하는 기능이 추가되었습니다.
  • VectorImage: 모핑 애니메이션(두 도형 간의 보간)을 지원합니다.
  • VectorImage: 매트 레이어 지원이 추가되었습니다.

Qt MQTT 모듈

주목할 만한 변경 사항은 없습니다.

Qt Multimedia 모듈

  • 실시간 오디오 처리가 가능하도록 QAudioSource 및 QAudioSink 의 start 메서드에 콜백 기반의 오버로드를 추가했습니다.

Qt Network 모듈

  • QNetworkRequest 이제 현재 요청에 대한 TCP Keep Alive 매개변수를 지정할 수 있습니다. 또한, QNetworkAccessManager 의 기본 TCP Keep Alive 매개변수가 변경되어, 이제 2분 동안 활동이 없는 비활성 연결은 종료됩니다.

Qt Network 인증 모듈

주목할 만한 변경 사항은 없습니다.

Qt NFC 모듈

주목할 만한 변경 사항은 없습니다.

Qt OPC UA 모듈

Qt OpenGL 모듈

주목할 만한 변경 사항은 없습니다.

Qt Positioning 모듈

Qt PrintSupport 모듈

  • 인쇄 대화 상자의 접근성 개선: 스크린 리더 지원 및 키보드 탐색을 개선하기 위해 레이블 버디 및 적절한 포커스 순서가 설정되었습니다.

Qt Protobuf 모듈

  • qprotobufmessage_cast() 함수는 QProtobufMessage 포인터의 안전한 다운캐스팅을 제공합니다. qobject_cast() 또는 dynamic_cast() 와 유사하게, 이 함수를 사용하면 쉽고 안전하게 런타임 유형 검사 및 변환을 수행할 수 있습니다.

Qt Qml 모듈

  • QML Language Server 에 작업 공간 지원이 추가되었습니다.
  • QML Language Server 에 C++ 정의로 이동 기능이 추가되었습니다.
  • qmllint용 .contextProperties.ini 구성 파일을 통해 컨텍스트 속성 경고를 비활성화하는 기능이 추가되었습니다.
  • override 및 virtual 키워드를 도입하여, 기존의 final 키워드 및 툴링 지원과 함께 QML에서 의도하지 않은 속성 샤도잉을 방지하고 명시적인 속성 오버라이딩을 허용합니다. 자세한 내용은 속성 샤도잉 및 오버라이딩 의미론을 참조하십시오.
  • easingCurve 값 유형에 이름을 부여하고 Easing 네임스페이스를 싱글톤으로 변환했습니다.
  • QQmlContext 에 list of child contexts 을 가져오는 API를 추가하고, find an object by id 에 대한 API도 추가했습니다.
  • qmlformat에 GroupAttributesTogether 옵션을 추가했습니다. 이 옵션은 NormalizeOrder 옵션을 포함하며, 속성(속성 정의, 속성 바인딩, 메서드, 시그널 및 열거형)을 정렬하지 않고 QML 범주를 재정렬합니다.
  • qmlformat에 SingleLineEmptyObjects 옵션이 추가되었습니다. 이 옵션은 빈 객체가 두 번째 줄로 확장되는 것을 방지합니다.

Qt Quick 모듈

Qt Quick Controls 모듈

Qt Quick Dialogs 모듈

주목할 만한 변경 사항은 없습니다.

Qt Quick Effects 모듈

  • RectangularShadow 에 모서리 반경을 개별적으로 제어할 수 있는 네 가지 새로운 속성( topLeftRadius, topRightRadius, bottomLeftRadius, bottomRightRadius)이 Qt 6.11에 추가되었습니다. 각 속성은 설정되지 않은 경우 기존의 radius 속성으로 대체되거나, 0으로 설정된 경우 날카로운 모서리를 생성하여 모서리마다 다른 모서리 반경을 사용하여 더 유연한 그림자 모양을 만들 수 있습니다.

Qt Quick Layouts 모듈

주목할 만한 변경 사항은 없습니다.

Qt Quick Particles 모듈

주목할 만한 변경 사항은 없습니다.

Qt Quick Timeline 모듈

주목할 만한 변경 사항은 없습니다.

Qt Quick Test 모듈

주목할 만한 변경 사항 없음.

Qt Quick 위젯 모듈

주목할 만한 변경 사항 없음.

Qt Quick 3D 모듈

  • 사용자 정의 렌더링 패스를 위한 QML API가 추가되어, C++ 지식이 없어도 QML에서 직접 사용자 정의 렌더링 파이프라인을 구현할 수 있게 되었습니다.
  • ExtendedSceneEnvironment 에 ssrEnabled 속성을 추가하여 스크린 스페이스 리플렉션(SSR)을 활성화했습니다.
  • ExtendedSceneEnvironment 에 스크린 스페이스 전역 조명(SSGI) 효과를 추가하여 앰비언트 오클루전과 실시간 간접 조명을 제공합니다.
  • 시간 기반 AA 및 모션 블러 효과를 위해 객체별 모션 벡터 생성을 추가했습니다.
  • 노드를 그룹화하고 카메라가 렌더링할 레이어를 제어할 수 있도록 레이어링 기능을 추가했습니다.
  • 연결 리스트 순서 독립적 투명도(OIT) 렌더링 방법을 추가했습니다.
  • 포스트 프로세싱 효과 및 사용자 정의 머티리얼에 NORMAL_ROUGHNESS_TEXTURE 지원 추가
  • PCF 소프트 섀도우에 블루 노이즈 샘플링을 추가하여 노이즈 패턴이 덜 눈에 띄게 하고 품질을 개선했습니다.
  • 텍스처 내 Qt Quick 콘텐츠에 대해 사전 곱해진 알파(pre-multiplied alpha)를 올바르게 처리하도록 개선
  • 포스트 프로세싱 효과에 VIEW_MATRIX 및 PROJECTION_MATRIX 노출 기능 추가
  • View3D 에 직사각형 기반 오브젝트 선택을 위한 pickInRect() 메서드를 추가했습니다.
  • View3D 에 주어진 점과 표면 상에서 가장 가까운 점을 찾는 closestPointPick() 메서드를 추가했습니다
  • 특정 모델 매개변수를 받는 rayPick() 오버로드 추가
  • 씬 지오메트리를 기반으로 모양을 동적으로 계산하는 파티클 이미터용 씬 모양을 추가했습니다
  • 사용자 정의 텍스처 제공자를 간편하게 생성할 수 있도록 QQuick3DTextureProviderExtension API를 추가했습니다.
  • QSSGFrameData 에 특정 렌더 패스 결과를 요청하는 scheduleRenderResults() 함수를 추가했습니다
  • Assimp를 v6.0.2로 업데이트했습니다.

Qt Quick 3D XR 모듈

  • OpenGL 데스크톱 Linux 지원(Monado, Xlib, Wayland 플랫폼)을 추가했습니다.
  • processTouch()을 확장하여, 다음뿐만 아니라 선택 가능한 모든 Model 에 터치 이벤트를 전달하도록 했습니다. XrItem
  • touchpointState()을 개선하여 3D 터치 상호 작용에 대한 표면 위치 및 법선 벡터 정보를 반환하도록 했습니다.
  • 전용 QQuickOverlay를 통해 XrItem 에 팝업 및 메뉴 지원 추가
  • OpenXR을 v1.1.49로 업데이트했습니다.

Qt Quick 3D Physics 모듈

주목할 만한 변경 사항은 없습니다.

Qt Quick VectorImage 모듈

  • SVG 마스크 지원이 추가되었습니다.
  • 다음 모듈에서 지원하는 기능과 일치하도록 SVG 후처리 필터 지원을 추가했습니다 Qt SVG: feGaussianBlur, feColorMatrix, feOffset, feFlood, feBlend, feComposite 및 feMerge.
  • 경로를 따라 도형을 애니메이션화하는 기능이 추가되었습니다.
  • SVG <symbol> 태그 지원이 추가되었습니다.

Qt Serial Port 모듈

주목할 만한 변경 사항은 없습니다.

Qt Serial Bus 모듈

주목할 만한 변경 사항은 없습니다.

Qt SQL 모듈

주목할 만한 변경 사항은 없습니다.

Qt SVG 모듈

  • offset-path 및 offset-distance 를 통해 CSS 모션 경로 애니메이션에 대한 지원이 추가되었습니다. offset-path 은 경로를 정의하는 데 path 함수만 지원한다는 점에 유의하십시오.
  • 애니메이션 전체에 대한 CSS 애니메이션 타이밍 함수 지원이 추가되었습니다. 현재는 미리 정의된 키워드(linear, step-start, ease 등)만 지원됩니다.

Qt Test 모듈

  • 현재 전역 테스트 데이터의 이름을 가져오기 위해 QTest::currentGlobalDataTag() 함수가 추가되었습니다.
  • QTest::defaultTryTimeout 를 추가하여 QTRY_* 함수가 사용하는 기본 타임아웃을 구성할 수 있게 되었습니다.
  • QCOMPARE 이제 음수 0 및 NaN 값에 대한 부호를 출력하고, NaN 페이로드를 출력합니다.
  • QTEST_THROW_ON_FAIL 이제 QtConcurrent 내에서 QCOMPARE/QSKIP이 호출될 때 QTEST_THROW_ON_SKIP 이 작동합니다.
  • QTest::failOnWarning()는 이제 크리티컬 메시지를 포함하여 warning 이상의 모든 메시지 유형에서 실패합니다.
  • macOS에서 테스트 실행 전체에 걸쳐 디스플레이 절전 모드와 App Nap이 무조건 비활성화됩니다.
  • Callgrind 지원을 Valgrind v3.25.1로 업데이트하고, RISCV 64비트 Linux에 대한 지원을 추가했습니다.

Qt VirtualKeyboard 모듈

  • Qt 6.11에서는 VirtualKeyboardSettings 에 arrowKeyNavigationEnabled 속성이 도입되어, 개발자가 입력 패널이 표시되어 있을 때 화살표 키(왼쪽, 오른쪽, 위, 아래)와 Return 키를 키보드 키 간 이동에 사용할 수 있는지 여부를 제어할 수 있게 되었습니다. 이 속성의 기본값은 빌드 시 구성 플래그 QT_VIRTUALKEYBOARD_ARROW_KEY_NAVIGATION 에 기반합니다.
  • KeyboardStyle 타입에 keyboardDesignMaximumHeight 속성이 추가되었습니다. 이 속성을 사용하여 키보드가 화면의 대부분을 가리는 것을 방지할 수 있습니다.

Qt WebEngine 모듈

  • Qt WebEngine 은 이제 Chromium 140을 기반으로 합니다.
  • Chromium에는 기존 C++ 구성 요소를 대체하기 위한 새로운 Rust 구성 요소가 추가되었습니다. 이제 Qt WebEngine 를 이러한 Rust 구성 요소를 사용하여 선택적으로 빌드할 수 있습니다. 이를 위해서는 Rust 툴체인을 설치하고 -feature-webengine-rust-build 로 구성해야 합니다. 기본 동작은 기존 C++ 구성 요소를 사용하여 빌드하는 것입니다.
  • 세션 쿠키가 디스크에 저장되는 것을 방지하기 위해 OnlyPersistentCookies 정책이 추가되었습니다.
  • 접근성을 위해 HTML 'id' 속성을 자동화 ID로 강제 사용하도록 하는 TrimAccessibilityIdentifiers 설정을 추가했습니다.
  • HTML의 inputmode 전역 속성에 대한 지원을 추가했습니다.
  • 크로스 오리진 리소스로의 리디렉션을 처리하는 fetch() API 기능이 개선되었습니다.
  • Pepper 플러그인 API 코드를 제거했습니다.
  • chrome://usb-internals 디버그 페이지를 활성화했습니다.

Qt WebView 모듈

  • WebView 에 대한 C++ 바인딩이 추가되어, Qt Widgets 기반 애플리케이션에서 이 모듈을 사용할 수 있게 되었습니다. 새로운 C++ API는 기술 미리 보기(Technology Preview) 상태로 출시되었으며, 향후 변경될 수 있습니다.

Qt Widgets 모듈

  • QWizard 마법사의 전체 너비에 배너를 확장하는 새로운 StretchBanner 옵션이 추가되었습니다.
  • QAbstractItemView keyboardSearch()의 기본 구현이 주어진 문자열을 모델 데이터와 어떻게 대조하는지 조정할 수 있는 새로운 keyboardSearchFlags 속성이 추가되었습니다.
  • QColumnView previewColumnVisible 속성이 추가되어 미리 보기 열을 표시할지 여부를 지정할 수 있게 되었습니다.
  • 새로운 QStyleOptionMenuItemV2 클래스에는 스타일에 의해 렌더링되는 항목에서 마우스가 눌려 있는지 여부를 나타내는 플래그가 추가되었습니다.
  • QTabBar 이제 ` tabsClosable `가 true인 경우, 탭을 중간 클릭하면 ` tabCloseRequested `를 발생시킵니다.

Qt XML 모듈

주목할 만한 변경 사항은 없습니다.

도구

QDoc 문서 생성기

  • 새로운 \qmlsingletontype 명령, QML_SINGLETON 매크로의 자동 감지, QML 파일 내의 pragma singleton 인식 등을 포함하여 QML 싱글톤 유형에 대한 포괄적인 지원이 추가되었습니다.
  • QDoc은 이제 링크, 한정된 식별자에 대한 구문 강조, anchors.fill 와 같은 속성 표기법 및 Component.onCompleted 와 같은 부착 속성에 대한 올바른 마크업을 포함하여 QML 모듈 별칭(import ... as ... 구문)을 완벽하게 지원합니다.
  • 문서 소스 파일에서 계층적 목차 구조를 지정하기 위해 새로운 \toc/\endtoc 및 \tocentry 명령을 사용할 수 있습니다. QDoc은 탐색 사이드바를 위한 <project>_toc.xml 파일을 생성합니다.
  • 이제 \overload 명령어는 이제 선택적 인수를 받습니다. \overload primary 구문을 사용하여 오버로드 집합 내의 기본 함수를 지정하십시오.
  • QDoc은 이제 오버로드된 시그널 및 슬롯에 대한 문맥에 맞는 연결 예제를 생성합니다.
  • includeprivate 구성 변수를 사용하면 비공개 C++ 멤버에 대한 문서를 생성할 수 있습니다. 순수 가상 함수는 이제 무조건 문서화됩니다.
  • C++20 컨셉: QDoc은 이제 함수 및 클래스 템플릿에 대한 C++20 requires 절을 추출하여 표시합니다. 템플릿 헤더 및 후행 제약 조건 위치가 모두 지원됩니다.
  • \code 명령어는 이제 코드 블록의 프로그래밍 언어를 지정하기 위한 선택적 인수를 받아들입니다. 구문 강조 표시를 비활성화하려면 "text"를 사용하십시오.
  • \meta keywords 인수는 검색 엔진 최적화 및 후처리를 위해 사용자 정의 키워드를 HTML <meta> 요소로 추가합니다.
  • 이제 "attached" 링크 기준을 사용하여 QML 첨부 속성에 대한 명시적 링크가 지원되므로, 일반 속성 이름과 첨부 속성 이름이 충돌할 때 모호성을 해소할 수 있습니다.
  • 가독성 향상을 위해 매개변수가 2개 이상인 템플릿 선언은 이제 여러 줄로 렌더링됩니다. HTML 출력에서는 사용자 정의 스타일을 적용하기 위해 template-block CSS 클래스를 사용합니다.
  • QDoc은 이제 Q_PROPERTY 로 선언된 문서화되지 않은 C++ 속성에 대해 경고를 표시하여, 모든 API 요소에 걸쳐 일관된 문서화 범위를 보장합니다.
  • 이제 QDoc은 문서가 자체를 참조하는 ` \sa ` 명령에서 발생하는 자기 참조에 대해 경고를 표시합니다.
  • logwarnings 구성 변수를 사용하면 QDoc이 모든 경고를 <project>-qdoc-warnings.log 파일에 기록합니다. 새로운 logwarnings.disablecliargs 하위 옵션은 이식성 있는 로그를 위해 로그 헤더에서 CLI 인수를 생략합니다.
  • 이제 QDoc 경고에는 다중 모듈 빌드 시 프로젝트 이름 접두사가 포함됩니다.
  • 구성 개선 사항:
    • codelanguages: ` \code ` 블록에서 허용되는 추가 프로그래밍 언어를 지정하여, 내장 구문 강조 표시 마커가 없는 언어의 코드도 문서에 포함할 수 있도록 합니다.
    • imagesoutputdir: 다중 모듈 빌드에서 파일 이름 충돌을 해결하기 위해 이미지를 위한 사용자 지정 출력 하위 디렉터리를 제공합니다.
    • internalfilepatterns: ` *_p.h`와 같은 파일/경로 이름 패턴을 기반으로 클래스를 자동으로 내부(internal)로 표시합니다.
    • projectroot: 경고 로그에서 절대 경로를 상대 경로로 변환할 루트 디렉터리를 설정하여, 다양한 빌드 환경 간 이식성을 향상시킵니다. QDOC_PROJECT_ROOT 환경 변수로도 사용할 수 있습니다.
  • \title 인수에서 서식 지정 명령이 이제 작동하며, \generatelist 가 Qt Help 프로젝트의 목차(TOC) 구조에서 올바르게 작동하고, \qmlenum 에서 사용자 정의 열거자 접두사가 지원됩니다.
  • QML 및 C++ 멤버 문서의 HTML 구조가 통합되었습니다. 이 변경 사항으로 인해 QDoc의 HTML 출력에 새로운 CSS 클래스(qml-member, qml-property, qml-method, qml-property-group)가 도입되었습니다.
  • 코드 파싱: 범위 지정 열거형(scoped enum) 해결 기능 개선, 순환 감지를 통한 QML 상속 처리, 인덱스 파일에서 선언된 유형 및 변수 정보의 정확한 보존이 이루어집니다.
  • LLVM/Clang 21 호환성이 추가되었으며, 지원되는 최소 버전이 17.0.6으로 업데이트되었습니다.
  • \tableofcontents 명령어가 공식적으로 사용 중단되었습니다.

Qt Linguist

  • 런타임 동작에 영향을 주지 않으면서 ID 기반 번역을 의미 있는 그룹으로 분류할 수 있는 방법으로 레이블이 추가되었습니다. 자세한 내용은 텍스트 ID 기반 번역 문서와 블로그 게시물을 참조하십시오.
  • 문서에 새로운 i18n 예제가 추가되었습니다.
  • LLM을 활용한 자동 번역을 위해 Qt Linguist 에 AI 번역 기능을 추가했습니다. 자세한 내용은 AI 번역 문서와 블로그 게시물을 참조하십시오.
  • 텍스트 기반 번역에서 ID 기반 번역으로 프로젝트를 마이그레이션하기 위한 ltext2id 실행 파일을 추가했습니다. 자세한 내용은 ltext2id 사용을 참조하십시오.
  • TS 파일에 대한 일괄 유효성 검사를 수행하기 위한 lcheck 실행 파일을 추가했습니다. 자세한 내용은 lcheck 사용법을 참조하십시오.
  • lupdate 파서에서 C++ 속성을 지원하도록 했습니다.
  • lupdate 파서에서 //= 메타스트링 사용이 더 이상 권장되지 않습니다.
  • .pro 파일을 직접 처리하기 위한 ` lupdate -pro ` 옵션은 더 이상 권장되지 않습니다. 대신 ` lupdate-pro `을 사용하십시오.
  • lprodump 실행 파일이 제거되었습니다. 해당 기능은 이제 lupdate-pro -dump-json 옵션을 통해 사용할 수 있습니다.

플랫폼 변경 사항

빌드 시스템 변경 사항

  • configure 옵션으로 -generate-vcpkg-manifest가 추가되었습니다. 이 옵션을 사용하면 빌드 디렉터리에 vcpkg.json 파일이 생성됩니다. Qt를 구성하지 않고 매니페스트만 생성하려면, configure를 -generate-vcpkg-manifest -dry-run 옵션과 함께 실행하십시오.
  • -vcpkg 옵션으로 구성할 때는 빌드 디렉터리에 vcpkg 매니페스트 파일을 생성하고, 해당 매니페스트 파일을 사용하려면 VCPKG_MANIFEST_DIR을 빌드 디렉터리로 설정하십시오. -no-generate-vcpkg-manifest 옵션을 사용하여 매니페스트 생성을 비활성화할 수 있습니다. -- -UVCPKG_MANIFEST_DIR 를 configure에 전달하여 매니페스트 디렉터리 설정을 비활성화할 수 있습니다.
  • 기존 SPDX 형식 외에도 CycloneDX SBOM 문서 생성을 지원합니다. CycloneDX 생성을 활성화하려면 Qt를 -sbom -sbom-cyclonedx-v1_6 -sbom-cyclonedx-v1_6-required 로 구성하십시오.

데스크톱 플랫폼

Windows

  • QOperatingSystemVersion 를 통해 Windows 11 25H2(빌드 10.0.26200)에 대한 지원 및 감지 기능이 추가되었습니다.
  • 최상위 창 및 포커스에 대한 다양한 접근성 개선이 이루어졌습니다.
  • 재생률 업데이트 처리가 개선되었습니다.
  • Visual Studio 2026을 사용할 때 ARM64EC에 대한 실험적 지원이 추가되었습니다. 이 구성을 사용하려면 Windows on ARM 머신의 CXXFLAGS 환경 변수에 /arm64EC 을 CFLAGS 에 추가하고, /arm64EC 및 /d2arm64ECMarkAllFuncsPatchable 도 추가한 다음, 평소와 같이 Qt를 구성하고 빌드하십시오.

Linux

  • Wayland 플러그인에 서버 측 키 반복 기능, 서버 측 장식 우선 설정, xx-session-management-v1 에 대한 실험적 지원 및 수많은 안정성 수정 사항(팝업, 스크롤, 오프스크린 표면, 클립보드)이 추가되었습니다.
  • XCB용 레거시 X11 네이티브 렌더링 엔진(XRender)이 제거되었습니다. 이 엔진을 사용하려면 컴파일 시 CMake 옵션(-xcb-native-painting)으로 활성화하고, 실행 시 QT_XCB_NATIVE_PAINTING 환경 변수를 통해 활성화해야 했습니다.
  • 애플리케이션의 접근성 계층 구조 내에서 접근 가능한 객체를 더 효율적으로 검색할 수 있는 메커니즘을 제공하는 AT-SPI Collection 인터페이스 지원이 추가되어 접근성이 향상되었습니다. 또한 이 인터페이스를 통해 Orca 스크린 리더에서 탐색 모드 지원이 가능해졌습니다.
  • XKB: Qt::Key_Call / Qt::Key_Hangup 에 대한 키 매핑이 확장되었습니다.

macOS

  • 이제 샌드박스화된 애플리케이션은 애플리케이션 샌드박스 외부의 파일(소위 보안 범위 내 리소스)에 읽기 및 쓰기 목적으로 액세스할 수 있습니다. 파일 대화 상자나 유사한 네이티브 메커니즘을 통해 사용자가 선택한 파일이나 폴더는 애플리케이션 및 기기 재시작 후에도 지속적인 액세스를 포함하여 자동적이고 투명하게 처리됩니다.
  • 기본 NSScreen에 접근하기 위한 QNativeInterface::QCocoaScreen 가 추가되었습니다.
  • CGImageRef와 QImage 간의 변환이 이제 QImage::Format_RGB30 및 HDR 콘텐츠에 중요한 부동 소수점 형식을 포함하여 더 광범위한 이미지 형식을 지원합니다.
  • Apple 아이콘 엔진은 이제 페인터의 레이아웃 방향을 반영하여, SF Symbols 아이콘 세트에 RTL 전용 아이콘이 있는 경우 이를 생성합니다.
  • 네이티브 열기/저장 패널을 통해 선택된 파일 경로는 이제 NFC 정규화되어, 파일 시스템이 이름을 NFD 형식으로 저장하는지 여부와 관계없이 일관된 파일 이름 비교가 보장됩니다.

모바일 플랫폼

Android

Android용 Qt
  • Qt Jenny 이제 C++에서 Java 인터페이스를 구현하고 Java 클래스를 확장할 수 있습니다.
  • Play 스토어의 기능 제공(Feature Delivery)을 지원합니다.
  • Android 16 지원.
  • Gradle 9.3.1 및 Android Gradle Plugin 9.0.0으로 업데이트되었습니다.
  • JDK 21 LTS로 업데이트하고 호환성을 JDK 17 LTS로 상향 조정했습니다.
Qt Quick Android용
  • Java/Kotlin에서 QML 함수를 호출하기 위한 QtQuickView.invokeMethod()가 추가되었습니다.
  • QML 뷰가 로드되기 전에 신호를 등록할 수 있도록 지원합니다.

iOS

  • 플랫폼 테마에서 파일 아이콘을 지원하도록 추가했습니다.
  • 파일 열기를 위한 외부 요청에 대한 ` QFileOpenEvent ` 지원이 추가되었습니다.
  • 샌드박스 애플리케이션이 이제 애플리케이션 샌드박스 외부의 파일(소위 보안 범위 내 리소스)에 읽고 쓰기 위해 액세스할 수 있습니다. 파일 대화 상자나 유사한 네이티브 메커니즘을 통해 사용자가 선택한 파일이나 폴더는 애플리케이션 및 기기 재시작 후에도 지속적인 액세스를 포함하여 자동적이고 투명하게 처리됩니다.
  • 네이티브 저장 대화 상자에 대한 지원이 추가되었습니다.

임베디드 플랫폼

Linux

  • EGLFS/KMS는 이제 런타임 시 디스플레이의 핫 플러그 및 핫 리로드를 지원합니다( QT_QPA_EGLFS_HOTPLUG_ENABLED 환경 변수에 의해 제어됨).
  • 새로운 ConnMan 기반 QNetworkInformation 백엔드가 추가되었습니다.
  • DirectFB: Qt::Key_Call 매핑이 추가되었습니다.

Boot to Qt

  • 새로운 Tier 2 플랫폼:
    • NXP i.MX 8M Plus LDDPR4 EVK
    • Toradex i.MX 95 Verdin
    • Qualcomm RB3 Gen2 비전 키트

웹 플랫폼

WebAssembly

  • Qt Positioning GeoLocation API용 백엔드가 추가되었습니다.
  • 새로운 wasmdeployqt 도구를 사용하여 동적으로 링크된 Qt for WebAssembly 애플리케이션을 배포하고 출시하세요. 이 도구는 기존의 preload_qt_plugins.py 및 preload_qml_imports.py Python 스크립트를 대체합니다.

API 변경 사항 목록

이 페이지에는 Qt 6.11의 API 변경 사항에 대한 개요가 포함되어 있습니다:

알려진 문제

Qt 6.11의 알려진 문제에 대한 정보는 Qt 위키를 참조하십시오.

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