CMake - Qtコマンドのソースを表示

== 概要 ==

<br><br>

== Qt6 CoreのCMakeコマンド ==
==== Qt6 CoreのCMakeコマンド一覧 ====
下表のCMakeコマンドは、Qt6::Coreが読み込まれた時に定義される。<br>
 <syntaxhighlight lang="cmake">
 find_package(Qt6 REQUIRED COMPONENTS Core)
 </syntaxhighlight>
<br>
<center>
{| class="wikitable" | style="background-color:#fefefe;"
|+ Qt6 CoreのCMakeコマンド
|-
! style="background-color:#66CCFF;" | CMakeコマンド
! style="background-color:#66CCFF;" | 説明
|-
| qt_add_big_resources || 大きなバイナリリソースをオブジェクトコードにコンパイルする。
|-
| qt_add_binary_resources || QtリソースファイルのリストからRCCファイルを生成する。
|-
| qt_add_executable || プラットフォーム固有のタイプのアプリケーションターゲットを生成および確定する。
|-
| qt_add_library || ライブラリを生成および確定する。
|-
| qt_add_plugin || Qtプラグインターゲットを生成する。
|-
| qt_add_resources || バイナリリソースをソースコードにコンパイルする。
|-
| qt_allow_non_utf8_sources || ソースファイルがWindows用のUTF-8として強制的に扱われるのを防ぐ。
|-
| qt_android_add_apk_target || androiddeployqtを実行して、APKを生成するビルドターゲットを定義する。
|-
| qt_android_apply_arch_suffix || ターゲットバイナリの名前にアーキテクチャ固有のサフィックスを含めるように設定する。
|-
| qt_android_generate_deployment_settings || androiddeployqtが必要とするデプロイ設定ファイルを生成する。
|-
| qt_deploy_qt_conf || デプロイ時に、qt.confファイルを書き込む。
|-
| qt_deploy_runtime_dependencies || 実行ファイルに必要なQtプラグイン、Qtライブラリ、非Qtライブラリをデプロイする。
|-
| qt_deploy_translations || 実行ファイルが必要とするQtの翻訳をデプロイする。
|-
| qt_disable_unicode_defines || ユニコード関連のコンパイラ定義がターゲット上で自動的に設定されるのを防ぐ。
|-
| qt_extract_metatypes || Qtターゲットからmetatypesを抽出して、関連するmetatypes.jsonファイルを生成する。
|-
| qt_finalize_project || Qtプロジェクトに関連するプラットフォーム固有のタスクを処理する。
|-
| qt_finalize_target || Qtターゲットに関連するプラットフォーム固有のタスクを処理する。
|-
| qt_generate_deploy_app_script || アプリケーションのデプロイスクリプトを生成する。
|-
| qt_generate_deploy_script || カスタムデプロイスクリプトを生成する。
|-
| qt_generate_moc || 入力ファイルに対して、mocを呼び出す。
|-
| qt_import_plugins || インポートあるいは除外するプラグインのカスタムセットを指定する。
|-
| qt_policy || QtのCMake APIのデフォルトの振る舞いを変更する。
|-
| qt_set_finalizer_mode || ターゲットのファイナライズをカスタマイズする。
|-
| qt_standard_project_setup || プロジェクト全体のデフォルトを標準的な配置に設定する。
|-
| qt_wrap_cpp || ソースからmocファイルを生成する。
|}
</center>
<br>
==== qt_add_resources / qt6_add_resources ====
バイナリリソースをソースコードにコンパイルするコマンドである。<br>
<br>
リソースを追加するには、コマンドの第1引数に変数名かターゲットを渡す。<br>
第1引数に変数名を渡すと、qt_add_resourcesコマンドはリソースコンパイラ(rcc)を使用してQtリソースファイルからソースコードを生成する。<br>
生成されたソースファイルへのパスは、<nowiki><VAR></nowiki>に追加される。<br>
<br>
第1引数としてターゲットを渡すと、関数は指定された<FILES>を含む<RESOURCE_NAME>という名前のリソースを生成する。<br>
リソースは自動的に<TARGET>にリンクされる。<br>
<br>
Qtリソースの詳細を知りたい場合は、[https://doc.qt.io/qt-6/resources.html Qtの公式ドキュメント]を参照すること。<br>
 <syntaxhighlight lang="cmake">
 # Qt 5
 qt_add_resources(<VAR> file1.qrc file2.qrc ...
                  [OPTIONS ...])
 
 # Qt 6
 qt_add_resources(<TARGET> <RESOURCE_NAME>
                  [PREFIX <PATH>]
                  [LANG <LANGUAGE>]
                  [BASE <PATH>]
                  [BIG_RESOURCES]
                  [OUTPUT_TARGETS <VARIABLE_NAME>]
                  [FILES ...] [OPTIONS ...]
 )
 
 # Qt 6 (バージョンレスコマンドが無効になっている場合)
 qt6_add_resources(<TARGET> <RESOURCE_NAME>
                   [PREFIX <PATH>]
                   [LANG <LANGUAGE>]
                   [BASE <PATH>]
                   [BIG_RESOURCES]
                   [OUTPUT_TARGETS <VARIABLE_NAME>]
                   [FILES ...] [OPTIONS ...]
 )
 </syntaxhighlight>
<br>
 <syntaxhighlight lang="cmake">
 # 使用例
 
 # .qrcファイルを使用した変数を使用する場合
 set(SOURCES main.cpp)
 qt_add_resources(SOURCES
    example.qrc
 )
 qt_add_executable(<プロジェクト名>
    ${SOURCES}
 )
 
 # 即時リソースを使用してターゲット名を指定する場合
 qt_add_executable(<プロジェクト名>
    main.cpp
 )
 qt_add_resources(<プロジェクト名> "images"
                  PREFIX "/images"
                  FILES image1.png image2.png
 )
 </syntaxhighlight>
<br>
* ターゲット名を指定する場合のバリアントの引数
** <PREFIX>
**: このリソースの全てのファイルが、C++ソースコードからアクセスできるようにするためのパス接頭辞を指定する。
**: これは、.qrcファイル形式のXML属性プレフィックスに対応する。
**: <PREFIX>を指定しない場合、ターゲットプロパティQT_RESOURCE_PREFIXが使用される。
**: <br>
**: Qt 6.5以降、PREFIXはオプションである。<br>
**: <br>
**: もし、PREFIXが省略されて、かつ、QT_RESOURCE_PREFIXで指定しない場合は、"/"がデフォルトのパス接頭辞として使用される。<br>
**: <br>
** <LANG>
**: このリソースのロケールを指定する。
**: これは、.qrcファイル形式のXML属性langに対応する。
** <BASE>
**: ファイルのエイリアスのルートポイントを示すパスプレフィックスである。
**: 例えば、<BASE>が"assets"、<FILES>が"assets/images/logo.png"の場合、そのファイルのエイリアスは、"images/logo.png"となる。
**: <br>
**: ファイルのエイリアス設定は、<QT_RESOURCE_ALIAS>ソースファイルプロパティで設定する必要がある。
**: <br>
** BIG_RESOURCES
**: ビッグリソースのサポートを有効にできる。
**: これは、C++ソースコードの代わりにオブジェクト・ファイル (.o .obj) を直接生成する。
**: これにより、生成されたC++ソースをコンパイルすることなく、より大きなリソースを埋め込むことができる。
**: <br>
**: <BIG_RESOURCES>は、CMakeのXcodeプロジェクトジェネレータの制限によりiOSと互換性が無いことに注意する。
**: また、<BIG_RESOURCES>は、CMake 3.17以降でのみ動作する。
**: <br>
**: 静的ライブラリでこのコマンドを使用する場合、1つ以上の特別なターゲットが生成される。
**: これらのターゲットに対して追加の処理を行う場合は、<OUTPUT_TARGETS>パラメータに変数名を渡す。
**: <br>
**: qt_add_resourcesコマンドは、特殊ターゲットの名前を指定された変数に格納する。
<br>
==== qt_disable_unicode_definesコマンド ====
Qt 6では、Qtモジュールに対してリンクするターゲットに対して、<code>UNICODE</code>と<code>_UNICODE</code>コンパイラ定義がデフォルトで有効化されている。<br>
<code>qt_disable_unicode_defines</code>コマンドを実行することにより、<code>UNICODE</code>と<code>_UNICODE</code>コンパイラ定義が自動的に設定されるのを防ぐことができる。<br>
<br>
このコマンドは、Qt 6 Coreコンポーネントで定義されている。 (Qt 6.2で導入された)<br>
<br>
バージョンレスコマンドが無効の場合は、代わりに<code>qt6_disable_unicode_defines</code>コマンドを使用する。<br>
 <syntaxhighlight lang="cmake">
 find_package(Qt6 REQUIRED COMPONENTS Core)
 
 qt_disable_unicode_defines(myApp)
 </syntaxhighlight>
<br><br>


{{#seo:
|title={{PAGENAME}} : Exploring Electronics and SUSE Linux | MochiuWiki
|keywords=MochiuWiki,Mochiu,Wiki,Mochiu Wiki,Electric Circuit,Electric,pcb,Mathematics,AVR,TI,STMicro,AVR,ATmega,MSP430,STM,Arduino,Xilinx,FPGA,Verilog,HDL,PinePhone,Pine Phone,Raspberry,Raspberry Pi,C,C++,C#,Qt,Qml,MFC,Shell,Bash,Zsh,Fish,SUSE,SLE,Suse Enterprise,Suse Linux,openSUSE,open SUSE,Leap,Linux,uCLnux,Podman,電気回路,電子回路,基板,プリント基板
|description={{PAGENAME}} - 電子回路とSUSE Linuxに関する情報 | This page is {{PAGENAME}} in our wiki about electronic circuits and SUSE Linux
|image=/resources/assets/MochiuLogo_Single_Blue.png
}}

__FORCETOC__
[[カテゴリ:Qt]]