가져오기 중에 발생한 경고

qmllint에서는 이 경고 범주를 ‘ [import] ’로 표기합니다.

모듈 가져오기에 실패했습니다

무슨 일이 발생했나요?

import 문을 통해 가져오려던 모듈을 찾을 수 없습니다.

이 문제는 다음과 같은 원인으로 발생할 수 있습니다.

• import 문에 오타가 있거나,
• 빌드되지 않은 사용자 정의 모듈, 또는
• 잘못된 임포트 경로, 또는
• 모듈이 누락된 경우

이것이 왜 문제일까요?

애플리케이션이 의존하는 모듈을 찾을 수 없어 실행되지 않습니다.

예시

import 문 내의 오타

import QtQuicky // not ok: typo in module name

Item {
}

이 경고를 해결하려면 오타를 수정하십시오:

import QtQuick // ok: no typo in module name

Item {
}

빌드되지 않은 사용자 정의 모듈

다음과 같은 일부 툴 QML Language Serverqmllint와 같은 일부 툴은 사용자 정의 모듈이 빌드되지 않은 경우 이를 찾을 수 없습니다. 프로젝트에서 임포트하려는 QML 모듈을 정의한 경우, 해당 모듈을 빌드하기 전까지는 QML 툴에서 이를 찾을 수 없습니다.

잘못된 가져오기 경로

임포트 경로에 대한 자세한 내용은 QML 임포트 경로 문서와 모듈 임포트 디버깅 문서를 참조하십시오.

모듈 누락

앞의 섹션을 참고해도 임포트된 모듈을 찾을 수 없다면, 모듈이 누락되었을 수 있습니다. 이는 종속성이 누락되어 발생한 문제일 수 있습니다. 외부 라이브러리를 사용하는 경우, 해당 라이브러리가 실제로 설치되어 있는지, 그리고 해당 모듈이 임포트 경로에 포함되어 있는지 확인하십시오.

컴포넌트를 찾을 수 없음

무슨 일이 일어난 걸까요?

어떤 컴포넌트를 찾을 수 없습니다.

이것이 왜 문제일까요?

찾을 수 없는 컴포넌트를 인스턴스화할 수 없기 때문에 애플리케이션이 실행되지 않습니다.

예시

컴포넌트 이름의 오타

import QtQuick

Item {
    Itemy {} // not ok: typo in name
}

이 경고를 해결하려면 오타를 수정하세요:

import QtQuick

Item {
    Item {} // ok: no typo in name
}

import 문 누락

Item { // not ok: must be imported from QtQuick first
}

이 경고를 해결하려면 누락된 모듈 임포트를 추가하십시오:

import QtQuick

Item { // ok: was imported from QtQuick
}

임포트 한정자는 대문자로 시작해야 합니다

무슨 일이 발생했나요?

임포트된 모듈 중 일부의 한정자가 유효하지 않습니다.

왜 문제가 될까요?

이 잘못된 한정자를 사용하여 임포트된 모듈은 사용할 수 없습니다.

예시

import QtQuick as qq

qq.Item {
}

이 경고를 해결하려면 임포트 한정자를 대문자로 시작하도록 수정하세요:

import QtQuick as Qq

Qq.Item {
}

알 수 없는 임포트 구문

무슨 일이 발생한 것일까요?

임포트 문에서 유효하지 않은 임포트 구문을 사용하고 있습니다.

왜 문제가 될까요?

애플리케이션이 의존하는 모듈을 임포트할 수 없기 때문에 실행되지 않습니다.

예시

import "¯\(ツ)/¯:/path/to/Module"
import QtQuick

Item {
}

이 경고를 해결하려면 허용된 스키마를 가진 URL을 사용하십시오:

import "qrc:/path/to/Module"
import QtQuick

Item {
}