Korištenje QML modula s dodatcima

QML moduli mogu koristiti C++ dodatke kako bi komponente definirane u C++-u učinili dostupnima aplikacijama za Qt Quick.

Za izradu QML modula:

1. Stvorite prilagođene komponente i smjestite sve .qml datoteke u direktorij namijenjen vašem modulu. Na primjer, imports\asset_imports.
2. Za projekte Qt Quick UI Prototype (.qmlproject), navedite putanju do direktorija koji sadrži modul u datoteci .qmlproject aplikacije u kojoj želite koristiti modul kao vrijednost varijable importPaths. Na primjer, importPaths: [ "imports", "asset_imports" ].
3. Stvorite datoteku qmldir za svoj modul i smjestite je u direktorij modula. Za više informacija pogledajte Modulne definicijske qmldir datoteke.
4. U direktoriju modula stvorite direktorij naziva designer.
5. Stvorite .metainfo datoteku za svoj modul i smjestite je u direktorij designer. Koristite metainfo datoteku isporučenu s Qt-om, kao što je qtquickcontrols2.metainfo, kao primjer.
6. Uvezite modul u projekt, prema uputama u odjeljku Uvođenje QML modula.

Razvoj s Qt 6.1 ili ranijim

Od Qt-a 6.2 CMake automatski generira datoteke qmltypes i qmldir.

Generiranje datoteka s opisom tipova

Prilikom registriranja QML tipova, provjerite ima li QML modul datoteku plugins.qmltypes. Idealno bi bilo da se nalazi u istom direktoriju kao i datoteka qmldir. Datoteka qmltypes sadrži opis komponenti koje izvoze plugini modula i učitava je Qt Creator kada se modul uvozi.

Za više informacija pogledajte Datoteke opisa tipova.

Automatsko ispisivanje dodataka

Ako modulu s plug-inovima nedostaje datoteka qmltypes, Qt Creator pokušava samostalno generirati privremenu datoteku pokretanjem programa qmldump u pozadini. Međutim, ovo automatsko dumpanje je mehanizam za rezervu s mnogo točaka u kojima može doći do pogreške i ne možete se na njega oslanjati.

Uvoz QML modula

Po zadanome, Qt Creator će pretraživati QML import putanju Qt-a za QML module.

Ako koristite qmake i vaša aplikacija dodaje dodatne putanje uvoza koje bi Qt Creator trebao koristiti, navedite ih pomoću QML_IMPORT_PATH u .pro datoteci vaše aplikacije: QML_IMPORT_PATH += path/to/module.

Ako koristite CMake, dodajte sljedeću naredbu u datoteku CMakeLists.txt kako biste postavili putanju za uvoz QML-a:

set(QML_IMPORT_PATH ${CMAKE_SOURCE_DIR}/qml ${CMAKE_BINARY_DIR}/imports CACHE STRING "" FORCE)

Staza uvoza utječe na sve ciljeve koje gradi CMake projekt.