このページでは

CMake ですべてをまとめる

QML モジュールを作成する際、CMake は QML タイプを適切に登録し、必要なメタデータを生成し、モジュールが正しくパッケージ化され、デプロイできるようにするためのインフラストラクチャを提供します。このページでは、推奨されるワークフローの概要を説明します。

qt_add_qml_module を使う

qt_add_qml_moduleコマンドは QML モジュールを作成するための標準的かつ推奨される方法です。qt_add_qml_module コマンドは QML モジュールを作成するための複雑な処理をすべて行います:

qt_add_qml_module(my_qml_module
    URI MyModule
    QML_FILES
        MyType.qml
        AnotherType.qml
    SOURCES
        mytype.cpp mytype.h
)

このコマンドひとつで

  • モジュールターゲットを作成する
  • C++およびQMLファイルからQML型を登録する。
  • qmldirファイルの生成
  • 型登録の処理
  • 適切なインポートパスの設定
  • QMLツールのサポート(qmllintqmllsなど)の有効化

QML ファイルの追加

最初のqt_add_qml_module 呼び出しの後に QML ファイルを追加する場合は、qt_target_qml_sources を使用します:

qt_target_qml_sources(my_qml_module
    QML_FILES
        DynamicallyAddedType.qml
)

これはプラットフォームやコンフィギュレーション、その他の要因に基づいて行うことができます。

詳細なCMakeリファレンス

全てのCMakeコマンド、プロパティ、変数、ポリシーの詳細については、CMake Integration for QMLを参照してください。

QML モジュールと qt_add_qml_moduleも参照してください

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.