이 페이지에서

Qt 6.10의 새로운 기능

Qt 6.10의 신규 및 복원된 모듈

Qt 6.10에는 다음과 같은 모듈과 도구가 추가되었습니다:

Qt 6.10의 새로운 기능

Qt Core 모듈

Qt D-Bus 모듈

Qt Graphs 모듈()는 현재 지정된 버스 서비스를 보유하고 있는 프로세스의 연결 자격 증명을 반환합니다.

Qt GRPC 모듈

Qt GUI Module

  • QStyleHints::accessibility 는 시스템에서 명암비 향상 설정이 활성화되어 있는지 여부와 같은 사용자 접근성 기본 설정에 대한 액세스를 제공합니다.
  • 개별 접근성 설정에 액세스할 수 있도록 QAccessibilityHints 가 추가되었습니다.
  • QRhi: Direct 3D 11, 12 또는 Vulkan에서 실행될 때 enumerateAdapters() 함수를 통해 3D 그래픽 어댑터(물리적 장치)를 열거하는 기능이 추가되었습니다.
  • QPainterPath::setCachingEnabled()를 사용하여 계산된 값의 캐싱을 켜면, 추가 메모리 사용량을 대가로 특정 작업의 성능을 높일 수 있습니다.
  • 경로의 일부를 반환하는 QPainterPath::trimmed()이 추가되었습니다.

Qt HttpServer 모듈

Qt Lottie Animation

  • 솔리드, 널 및 프리컴포지션 레이어에 대한 지원을 추가했습니다.
  • lottietoqml 도구를 추가했습니다. 이 도구는 svgtoqml과 동등한 기능을 제공하며, Lottie 파일을 QML로 기술된 Qt Quick 장면으로 변환합니다. 현재 기술 미리보기 단계에 있습니다.
  • VectorImage 용 플러그인을 추가하여 SVG 외에도 Lottie 파일을 로드할 수 있게 했습니다. 이 기능은 기술 미리보기 단계이며, assumeTrustedSource 를 true 로 설정해야 합니다.
  • 다음의 사용법을 보여주기 위해 lottietoqml 예제와 qtlottieviewer 예제를 추가했습니다. Qt Lottie Animation.

Qt Multimedia 모듈

  • 네이티브 PipeWire 오디오 백엔드를 추가했습니다.
  • 뛰어난 Signalsmith Stretch 라이브러리를 기반으로 한 FFmpeg 기반 QMediaPlayer 에 대한 오디오 피치 보정 기능이 추가되었습니다. 이 동작은 pitchCompensation 속성을 통해 사용자 지정할 수 있습니다.
  • QCapturableWindow 이제 C++과 QML 모두에서 QWindow 을 기반으로 생성할 수 있습니다.
  • 사용자가 재생 의도, 네트워크 타임아웃, 프로브 크기 등 저수준 FFmpeg 미디어 재생 옵션을 제어할 수 있는 새로운 클래스 QPlaybackOptions 가 추가되었습니다.
  • QAudioSink 및 QAudioSource 에 사용자가 바이트 수 대신 프레임 수를 기준으로 기본 오디오 버퍼를 조작할 수 있는 메서드가 추가되었습니다.

Qt Network 모듈

  • QSslCertificate 에 fromFile() 메서드를 추가했습니다.
  • QHttpHeaders 에 HTTP 헤더의 날짜 및 시간 값을 설정하기 위한 편의 메서드인 setDateTimeValue()를 추가했습니다.
  • QHttpHeaders 에 QDateTime, 정수 또는 이러한 유형의 목록으로 값을 가져오는 편의 메서드를 추가했습니다.

Qt Protobuf 모듈

Qt Qml 모듈

  • QML 파일에서 트리 구조를 정의할 수 있고 TreeView 와 연동되는 새로운 TreeModel QML 유형이 추가되었습니다.
  • 모델 데이터를 정렬하고 필터링할 수 있는 SortFilterProxyModel QML 유형을 추가했습니다. 이 기능은 기술 미리보기 단계에 있습니다.
  • DelegateModel 및 모든 뷰에 delegateModelAccess 속성이 추가되었습니다. 이제 필수 속성을 통해 모델에 데이터를 직접 기록할 수 있습니다.
  • Synchronizer QML 유형이 추가되었습니다. Synchronizer는 바인딩을 사용하지 않고 두 개 이상의 속성을 동기화합니다. 이 기능은 기술 미리보기 단계에 있습니다.
  • qmlformat에 세미콜론 사용자 정의 규칙이 추가되었습니다. 이제 JS 문 끝부분에 세미콜론을 추가할지 여부를 제어할 수 있습니다.
  • Qt Creator 과의 호환성 향상에 중점을 둔 새로운 qmllint 경고가 추가되었습니다. 여기에는 Qt Design Studio 의 특정 제한 사항에 대한 검사, 추가적인 JavaScript 관련 경고, QML 열거형 및 임포트와 관련된 몇 가지 새로운 경고가 포함됩니다.
  • TableModel 에서 복잡한 행 구조 조작에 대한 지원을 제거했습니다.
  • 모호성을 해소하기 위해 TableModel::setData 에서 역할 및 값 매개변수의 순서를 변경했습니다.

Qt Quick 모듈

  • CSS Flexbox와 유사하게 퀵 항목을 유연하게 배열할 수 있도록 FlexboxLayout QML 유형이 추가되었습니다. 이 기능은 기술 미리 보기 단계에 있습니다.

Qt Quick Controls 모듈

  • FluentWinUI3 스타일에서 Windows 11의 대비 테마에 대한 지원이 개선되었습니다.
  • SearchField 컨트롤이 추가되었습니다.

Qt Quick Dialogs 모듈

  • popupType 속성이 추가되어, 비네이티브 대화 상자를 별도의 창으로 열지, 아니면 기존 장면의 항목으로 열지 여부를 제어할 수 있습니다. 이 속성은 네이티브 대화 상자를 사용할 때는 효과가 없습니다.

Qt Quick Effects 모듈

Qt Quick 3D 모듈xml-ph-0000@deepl.internal가 추가되어, 모양이 지정된 이미터에서 해당 모양의 표면 법선을 기준으로 파티클

  • emitMode 가 모양 기반 이미터에 추가되어, 모양의 표면 법선을 기반으로 파티클을 방출할 수 있게 되었습니다.
  • reversed 이미터를 구현하여 파티클이 종료 시간부터 시작 시간까지 이동할 수 있도록 했습니다.
  • 라이트맵과 관련된 몇 가지 개선 및 변경 사항:
    • 단위당 텍셀(texels-per-unit) 기반의 라이트맵 크기를 도입하고, Model::texelsPerUnit 및 Lightmapper::texelsPerUnit 속성을 추가하며, 이제 더 이상 사용되지 않는 Model::lightmapBaseResolution 속성을 대체했습니다.
    • 전체 씬에 대해 하나의 라이트맵 소스를 설정하는 Lightmapper::source 속성을 도입하여, BakedLightmap::loadPrefix 를 대체하고 사용을 중단했습니다.
    • Lightmapper::denoiseSigma 속성을 통해 제어되는, 베이킹된 라이트맵을 위한 내장형 GPU 기반 비국소 평균(NLM) 노이즈 제거 기능이 추가되었습니다.
    • 라이트맵 베이킹 창이 개선되어 진행률 표시줄과 예상 남은 시간이 표시됩니다.
    • 이제 베이킹은 별도의 RHI 컨텍스트에서 수행되므로 실행 중인 애플리케이션의 렌더링을 차단하지 않습니다.
    • 특정 장면을 베이킹할 때 RAM 및 VRAM 사용량이 감소했습니다.
    • GUI 또는 명령줄을 통해 베이킹된 라이트맵 파일을 디버깅할 수 있는 라이트맵 뷰어 도구가 추가되었습니다.
  • 사양에 맞춰 선형(linear)을 sRGB로 올바르게 변환하여 glTF2 baseColorFactor의 색상 가져오기 문제를 수정했습니다.
  • QtQuick3D 에 CapsuleGeometry 를 추가했습니다. 텍스처가 고정된 헬퍼, 비동기 생성 지원 및 노출된 uvProfile 속성이 포함됩니다.

Qt Quick 3D XR 모듈

  • 공간 앵커에 대한 룸 스캐닝을 요청하기 위해 ` method `를 노출했습니다.

Qt Quick 3D Physics 모듈

Qt Quick VectorImage 모듈

  • Qt SVG 의 애니메이션 지원과 일치하는 애니메이션 SVG에 대한 지원을 추가했습니다.
  • 소스 파일이 신뢰할 수 있는지 여부를 나타내는 API 가 추가되었습니다.
  • 애니메이션 동작을 제어하기 위해 API 를 추가했습니다.
  • 에서 제공하는 플러그인을 포함함으로써 Qt Lottie Animation에서 제공하는 플러그인을 포함함으로써, VectorImage 에서 이제 Lottie 파일도 표시할 수 있습니다. 이 기능은 기술 미리보기로 간주되며, assumeTrustedSource 를 true 로 설정해야 합니다.

Qt Serial Port 모듈

  • writeBufferSize 속성을 사용하여 쓰기 버퍼 크기를 제한하는 기능이 추가되었습니다.

Qt Serial Bus 모듈

Qt SQL 모듈

Qt SVG 모듈

  • fill-opacity, stroke-opacity 및 opacity 속성에 대한 CSS 애니메이션 지원이 추가되었습니다.
  • SVG 파일을 보는 방법을 보여주는 예제가 추가되었습니다.

Qt Test 모듈

  • 데이터 기반 벤치마크에서 이제 일반 텍스트 이름으로 전역 및 로컬 데이터를 모두 식별합니다.
  • Apple Silicon에서 lldb의 백트레이스가 비활성화되었습니다.
  • QTest 가 비교 시 부동 소수점 값을 출력할 때, 이제 전체 정밀도를 제공하며 16진수 부동 소수점 버전도 포함합니다.

Qt VirtualKeyboard 모듈

  • 타사 소스의 출처 정보 파일에 PURL 및 CPE 정보를 추가했습니다.
  • 라트비아어 키보드 레이아웃이 추가되었습니다.

Qt WebEngine 모듈

Qt WebView 모듈

  • Windows 플랫폼용 WebView2 플러그인이 추가되었습니다. 새로운 백엔드는 WebView2라고 하는 크롬(Chromium) 기반 Edge 브라우저의 네이티브 COM API를 사용합니다. 따라서 이제 Qt WebEngine 를 포함하지 않고도 웹 콘텐츠를 제공할 수 있습니다.

Qt Widgets 모듈

Qt XML 모듈

Qt MQTT 모듈

  • WebSockets/Secure WebSockets 지원 추가

도구

QDoc 문서 생성기

  • 이제 QDoc은 모든 C++ API 선언에 “소스 보기” 링크를 자동으로 추가할 수 있습니다. 새로운 url.sources 계열의 구성 변수(url.sources.enabled, url.sources.rootdir, url.sources.linktext)를 사용하여 이 기능을 활성화하십시오.
  • QDoc은 이제 플로이드의 순환 탐지 알고리즘을 사용하여 QML 유형의 순환 상속을 감지하고, 무한 루프에 빠지는 대신 문제를 보고합니다.
  • .qml 파일에 정의된 QML 속성 그룹은 \qmlproperty 명령을 사용하여 문서화할 때 인식되어 하나의 그룹화된 속성으로 표시됩니다.
  • Qt 도구(moc_, uic_, qrc_ 등)에 의해 생성된 소스 파일은 이제 자동으로 건너뛰어지므로, 대규모 프로젝트에서 QDoc 빌드 시간이 단축됩니다.
  • .qml 파일 내의 QML 속성에 표시된 데이터 유형은 이제 \qmlproperty 명령에서 직접 재정의할 수 있으며, 이는 별칭이 지정되지 않은 속성의 경우에도 적용됩니다.
  • documentationinheaders 옵션은 더 이상 기술 미리보기로 제공되지 않으며, 안정화된 기능으로 간주됩니다. 이 옵션은 Qt 6.9에서 처음 도입되었습니다.
  • DocBook 출력을 생성할 때, QDoc은 이제 오버로드 관련 설명을 포함합니다.
  • 오버로드된 시그널과 슬롯에는 이제 사용법을 보여주는 컨텍스트 스니펫이 포함됩니다.
  • QDoc은 LLVM 21의 Clang 라이브러리에 링크할 수 있습니다.
  • .index-files에는 ` \fn` 명령에서 선언된 반환 유형이 포함됩니다. 이는 작성자가 ` auto`을 사용하여 함수의 반환 유형을 재정의하는 다중 프로젝트 빌드에서 유용합니다.
  • 이제 새로운 \qmlenum 명령어를 사용하여 QML 열거형을 문서화할 수 있습니다. QDoc은 생성된 문서에 ‘QML 열거형(QML Enumerations)’이라는 새 섹션을 만듭니다.
  • 코드 스니펫의 들여쓰기가 정규화되어, 왼쪽 여백의 불필요한 공백이 제거됩니다. 즉, 들여쓰기가 심한 소스(예: 깊게 중첩된 일련의 if-문)에서 가져온 스니펫도 마치 중첩되지 않은 것처럼 표시됩니다.
  • QDoc은 이제 기본 매개변수가 있는 템플릿 별칭을 올바르게 구문 분석합니다.
  • QDoc은 더 이상 사용 중단되지 않은 대안이 있는 경우, 사용 중단된 함수에 대한 자동 링크를 생성하지 않습니다.
  • 새로운 \notranslate 명령어를 사용하여 문자열의 기계 번역을 방지할 수 있습니다.

Qt Linguist

  • Qt Linguist 와 lupdate에서 사용자 정의 레이블을 사용하여 ID 기반 번역을 구성하는 기능이 추가되었습니다.
  • Qt Linguist 에 QML 양식 미리 보기 기능이 도입되어 문맥에 맞는 번역의 시각적 검증이 가능해졌습니다.
  • Qt Linguist 의 UI가 새로워졌으며, 새로운 아이콘, 개선된 색상 팔레트, 다크 모드 지원이 강화되었습니다.
  • lupdate와 lrelease는 이제 동일한 문서 내에서 ID 기반 번역과 텍스트 기반 번역을 혼합하여 사용할 수 있도록 지원합니다.
  • lupdate에서 Clang 기반 파서를 제거했습니다.
  • lupdate에서 다양한 프로그래밍 언어에 걸쳐 메타 문자열(//: 및 //~와 같은 주석)에 대한 지원을 통합했습니다.
  • 문서에 새로운 i18n 예제가 추가되었습니다.
  • lrelease는 이제 미완성 번역이 있는 경우 빌드를 실패시키는 -fail-on-unfinished 옵션을 제공합니다.
  • 텍스트 기반 번역의 ID를 설정하기 위해 //= 메타 문자열 주석을 사용하는 방법은 더 이상 권장되지 않습니다.

플랫폼 변경 사항

빌드 시스템 변경 사항

  • 이제 비공개 Qt 모듈 Foo를 사용하려면 find_package(Qt6 COMPONENTS FooPrivate) 를 호출하여 Qt6::FooPrivate 타깃을 사용할 수 있도록 해야 합니다.
  • qt_add_resources() 에 DISCARD_FILE_CONTENTS 옵션이 추가되었습니다.
  • Qt 6.6.0에서 사용 중단된 qt6_generate_deploy_[app_]script 의 FILENAME_VARIABLE 옵션이 제거되었습니다.
  • qt_deploy_runtime_dependencies 에 NO_PLUGINS 인수가 추가되었습니다. 이 인수는 플러그인 배포를 완전히 비활성화합니다.
  • qt_deploy_runtime_dependencies 에 INCLUDE_PLUGIN_TYPES, EXCLUDE_PLUGIN_TYPES, INCLUDE_PLUGINS 및 EXCLUDE_PLUGINS 인수가 추가되었습니다.
  • qt_generate_deploy_app_script 에 Qt 플러그인을 선택하기 위한 인수를 추가했습니다.
  • qt6_import_plugins Linux에서 CMake 배포 API를 사용한 플러그인 배포에 더 이상 영향을 미치지 않습니다.
  • qt6_deploy_runtime_dependencies 이제 Linux에서 다음 플러그인 선택 플래그를 지원합니다: INCLUDE_PLUGINS, INCLUDE_PLUGIN_TYPES, EXCLUDE_PLUGINS, EXCLUDE_PLUGIN_TYPES.
  • qt_add_qml_module() 에 DISCARD_QML_CONTENTS 옵션이 추가되어, 타깃의 리소스 시스템에서 원본 QML 및 JS 파일 내용을 제거합니다.

데스크톱 플랫폼

Windows

  • ARM용 Windows 사전 빌드 바이너리에는 QtWebEngine 및 QtWebView 도 포함되어 있습니다.

Linux

  • Linux 데스크톱용 사전 빌드된 바이너리는 이제 RHEL9를 사용하여 빌드되므로, glibc의 최소 요구 사항이 2.28에서 2.34로 상향 조정되었습니다.

macOS

  • 확장 동적 범위(EDR)를 선택한 Windows에서는 이제 화면 밝기가 변경될 때 expose 이벤트가 트리거됩니다.
  • titleUIElement 접근성 속성이 이제 지원됩니다.
  • 서비스 메뉴 통합 기능이 이제 서식 있는 텍스트를 인식합니다.
  • QOperatingSystemVersion::MacOSTahoe macOS 26을 나타냅니다.
  • WhatsThisCursor 및 BusyCursor에 대한 매핑이 추가되었습니다.
  • QImage::toCGImage()가 이제 이미지의 색 공간을 전파합니다

Linux의 Wayland 클라이언트

모바일 플랫폼

Android

Android용 Qt
  • Gradle을 버전 8.14.2로, Android Gradle Plugin(AGP)을 버전 8.10.1로 업데이트했습니다.
  • Android 12 스플래시 스크린에 대한 지원을 추가했습니다.
  • Android 16KB 페이지 크기에 대한 지원이 추가되었습니다.
  • 코드 생성기(QtJenny)에서 생성된 C++ 래퍼를 통해 Android API에 액세스하는 예제(QtJennyDemo)를 추가했습니다.
  • 지원되는 최대 플랫폼 버전을 Android 16(API 36)으로 변경했습니다.
Qt Quick Android용
  • QtQuickView에서 시그널에 대한 다중 인자 지원을 추가했습니다.
  • QML이 완전히 로드되기 전에 시그널 리스너를 등록할 수 있도록 지원이 추가되었습니다.
  • javadoc 형식의 공개 Java API.

iOS

  • Apple Pencil에 대한 QPointingDevice 지원이 추가되었습니다.
  • 표준 Apple Pencil의 회전 문제를 수정했습니다.
  • Apple Pencil 2세대 이상에 대한 호버 기능 지원이 추가되었습니다.
  • 확장 동적 범위(EDR)를 선택한 Windows에서는 이제 화면 밝기가 변경될 때 expose 이벤트가 트리거됩니다.
  • 앱이 활성 상태에서 벗어나면 업데이트 요청이 일시 중지됩니다
  • QScreen 이제 화면 방향이 반전된 경우에도 이를 보고합니다
  • RLIMIT_STACK이 이제 유효 스택 크기를 반영합니다
  • QImage::toCGImage()가 이제 이미지의 색 공간을 전달합니다

임베디드 플랫폼

Boot to Qt

실시간 운영 체제

  • 실시간 운영 체제 지원은 LTS 릴리스에 대해서만 제공됩니다. LTS가 아닌 릴리스의 경우, 지원은 프로페셔널 서비스를 통해서만 이용 가능합니다.

Qt 6.10에서 사용 중단된 모듈

다음 모듈들은 더 이상 사용되지 않습니다. 새로운 코드에서 이 모듈들을 사용하지 않을 것을 강력히 권장합니다.

Qt Charts 및 Qt DataVisualization 모듈은 더 이상 권장되지 않습니다. 이 모듈들은 여전히 라이선스 소프트웨어의 일부이며 Qt 프로젝트의 일부로 남아 있습니다. 그러나 새로운 코드를 작성할 때는 Qt Graphs를 사용하는 것을 권장합니다. 또한 {Qt Graphs Qt Charts 에서 마이그레이션 }{ Qt Charts 에서 마이그레이션 } 및 Qt Data Visualization 에서 마이그레이션에 대한 문서를 참조하십시오.

Qt 내 모듈의 수명 주기에 대한 자세한 내용은 QUIP-14를 참조하십시오.

API 변경 사항 목록

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

알려진 문제

Qt 6.10의 알려진 문제에 대한 정보는 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.