LinuxCommandLibrary

sfdk-qmltypes

Generate QML type description JSON files

TLDR

Generate qmltypes files

$ sfdk qmltypes
copy

Generate qmltypes files without deploying them (usually to emulator)
$ sfdk qmltypes --no-deploy
copy

Generate qmltypes files without restoring the emulator after deployment
$ sfdk qmltypes --no-restore-emulator
copy

Generate qmltypes files and restore the emulator after deployment even on failure
$ sfdk qmltypes --restore-emulator
copy

Generate qmltypes files without reverting changes which only include removal of statements with sdk-make-qmltypes:keep in comments
$ sfdk qmltypes --no-keep
copy

SYNOPSIS

sfdk-qmltypes [options]

PARAMETERS

-o
    Specifies the output file for the generated .qmltypes file.

-I
    Adds a directory to the include path for resolving QML imports.

[QML file(s)]
    One or more QML files to process.

-help
    Displays help information.

-version
    Displays the version information.

DESCRIPTION

The `sfdk-qmltypes` command is a tool within the SFDK (probably SDK) environment that processes QML (Qt Meta Language) files to generate type information necessary for QML engine integration. It analyzes QML files and extracts information about properties, signals, methods, and other relevant QML entities. This information is then compiled into a format (likely a `.qmltypes` file) that the QML engine can use at runtime to understand the structure and capabilities of the QML components. This enables features like property binding, signal connections, and method calls between QML and C++ code. The generated `.qmltypes` files are crucial for enabling seamless interaction between QML user interfaces and backend logic or data sources implemented in other languages. Without this process, QML components would not be properly recognized and utilized by the QML engine. Typically used as part of a build process for QML-based applications. Using `sfdk-qmltypes` ensures proper type safety and correct invocation of components and functions within QML.

CAVEATS

The exact options and behavior of `sfdk-qmltypes` might depend on the specific version of SFDK used. Ensure that the correct SFDK environment is set up before using this command.

USAGE EXAMPLE

To generate a `.qmltypes` file for `MyComponent.qml`:
sfdk-qmltypes -o MyComponent.qmltypes MyComponent.qml

To specify an include path:
sfdk-qmltypes -I /path/to/imports -o MyComponent.qmltypes MyComponent.qml

OUTPUT FILE

The generated .qmltypes file is a text-based file that describes the QML types, properties, signals, and methods. This file is used by the QML engine to understand the structure of the QML component.

SEE ALSO

qml(1)

Copied to clipboard