Importieren von QML-Dokumentenverzeichnissen

Ein lokales Verzeichnis mit QML-Dateien kann ohne zusätzliche Einrichtung oder Konfiguration importiert werden. Ein entferntes Verzeichnis mit QML-Dateien kann ebenfalls importiert werden, setzt aber voraus, dass ein Verzeichnis mit der Datei qmldir existiert. Ein lokales Verzeichnis kann optional eine Datei mit einer Verzeichnisliste qmldir enthalten, um die Typnamen zu definieren, die Clients, die das Verzeichnis importieren, zur Verfügung gestellt werden sollen, und um JavaScript-Ressourcen anzugeben, die Importeuren zur Verfügung gestellt werden sollen.

Lokale Verzeichnisimporte

Jede QML-Datei auf dem lokalen Dateisystem kann ein lokales Verzeichnis importieren, indem sie eine Importanweisung verwendet, die sich auf den absoluten oder relativen Dateisystempfad des Verzeichnisses bezieht, so dass die Datei die in diesem Verzeichnis definierten Objekttypen verwenden kann.

Wenn das lokale Verzeichnis eine Verzeichnisliste qmldir enthält, werden die Typen mit den in der Datei qmldir angegebenen Typnamen zur Verfügung gestellt; andernfalls werden sie mit Typnamen zur Verfügung gestellt, die von den Dateinamen der QML-Dokumente abgeleitet sind. Nur Dateinamen, die mit einem Großbuchstaben beginnen und mit ".qml" enden, werden als Typen bereitgestellt, wenn keine qmldir Datei im Verzeichnis angegeben ist.

Verzeichnisimporte haben Vorrang vor allen Modulimporten. Wenn der gleiche Name in einem Modul und in einem Verzeichnis definiert ist, die beide in den gleichen Namensraum importiert werden, wird nur der Typ des Moduls verfügbar gemacht.

Ein Beispiel

Betrachten Sie die folgende Verzeichnisstruktur des QML-Projekts. Unter dem obersten Verzeichnis myapp befindet sich eine Reihe von gemeinsamen UI-Komponenten in einem Unterverzeichnis namens mycomponents und der Hauptanwendungscode in einem Unterverzeichnis namens main:

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

Die Datei main/application.qml kann das Verzeichnis mycomponents unter Verwendung des relativen Pfads zu diesem Verzeichnis importieren, so dass sie die in diesem Verzeichnis definierten QML-Objekttypen verwenden kann:

import "../mycomponents"

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

Das Verzeichnis kann in einen qualifizierten lokalen Namensraum importiert werden; in diesem Fall müssen die Verwendungen aller im Verzeichnis bereitgestellten Typen qualifiziert werden:

import "../mycomponents" as MyComponents

MyComponents.DialogBox {
    // ...
}

Die Möglichkeit, ein lokales Verzeichnis zu importieren, ist praktisch für Fälle wie anwendungsinterne Komponentensätze und Anwendungsprototyping, obwohl jeder Code, der solche Module importiert, seine relevanten import Anweisungen aktualisieren muss, wenn das Modulverzeichnis an einen anderen Ort verschoben wird. Dies kann vermieden werden, wenn stattdessen QML-Module verwendet werden, da ein installiertes Modul mit einer eindeutigen Identifizierungszeichenfolge und nicht mit einem Dateisystempfad importiert wird.

Der implizite Import

Das Verzeichnis, in dem sich ein QML-Dokument befindet, wird automatisch importiert. Sie müssen nicht explizit "." oder ähnliches importieren.

Entfernt liegende Verzeichnisse

Ein Verzeichnis mit QML-Dateien kann auch von einem entfernten Standort aus importiert werden, wenn das Verzeichnis eine Verzeichnisauflistung qmldir Datei enthält.

Wenn beispielsweise das Verzeichnis myapp im vorigen Beispiel unter "http://www.my-example-server.com" gehostet wird und das Verzeichnis mycomponents eine Datei qmldir enthält, die wie folgt definiert ist:

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

Dann könnte das Verzeichnis über die URL zum entfernten Verzeichnis mycomponents importiert werden:

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

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

Beachten Sie, dass eine Datei, die ein Verzeichnis über ein Netzwerk importiert, nur auf die QML- und JavaScript-Dateien zugreifen kann, die in der Datei qmldir in diesem Verzeichnis angegeben sind.

Verzeichnisauflistung qmldir-Dateien

Eine Verzeichnisauflistungsdatei qmldir unterscheidet sich deutlich von einer Moduldefinitionsdatei qmldir. Eine Verzeichnisauflistung qmldir ermöglicht es, eine Gruppe von QML-Dokumenten schnell und einfach gemeinsam zu nutzen, aber sie definiert keinen Typ-Namensraum, in dem die von den Dokumenten definierten QML-Objekttypen registriert werden, noch unterstützt sie die Versionierung dieser QML-Objekttypen.

Die Syntax einer Verzeichnisauflistungsdatei qmldir lautet wie folgt:

RoundedButton RoundedBtn.qml

internal HighlightedButton HighlightedBtn.qml

MathFunctions mathfuncs.js

Ein lokales Dateisystemverzeichnis kann optional eine qmldir Datei enthalten. Dies ermöglicht es der Engine, nur bestimmte QML-Typen für Clients zugänglich zu machen, die das Verzeichnis importieren. Außerdem werden die JavaScript-Ressourcen im Verzeichnis den Clients nicht angezeigt, es sei denn, sie sind in einer qmldir -Datei deklariert.