CMake ビルドツールは、さまざまなプラットフォームにわたる開発プロジェクトのビルドプロセスを簡素化します。Makefile や Visual Studio プロジェクトファイルなどのビルドシステムを自動的に生成します。

CMakeは、独自のドキュメントを備えたサードパーティ製ツールです。このトピックでは、Qt Quick UltraliteでのCMakeの使用方法について説明します。

目次

• CMake のはじめ方
• CMake リファレンス
  • CMake変数リファレンス

    QUL_ALLOW_DEPRECATED_CMAKE_API	QmlProject に置き換えられた cmake 関数およびフラグを使用する際の非推奨警告を無視する
    QUL_BINARY_ASSET_OPTIONS	画像リソースのバイナリアセットデータの組み込み方法を制御できます
    QUL_BOARD_SDK_DIR	ターゲットプラットフォームのソフトウェア開発キット (SDK) へのパス
    QUL_COLOR_DEPTH	ビルド対象のディスプレイの色深度（ビット数）。
    QUL_DEBUG_RTTI_INFORMATION	生成されるコードに含まれるランタイム型情報のレベルを選択します。
    QUL_FEATURE_TOGGLING	Qt Quick Ultralite コアライブラリでの機能のオン/オフを切り替えをサポートします
    QUL_FREERTOS_HEAP_POLICY	app_target_setup_os 用のFreeRTOS ヒープポリシーを選択します。
    QUL_OS	app_* 便利関数用の OS を選択します。
    QUL_PLATFORM	ビルド対象となるプラットフォームの名前。
    QUL_PLATFORM_DEFAULT_LAYER_RENDERING_HINTS	プラットフォームレイヤーエンジンに対するデフォルトのレンダリングヒント
    QUL_PLATFORM_DEFAULT_NUM_FRAMES_TO_PRESERVE_ASSETS	テキストキャッシュにアセットを保持するために必要なデフォルトのフレーム数
    QUL_PLATFORM_DEFAULT_TEXT_CACHE_ENABLED	指定されたプラットフォームのテキストキャッシュのデフォルトの状態
    QUL_PLATFORM_DEFAULT_TEXT_CACHE_SIZE	バイト単位でのテキストキャッシュのデフォルトサイズ
    QUL_PLATFORM_DEVICELINK_ENABLED	デバイスリンクコンポーネントを有効にします
    QUL_PLATFORM_PARTIAL_FRAMEBUFFER	有効にすると、プラットフォームは部分フレームバッファ戦略を採用します。
    QUL_PLATFORM_RENDER_BATCH_HEIGHT	指定されたプラットフォームのレンダリングバッチの高さ
    QUL_PLATFORM_UART_BAUD_RATE	シリアルポートの通信速度を選択します
    QUL_SOFTWARE_RASTERIZER_FREETYPE	ベクターグラフィックスのソフトウェアサポート
    QUL_STD_STRING_SUPPORT	Qt Quick Ultralite における標準文字列のサポート
    QUL_TARGET_TOOLCHAIN_DIR	ターゲット・ツールチェーンへのパス

    非推奨のCMake変数一覧:

    QUL_DEBUG_BYTECODE	生成されたソースコードに、コメントとして JavaScript バイトコードを追加します。
    QUL_DEBUG_LINE_DIRECTIVES	生成されたソースコードに #line ディレクティブを追加します。
    QUL_PLATFORM_DEFAULT_RESOURCE_COMPRESSED_LOSSLESS_PIXEL_FORMAT_ALPHA	透過画像アセットのロスレス圧縮におけるデフォルトのピクセル形式。
    QUL_PLATFORM_DEFAULT_RESOURCE_COMPRESSED_LOSSLESS_PIXEL_FORMAT_OPAQUE	不透明な画像アセットのロスレス圧縮におけるデフォルトのピクセル形式。
    QUL_PLATFORM_DEFAULT_RESOURCE_PIXEL_FORMAT_ALPHA	透過画像アセットのデフォルトのピクセル形式。
    QUL_PLATFORM_DEFAULT_RESOURCE_PIXEL_FORMAT_OPAQUE	不透明な画像アセットのデフォルトのピクセル形式。
    QUL_PLATFORM_REQUIRED_IMAGE_ALIGNMENT	指定されたプラットフォームにおける画像データに必要な最小アライメント。
    QUL_PLATFORM_REQUIRED_PIXEL_WIDTH_ALIGNMENT	指定されたプラットフォームでは、画像の幅はこの値の倍数になります。

  • CMake ターゲットプロパティのリファレンス（非推奨）

    QUL_AUTO_GENERATE_GLYPHS	このオプションは、静的フォントエンジンにおけるグリフの自動生成を制御します。
    QUL_COMPLEX_TEXT_RENDERING	複雑なスクリプトのレンダリングを有効にします。
    QUL_CONTROLS_STYLE	「Controls」スタイルを上書きします。
    QUL_DEFAULT_FONT_FAMILY	text要素のデフォルトのフォントファミリー。
    QUL_DEFAULT_FONT_QUALITY	text 要素のデフォルトのフォント品質。
    QUL_FONT_CACHE_PREALLOC	フォントキャッシュバッファの事前割り当てを制御します。
    QUL_FONT_CACHE_PRIMING	フォントキャッシュのプライミングを有効にします。
    QUL_FONT_CACHE_SIZE	フォントエンジンが使用するキャッシュの最大サイズを設定します。
    QUL_FONT_ENGINE	指定されたフォントエンジンを有効にします。
    QUL_FONT_FILES	フォントファイルのパス一覧。
    QUL_FONT_FILES_RESOURCE_CACHE_POLICY	アクセス速度を向上させるために、アプリケーションのフォントファイルを RAM にコピーするように設定します。
    QUL_FONT_FILES_RESOURCE_RUNTIME_ALLOCATION_TYPE	アプリケーションのフォントファイルを RAM にコピーしてアクセスを高速化するための設定を行います。
    QUL_FONT_FILES_RESOURCE_STORAGE_SECTION	アプリケーションに使用されるリソース保存セクションを設定します。
    QUL_FONT_HEAP_PREALLOC	フォントエンジンが使用するヒープバッファの事前割り当てを制御します。
    QUL_FONT_HEAP_SIZE	フォントエンジンの最大ヒープサイズを設定します。
    QUL_FONT_VECTOR_OUTLINES_DRAWING	テキストのレンダリングにベクターアウトラインを使用します。
    QUL_GLYPHS_RESOURCE_CACHE_POLICY	アクセスを高速化するために、事前にラスタライズされたグリフデータを RAM にコピーするように設定します。
    QUL_GLYPHS_RESOURCE_RUNTIME_ALLOCATION_TYPE	あらかじめラスタライズされたグリフデータを RAM にコピーする際に使用されるランタイム割り当てタイプを設定します。
    QUL_GLYPHS_RESOURCE_STORAGE_SECTION	プリラスタライズされたグリフデータに使用されるリソースストレージセクションを設定します。
    QUL_MAX_PARAGRAPH_SIZE	最大段落サイズを設定します。

  • CMake ソースファイルのプロパティ

    非推奨のソースファイルプロパティ一覧:

    QUL_RESOURCE_ALIGNMENT	テクスチャデータのバイトアライメント
    QUL_RESOURCE_CACHE_POLICY	画像キャッシュのポリシーを定義します。
    QUL_RESOURCE_COMPRESSION	画像を圧縮形式で保存します。
    QUL_RESOURCE_IMAGE_PIXEL_FORMAT	画像の推奨ピクセル形式を設定します。
    QUL_RESOURCE_OPTIMIZE_FOR_ROTATION	実行時に画像を回転させるための最適化を有効にします。
    QUL_RESOURCE_OPTIMIZE_FOR_SCALE	実行時に画像をスケーリングするための最適化を有効にします。
    QUL_RESOURCE_RUNTIME_ALLOCATION_TYPE	アセットのランタイム割り当てタイプを定義します。
    QUL_RESOURCE_SPLIT_IMAGE_OPTIMIZATION	画像を不透明なセグメントに分割するための最適化を有効にします。
    QUL_RESOURCE_STORAGE_SECTION	アセットの保存セクションを定義します。

  • CMake コマンドリファレンス

    app_target_default_entrypoint	ターゲットに最小限のエントリポイント関数を追加します
    app_target_setup_os	プラットフォーム OS 用のターゲットを設定します。
    qul_add_target	Qt Quick Ultralite アプリケーションターゲットを作成します。
    qul_generate_flash_target	アプリケーション用のフラッシュターゲットを生成します。
    qul_get_module_target	Qt Quick Ultralite モジュール・ターゲット名を取得します。
    qul_override_freertos_heap_size	freeRTOSの総ヒープサイズ設定を上書きします

    非推奨の CMake コマンド一覧:

    qul_add_qml_module	QMLモジュール用のターゲットを作成します。
    qul_add_resource	ターゲットに画像リソースを追加します。
    qul_set_maximum_resource_cache_size	指定されたランタイム割り当てタイプのリソースキャッシュの最大サイズを設定します。
    qul_target_embed_translations	.ts ファイルからの翻訳を埋め込みます。
    qul_target_generate_interfaces	エクスポートされた C を公開します。
    qul_target_qml_sources	ターゲットに QML ソースファイルを追加します。