Qt Extras 모듈의 변경 사항

Qt 6은 프레임워크를 더욱 효율적이고 사용하기 쉽게 만들기 위한 의도적인 노력의 결과물입니다.

저희는 각 릴리스에서 모든 공개 API에 대해 바이너리 및 소스 호환성을 유지하기 위해 노력하고 있습니다. 하지만 Qt를 더 나은 프레임워크로 만들기 위한 노력의 일환으로 일부 변경 사항은 불가피했습니다.

이러한 변경 사항 중 하나는 Qt 6의 일관된 크로스 플랫폼 지원과 미래를 보장하기 위해 플랫폼별 Extras 모듈을 제거한 것이었습니다. 이 모듈들이 제공하던 기능의 대부분은 다른 Qt 모듈의 유사한 기능으로 대체되었습니다. 이 가이드는 이러한 대체 기능을 요약하고, Qt에서 대체 API를 제공하지 않는 경우에 대한 지침을 제공합니다.

Qt Mac Extras의 변경 사항

QtMac 네임스페이스

QtMac 네임스페이스의 대부분의 멤버에는 명확한 대체 기능이 있습니다. QtMac::fromCGImageRef 함수는 해당 API를 사용하는 클라이언트가 알려진 바 없어 제거되었습니다.

QMacPasteboardMime

QMacPasteboardMime 클래스는 QUtiMimeConverter 로 대체되었습니다. 자세한 내용은 Qt GUI 의 ‘#네이티브 클립보드 통합’ 변경 사항을 참조하십시오.

QMacToolBar

QMacToolBar 및 QMacToolBarItem 클래스가 제거되었습니다. 대신 QToolBar 를 사용하십시오.

Qt Windows Extras의 변경 사항

QtWin 네임스페이스

QtWin 네임스페이스의 많은 멤버에 대해 명시적인 대체 항목이 제공됩니다. Qt Widgets 또는 Qt Quick 와 함께 이러한 대체 항목을 사용하려면, 관련 위젯이나 컨트롤의 QWindow 표현을 대상으로 작업하십시오.

나머지 함수들은 제거되었습니다:

errorStringFromHresult

WinExtras 내부에서만 사용됩니다. 이 API를 사용하는 다른 클라이언트는 알려진 바 없습니다.

colorizationColor/isCompositionOpaque

다른 플랫폼(틴트/액센트 색상)에도 해당 개념이 존재합니다. 새로운 크로스 플랫폼 API, 예를 들어 새로운 QPalette 역할이나 플랫폼 테마 속성이 필요합니다.

setWindowFlip3DPolicy

Windows 7 기능입니다. Windows 10에서는 더 이상 지원되지 않습니다.

extendFrameIntoClientArea

다른 플랫폼에도 유사한 기능이 존재합니다. 클라이언트 영역과 비클라이언트 영역(프레임/제목 표시줄) 간의 관계를 제어하기 위한 크로스 플랫폼 QWindow API가 필요합니다. 자세한 내용은 QTBUG-94010을 참조하십시오.

enableBlurBehind

Windows 8부터 사용 중단되었습니다.

taskbarActivateTab 및 taskbar(Add/Delete)Tab

이 API를 사용하는 클라이언트는 알려진 바 없습니다.

QWinMime

QWinMime 클래스는 QWindowsMimeConverter 로 대체되었습니다. 자세한 내용은 Qt GUI#Native clipboard integration의 변경 사항을 참조하십시오.

QWinJumpList

크로스 플랫폼 솔루션이 필요함에 따라 QWinJumpList, QWinJumpListCategory 및 QWinJumpListItem 클래스가 제거되었습니다. 자세한 내용은 QTBUG-94007을 참조하십시오.

QWinTaskbarButton

크로스 플랫폼 솔루션이 필요함에 따라 QWinTaskbarButton 및 QWinTaskbarProgress 클래스가 제거되었습니다. 자세한 내용은 QTBUG-94009 및 QTBUG-94008을 참조하십시오.

QWinThumbnailToolBar

QWinThumbnailToolBar 및 QWinThumbnailToolButton 클래스는 해당 API를 사용하는 것으로 알려진 클라이언트가 없어 제거되었습니다.

Qt X11 Extras의 변경 사항

Qt 6에서 Qt X11 Extras 모듈이 제거되었습니다.

• QX11Info::connection()의 경우, 대신 QNativeInterface::QX11Application::connection()을 사용하십시오.
• QX11Info::display()의 경우, 대신 QNativeInterface::QX11Application::display()을 사용하십시오.
• QX11Info::isPlatformX11()의 경우, 대신 QNativeInterface::QX11Application 의 존재 여부를 확인하십시오.

다음 코드 조각과 같이 QGuiApplication 에서 QNativeInterface::QX11Application 객체를 가져올 수 있는지 반드시 확인하십시오:

    Display *display = nullptr;
    xcb_connection_t *connection = nullptr;
    bool isPlatformX11 = false;
    if (auto *x11Application = qGuiApp->nativeInterface<QNativeInterface::QX11Application>()) {
        display = x11Application->display();
        connection = x11Application->connection();
        isPlatformX11 = true;
    }
    // or
    // isPlatformX11 = qGuiApp->nativeInterface<QNativeInterface::QX11Application>();

여전히 QX11Info 클래스의 기능을 사용하는 클라이언트는 임시 해결책으로 비공개 헤더 <QtGui/private/qtx11extras_p.h> 를 포함할 수 있습니다. 비공개 헤더를 사용하려면 QT += gui-private 에 qmake 를 지정하거나, Qt::GuiPrivate 에 CMake 를 추가하여 프로젝트 의존성을 설정하십시오.

Qt for Android Extras의 변경 사항

이 모듈의 주요 기능이 다른 Qt 모듈로 이관되었습니다.

여전히 누락된 기능에 의존하는 클라이언트는 임시 방편으로 비공개 헤더 <QtCore/private/qandroidextras_p.h> 를 포함할 수 있습니다. 비공개 헤더를 사용하려면 QT += core-private 를 qmake 와 함께 사용하거나, CMake 를 통해 Qt::CorePrivate 에 대한 프로젝트 종속성을 추가하십시오.

QAndroidJniObject 및 QAndroidJniEnvironment

QAndroidJniObject 및 QAndroidJniEnvironment 클래스는 각각 QJniObject 및 QJniEnvironment 로 대체되었습니다.

QAndroidJniExceptionCleaner 클래스는 더 이상 필요하지 않습니다. 대체 클래스에 대해서는 QJniEnvironment::checkAndClearExceptions()을 참조하십시오.

QtAndroid 네임스페이스

QtAndroid 네임스페이스의 많은 멤버에 대해 QAndroidApplication 네이티브 인터페이스에서 대체 항목이 제공됩니다.

권한

애플리케이션 권한 인프라를 통해 크로스 플랫폼 방식으로 일련의 권한을 요청할 수 있습니다.

QtAndroidPrivate 네임스페이스를 사용하면 크로스 플랫폼 권한 시스템에서 다루지 않는 Android 고유의 권한에 접근할 수 있습니다.