Импорт каталогов QML-документов

Местный каталог QML-файлов может быть импортирован без дополнительной настройки или конфигурации. Дистанционный каталог QML-файлов также может быть импортирован, но для этого требуется файл перечисления каталога qmldir . Местный каталог может необязательно содержать файл перечисления каталога qmldir для определения имен типов, которые должны предоставляться клиентам, импортирующим каталог, и для указания JavaScript-ресурсов, которые должны быть доступны импортерам.

Импорт локальных каталогов

Любой QML-файл в локальной файловой системе может импортировать локальный каталог, используя оператор импорта, который ссылается на абсолютный или относительный путь к файловой системе каталога, позволяя файлу использовать типы объектов, определенные в этом каталоге.

Если локальный каталог содержит файл перечисления каталога qmldir , типы будут доступны с именами типов, указанными в файле qmldir ; в противном случае они будут доступны с именами типов, полученными из имен файлов QML-документов. Будут экспонированы только имена файлов, начинающиеся с заглавной буквы и заканчивающиеся ".qml", если в каталоге не указан файл qmldir.

Пример

Рассмотрим следующую структуру каталогов проекта QML. В каталоге верхнего уровня myapp есть набор общих компонентов пользовательского интерфейса в подкаталоге mycomponents и основной код приложения в подкаталоге main, как это:

myapp
    |- mycomponents
        |- CheckBox.qml
        |- DialogBox.qml
        |- Slider.qml
    |- main
        |- application.qml

Файл main/application.qml может импортировать каталог mycomponents , используя относительный путь к этому каталогу, что позволяет ему использовать типы объектов QML, определенные в этом каталоге:

import "../mycomponents"

DialogBox {
    CheckBox {
        // ...
    }
    Slider {
        // ...
    }
}

Каталог может быть импортирован в квалифицированное локальное пространство имен, в этом случае использование любых типов, предоставленных в каталоге, должно быть квалифицировано:

import "../mycomponents" as MyComponents

MyComponents.DialogBox {
    // ...
}

Возможность импорта локального каталога удобна для случаев, таких как наборы компонентов в приложении и прототипирование приложений, хотя любой код, импортирующий такие модули, должен обновить соответствующие операторы import , если каталог модуля перемещен в другое место. Этого можно избежать, если использовать QML-модули, так как установленный модуль импортируется с уникальной строкой идентификатора, а не путем в файловой системе.

Дистанционно расположенные каталоги

Каталог QML-файлов также может быть импортирован из удаленного расположения, если каталог содержит файл перечисления каталога qmldir.

Например, если каталог myapp в предыдущем примере размещен по адресу "http://www.my-example-server.com", и каталог mycomponents содержал файл qmldir , определенный следующим образом:

CheckBox CheckBox.qml
DialogBox DialogBox.qml
Slider Slider.qml

Тогда каталог можно импортировать, используя URL-адрес удаленного каталога mycomponents:

import "http://www.my-example-server.com/myapp/mycomponents"

DialogBox {
    CheckBox {
        // ...
    }
    Slider {
        // ...
    }
}

Обратите внимание, что при импорте каталога через сеть файл может получить доступ только к QML- и JavaScript-файлам, указанным в файле qmldir , расположенном в каталоге.

Предупреждение: При импорте каталогов с удаленного сервера разработчики всегда должны быть осторожны, чтобы загружать каталоги только из надежных источников, чтобы избежать загрузки вредоносного кода.

Файлы перечисления каталога qmldir

Файл перечисления каталога qmldir отличается от файла определения модуля qmldir. Файл перечисления каталога qmldir позволяет быстро и легко обмениваться группой QML-документов, но он не определяет пространство имен типов, в которое регистрируются типы QML-объектов, определенные документами, и не поддерживает версионирование этих типов QML-объектов.

Синтаксис файла перечисления каталога qmldir следующий:

RoundedButton RoundedBtn.qml

internal HighlightedButton HighlightedBtn.qml

MathFunctions mathfuncs.js

Местный каталог файловой системы может необязательно включать файл qmldir . Это позволяет движку экспонировать только определенные типы QML клиентам, которые импортируют каталог. Кроме того, JavaScript-ресурсы в каталоге не экспонируются клиентам, если они не объявлены в файле qmldir.