QQmlIncubator Class

상세 설명

뷰의 델리게이트나 애플리케이션의 새 페이지와 같은 QML 객체를 생성하는 데는, 특히 리소스가 제한된 모바일 기기에서 상당한 시간이 소요될 수 있습니다. 애플리케이션이 ` QQmlComponent::create()`를 직접 사용하면 QML 객체 인스턴스가 동기식으로 생성되는데, 객체의 복잡성에 따라 애플리케이션에서 눈에 띄는 멈춤이나 끊김 현상이 발생할 수 있습니다.

QQmlIncubator를 사용하면 애플리케이션의 유휴 시간을 활용하여 비동기적으로 생성하는 것을 포함하여, QML 객체 생성을 더 세밀하게 제어할 수 있습니다. 다음 예제는 QQmlIncubator의 간단한 사용법을 보여줍니다.

// Initialize the incubator
QQmlIncubator incubator;
component->create(incubator);

인큐베이터를 잠시 실행한 후(일반적으로 제어권을 이벤트 루프로 반환함으로써), 이를 폴링합니다. 나중에 인큐베이터로 다시 돌아가는 방법에는 여러 가지가 있습니다. QQuickWindow 가 보내는 신호 중 하나에 연결하거나, 이를 위해 특별히 QTimer 를 실행할 수도 있습니다. 또한 특정 목적을 위해 객체가 필요할 수 있으며, 해당 목적이 발생할 때 인큐베이터를 폴링할 수도 있습니다.

// Poll the incubator
if (incubator.isReady()) {
    QObject *object = incubator.object();
    // Use created object
}

비동기 인큐베이터는 QQmlEngine 에 설정된 QQmlIncubationController 에 의해 제어되며, 이를 통해 엔진은 애플리케이션이 유휴 상태이고 인큐베이션 중인 객체를 처리해야 할 시점을 알 수 있습니다. QQmlEngine 에 인큐베이션 컨트롤러가 설정되어 있지 않으면, QQmlIncubator 는 지정된 IncubationMode 에 관계없이 객체를 동기식으로 생성합니다. 기본적으로 인큐베이션 컨트롤러는 설정되어 있지 않습니다. 그러나 QQuickView, QQuickWindow 및 QQuickWidget 는 모두 각자의 QQmlEngine에 인큐베이션 컨트롤러를 설정합니다. 이러한 인큐베이션 컨트롤러는 뷰가 렌더링되는 동안 여러 프레임에 걸쳐 인큐베이션을 분산시킵니다.

QQmlIncubator는 세 가지 인큐베이션 모드를 지원합니다:

• 동기식: 생성이 동기식으로 이루어집니다. 즉, ` QQmlComponent::create()` 호출이 반환되면 인큐베이터는 이미 `Error` 또는 `Ready` 상태 중 하나가 됩니다. 동기식 인큐베이터는 ` QQmlComponent `에서 직접 동기식 생성 메서드를 사용하는 것에 비해 실질적인 이점은 없지만, 동기식 및 비동기식 생성 모두에 동일한 API를 사용함으로써 애플리케이션 구현을 단순화할 수 있습니다.
• 비동기(기본값) QQmlEngine 에 QQmlIncubatorController가 설정되어 있다고 가정할 때, 생성은 비동기적으로 수행됩니다.

  생성이 완료되거나 오류가 발생할 때까지 인큐베이터는 Loading 상태를 유지합니다. 상태 변경 알림을 받으려면 statusChanged() 콜백을 사용할 수 있습니다.

  애플리케이션은 즉시 필요하지 않은 객체를 생성할 때 비동기 인큐베이션 모드를 사용해야 합니다. 예를 들어, ` ListView ` 타입은 목록이 스크롤되는 동안 화면 밖으로 약간 벗어난 객체를 생성할 때 비동기 인큐베이션을 사용합니다. 비동기 생성 중에 객체가 즉시 필요한 경우, ` QQmlIncubator::forceCompletion()` 메서드를 호출하여 생성 과정을 동기식으로 완료할 수 있습니다.

• AsynchronousIfNested 생성은 중첩된 비동기 생성 과정의 일부인 경우 비동기적으로, 그렇지 않은 경우 동기적으로 수행됩니다.

  QML 컴포넌트가 동기식 인스턴스화처럼 보이기를 원하는 대부분의 시나리오에서는 이 모드를 사용해야 합니다.

  이 모드는 예제를 통해 설명하는 것이 가장 좋습니다. ` ListView ` 유형이 처음 생성될 때, 표시할 초기 델리게이트 세트로 자체를 채워야 합니다. ListView 의 높이가 400 픽셀이고 각 델리게이트의 높이가 100 픽셀이라면, 4개의 초기 델리게이트 인스턴스를 생성해야 합니다. ListView 가 비동기 인큐베이션 모드를 사용한다면, ListView 는 항상 비어 있는 상태로 생성된 다음, 얼마 후 4개의 초기 항목이 나타납니다.

  반대로, ListView 가 동기식 인큐베이션 모드를 사용한다면 올바르게 동작하겠지만, 애플리케이션에 끊김 현상이 발생할 수 있습니다. QML이 일시 중지되어 ListView 의 델리게이트를 동기식으로 인스턴스화해야 하기 때문에, ListView 가 비동기식으로 인스턴스화되는 QML 컴포넌트의 일부라면 비동기 인스턴스화의 이점이 상당 부분 상쇄될 것입니다.

  AsynchronousIfNested 모드는 이 문제를 해결합니다. AsynchronousIfNested 를 사용하면, ListView 자체가 이미 비동기 인스턴스화의 일부인 경우 ListView 의 델리게이트가 비동기적으로 인스턴스화되고, 그렇지 않은 경우에는 동기적으로 인스턴스화됩니다. 중첩된 비동기 인스턴스화의 경우, 모든 중첩된 인스턴스화가 완료된 후에야 바깥쪽 비동기 인스턴스화가 완료됩니다. 이를 통해 바깥쪽 비동기 인스턴스화가 완료될 때쯤에는 ListView 와 같은 내부 항목들이 이미 초기 델리게이트 로딩을 완료한 상태가 됩니다.

  동기식(Synchronous) 인큐베이션 모드를 사용하는 것은 거의 항상 잘못된 방법입니다. 동기식 인스턴스화처럼 보이되, 애플리케이션에 멈춤이나 끊김 현상을 유발하는 단점은 피하고자 하는 요소나 컴포넌트는 비동기식( AsynchronousIfNested ) 인큐베이션 모드를 사용해야 합니다.