한국어
Qt
 

QML and Qt Quick QML 바인딩 끊김 진단

makersweb 2020.11.08 18:57 조회 수 : 7946

속성(프로퍼티) 바인딩은 QML 언어의 가장 흥미로운 기능 중 하나다. QML에서 속성(프로퍼티)에 값을 설정하면 일반적인 명령형 언어처럼 오른쪽 표현식은 단지 한 번 연산하여 값을 산출하지 않는다. 특히 표현식에 다른 속성이 포함 된 경우 설정중인 속성이 표현식의 속성에 바인딩 된다. 값을 변경할 때마다 표현식이 자동으로 다시 산출되고 대상 속성 값이 업데이트된다.

 
예를 들면 :
import QtQuick 2.0

Rectangle {
    width: 100; height: 100

    // 바인딩:
    color: mouseArea.containsMouse ? "red" : "blue"

    MouseArea {
        id: mouseArea;
        anchors.fill: parent;
        hoverEnabled: true
    }
}
위의 코드에서 Rectangle 의 색상(color)은 바인딩의 대상이며, 내부 MouseArea 의 마우스 속성에 바인딩 된다. 마우스 포인터가 MouseArea 내부 또는 외부로 이동하면 mouse 속성이 변경되어 색상에 대한 표현이 다시 산출된다. 즉, 직사각형은 마우스 커서가 그 위를 맴돌면 빨간색이 되고, 그렇지 않으면 파란색이 된다.
 
속성 바인딩을 사용하면 매우 선언적인 방식으로 UI를 빌드 할 수 있다. 다른 속성이 값을 변경할 때 UI 요소를 업데이트하기 위해 "슬롯"을 작성할 필요가 없다.
 
오른쪽에 쓸 수 있는 표현식은 함수 호출을 포함하더라도 얼마든지 복잡할 수 있다. 엔진은 가능한 모든 작업을 할 것이고, 예상대로 바인딩을 할 것이다.
 
 
속성 바인딩 끊김
속성(프로퍼티) 바인딩에는 다음과 같은 제한이 있다. 속성에 값을 설정하기 위해 명령형 할당을 사용하는 경우 바인딩이 끊어진다. 예를 들어 사각형을 클릭 할 때 녹색으로 바뀌기를 원한다고 가정하자. 
 
다음과 같다:
import QtQuick 2.0

Rectangle {
    width: 100; height: 100

    // 이것은 여전히 바인딩.
    color: mouseArea.containsMouse ? "red" : "blue"

    MouseArea {
        id: mouseArea
        anchors.fill: parent
        hoverEnabled: true
        onClicked: {
            parent.color = "green" // 바인딩이 끊어짐
        }
    }
}
onClicked 신호 처리기에서 명령형 JavaScript 코드의 일반 할당을 사용하여 color 속성을 녹색으로 설정한다. 이 코드를 사용하여 사각형을 클릭 한 다음 마우스를 사각형 위로 이동하면 사각형이 더 이상 색상이 변경되지 않고 녹색으로 유지된다. 이는 명령형 할당이 바인딩을 파괴하고 color 속성을 하나의 특정 값으로 설정하기 때문에 발생한다.
 
일반적으로 위의 예는 문서화 된 QML 규칙을 따르는 100% 정확한 QML 코드다. 따라서 이러한 코드가 QML 엔진에 의해 거부되거나 무조건 경고를 발생시켜야 한다고 할 수는 없다. 
 
끊어진 바인딩은 항상 우연히 (리팩토링 중, 원래 속성이 무언가에 바인딩되어 있다는 사실을 인식하지 못함) 또는 (더 선언적인 접근 방식을 사용하는 대신) 상태를 관리하기 위해 JavaScript를 과도하게 사용하여발생한다. 이런경우, 일반적으로 QML 소스 코드를 읽을 때 문제가 무엇인지 명확하지 않기 때문에 이러한 문제를 디버깅하는 것은 매우 어려울 수 있다. 버그는 명령형 할당이 포함 된 JavaScript 코드가 실행될 때만 나타날 것이다.
 
 
끊어진 바인딩 디버깅
이러한 사례를 보다 쉽게 추적 할 수 있도록 QML 엔진에는 Qt 5.10 부터 추가된 디버깅 기능이 있다. QML 엔진은 바인딩이 끊어 질 때마다 디버깅 정보를 출력 한다.
디버그 출력을 활성화하려면 QT_LOGGING_RULES 환경변수를 설정하는 방식으로 qt.qml.binding.removal 로깅 범주에 대한 출력을 활성화하면 된다.
export QT_LOGGING_RULES="qt.qml.binding.removal.info=true"
 
위의 예제에 대해서 이제 다음 디버그 메시지를 출력한다.
qt.qml.binding.removal: Overwriting binding on MyItem_QMLTYPE_0::color at qrc:/MyItem.qml:14 that was initially bound at qrc:/MyItem.qml:7:5
 
메시지는 바인딩 된 속성, 바인딩이 설정된 위치 및 바인딩을 중단하는 명령문이 있는 위치를 알려준다.
번호 제목 글쓴이 날짜 조회 수
공지 Qt프로그래밍(QtQuick) Beginner를 위한 글 읽는 순서 운영자 2019.01.05 452786
180 Visual Studio Code용 Qt 확장팩 file makersweb 2024.10.09 13722
179 Qt 응용프로그램에 Web 구성 요소를 표시 with Servo file makersweb 2024.04.27 14050
178 Qt Creator 에서 GitHub Copilot 사용하기 file makersweb 2024.04.13 16680
177 QtQuick 애플리케이션에 Rive 애니메이션 통합 makersweb 2024.03.31 9120
176 클라우드용 Qt file makersweb 2024.01.16 7863
175 QRhi 에 대해서 file makersweb 2023.12.29 9764
174 Android 애플리케이션 서명 구성 file makersweb 2023.12.17 8378
173 QML의 사용자 정의 Image makersweb 2023.09.17 11352
172 Base64로 인코딩된 파일을 복원 makersweb 2023.08.06 14059
171 QML에서 D-Bus 통신 file makersweb 2023.03.15 7231
170 Qt 하이브리드 애플리케이션(Hybrid App) 개발 file makersweb 2023.02.08 8980
169 Widgets(C++) 기반의 기본 스타일을 Dark 테마 및 Material 디자인 스타일로 바꾸기 file makersweb 2023.01.28 12642
168 OpacityMask 예제 file makersweb 2023.01.26 12159
167 QProcess 예제 (프로그램 재시작) file makersweb 2023.01.25 6839
166 하드디스크 드라이브 여유 공간 계산 file makersweb 2023.01.15 9221
165 Qt Property(속성) 시스템 makersweb 2023.01.08 13061
164 VTK 를 사용해서 강력한 시각화(3D, Plotting, Chart)Qt 응용프로그램 개발하기 file makersweb 2022.10.16 9440
163 QProcess 보안 권고 리뷰 file makersweb 2022.09.18 4983
162 QMake 프로젝트를 CMake 프로젝트로 변환 with qmake2cmake makersweb 2022.09.17 5930
161 Qt Safe Renderer 개요 file makersweb 2022.09.08 13498
 
단일배너