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. Qt Quick Za projekte 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. Napravite datoteku qmldir za svoj modul i smjestite je u direktorij modula. Za više informacija pogledajte Module Definition qmldir Files.
4. Kreirajte direktorij naziva designer u direktoriju vašeg modula.
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 dodatci modula i učitava je Qt Creator kada se modul uvozi.

Za više informacija pogledajte Datoteke opisa tipova.

Automatsko dumpanje 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 kvarova i ne možete se oslanjati na njega.

Uvoz QML modula

Po zadanome, Qt Creator će pretraživati QML putanju uvoza 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 datoteci .pro 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 za uvoz utječe na sve ciljeve koje gradi CMake projekt.

Pokretanje QML modula u načinu dizajna

QML Puppet se u načinu Design koristi za iscrtavanje i pregled slika te za prikupljanje podataka. Kako bi se prilagođene komponente mogle ispravno iscrtati iz QML modula, QML Puppet mora biti izgrađen s istom verzijom Qt-a i istim kompajlerom kao i QML moduli.

Design Design Vrhunac bi se trebao ponašati drugačije ovisno o tome pokreće li ga QML Puppet ili aplikacija. Na primjer, animacije se ne bi smjele pokretati u načinu uređivanja koda. Možete koristiti vrijednost okoline QML_PUPPET_MODE kako biste provjerili pokreće li aplikacija trenutno vrhunac ili se on uređuje u načinu uređivanja koda.