Qt 6 Qt 5 코드를 Qt 6로 포팅하기 위해 도움이 되는 Clazy Framework

Qt Company 는 Qt 5 코드를 Qt 6 호환성으로 이식하는 데 도움이 되도록 Clazy 프레임워크 내에서 몇 가지 검사 및 수정 기능을 구현했다. clazy는 clang이 Qt 소스코드를 이해할 수 있게 해주는 분석도구이다. Clazy를 컴파일러 플러그인으로 사용하고 .json 파일에서 clazy-standalone을 사용하거나 Qt Creator 내에서 실행할 수 있다.

Qt 6 포팅 Clazy 검사

가능한 경우 검사는 수정 사항을 제공하지만 그렇지 않은 경우 경고만 한다. 검사는 Qt 5에 대해 실행되어야 하며 수정된 코드는 Qt 6으로 만 컴파일 된다. Clazy가 권장하는 대로 하나씩 검사를 실행하지 말고 함께 실행해야 한다.

다음은 Qt 6 포팅 전용 Clazy 검사 목록이다.

qt6-deprecated-api-fixes

Qt6에서 더 이상 사용되지 않는 API에 대한 경고

qt6-header-fixes

Qt6에서 변경된 헤더에 대해 경고. 코드를 올바른 코드로 바꾼다.

qt6-qhash-signature

qHash에 대한 서명을 경고하고 수정한다. uint qHash(MyType x, uint seed)는 size_t qHash(MyType x, size_t seed)로 대체된다.

qt6-fwd-fixes

이 검사는 <QtCore/qcontainerfwd.h>에 있는 전방선언에 대해 경고. 전방선언이 제거되고, 아직 포함되지 않은 경우 <QtCore/qcontainerfwd.h>가 대신 포함된다.

missing-qobject-macro

Q_OBJECT 매크로가 없는 QObject 파생 클래스를 찾는다.

Qt Creator 내에서 Clazy 검사 및 수정 적용

모든 Clazy 검사를 Qt 6 포팅 전용으로 사용하려면 Qt Creator 버전 4.14.1 이상이 있어야 한다. Qt Creator에서 프로젝트를 연 후 분석 단계에 실행할 Clazy 검사를 선택해야 한다. 이 작업은 'Options' 또는 'Preferences' 창의 'Analyzer'에서 수행된다.

Qt Creator에서 Clazy 검사를 실행하는 방법에 대한 자세한 설명은 다음의 위치에서 찾을 수 있다.

https://doc.qt.io/qtcreator/creator-clang-tools.html

Clazy에 대한 자세한 설명은 다음 링크 페이지에서 얻을 수 있으며 확인 및 수정 사항을 적용하는 방법도 확인할 수 있다.

https://invent.kde.org/sdk/clazy

clazy-standalone 사용 방법에 대한 지침은 여기에 있다.

https://invent.kde.org/sdk/clazy#clazy-standalone-and-json-database-support

다음 주소에는 Qt 6 포팅 전용 페이지이다.

https://doc.qt.io/qt-6/portingguide.html