MochiuWiki : SUSE, EC, PCB

「Qtの設定 - CMake」の版間の差分

📢 Webサイト閉鎖と移転のお知らせ
このWebサイトは2026年9月に閉鎖いたします。
新しい記事は移転先で追加しております。（旧サイトでは記事を追加しておりません）

← 古い編集
ビジュアルウィキテキスト
細 文字列「__FORCETOC__」を「{{#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 pag…
 
(同じ利用者による、間の8版が非表示)
26行目: 26行目:
*: 指定したディレクトリからヘッダファイルを検索するコマンドである。
*: 指定したディレクトリからヘッダファイルを検索するコマンドである。
*: 定義した箇所以降の全てのターゲットが指定したディレクトリをインクルードするため、使用は避けるべきである。
*: 定義した箇所以降の全てのターゲットが指定したディレクトリをインクルードするため、使用は避けるべきである。
*: 代わりに、<code>target_include_directories</code>コマンドを使用する必要がある。
<br>
<br>
* add_definitionsコマンド
* add_definitionsコマンド
** プロジェクト全体に影響を与えてしまう。
** ビルド依存性の管理が難しくなる。
** コンパイラの最適化を阻害する可能性がある。
*: 代わりに、<code>target_compile_definitions</code>コマンドを使用する必要がある。
<br>
<br>
* add_compile_definitionsコマンド
* add_compile_definitionsコマンド
** プロジェクト全体への影響
**: プロジェクト内の全てのターゲットに対して定義を追加される。
**: これにより、意図しないターゲットにまで定義が設定されてしまう可能性がある。
** ビルド依存性の管理が難しくなる
**: 特定のターゲットにのみ必要な定義がプロジェクト全体に設定されると、ビルド依存性の管理が複雑になる。
** コンパイラの最適化への影響
**: 不要な定義が設定されると、コンパイラの最適化が阻害される可能性がある。
*: 代わりに、<code>target_compile_definitions</code>コマンドを使用する必要がある。
<br>
<br>
* add_compile_optionsコマンド
* add_compile_optionsコマンド
*: プロジェクト全体に対してコンパイルオプションを設定してしまうため、以下に示すような問題が発生する可能性がある。
** 意図しないターゲットへの影響
**: プロジェクト内の全てのターゲットに対してコンパイルオプションが設定されるため、意図しないターゲットにも影響を及ぼす。
** ビルド依存性の管理が難しくなる
**: 特定のターゲットにのみ必要なコンパイルオプションがプロジェクト全体に設定されると、ビルド依存性の管理が複雑になる。
** コンパイラの最適化への影響
**: 不要なコンパイルオプションが設定されると、コンパイラの最適化が阻害される可能性がある。
*: 代わりに、<code>target_compile_options</code>コマンドを使用する必要がある。
<br>
<br>
* link_directoriesコマンド
* link_directoriesコマンド
*: プロジェクト内の全てのターゲットに対してリンクディレクトリを追加するため、以下に示すような問題が発生する可能性がある。
** プロジェクト全体への影響
**: 意図しないターゲットにもリンクディレクトリが設定される可能性がある。
** ビルド依存性の管理が難しくなる
**: 特定のターゲットにのみ必要なリンクディレクトリがプロジェクト全体に設定されると、ビルド依存性の管理が複雑になる。
** リンク順序の問題
**: このコマンドで追加したディレクトリは、自動的にコマンドラインのリンカ引数の最後に追加される。
**: これにより、リンク順序に関する問題が発生する可能性がある。
*: 代わりに、<code>target_link_libraries</code>コマンドを使用する必要がある。
<br>
<br>
* link_librariesコマンド
* link_librariesコマンド
*: プロジェクト内の全てのターゲットに対してリンクライブラリを追加するため、以下に示すような問題が発生する可能性がある。
** プロジェクト全体への影響
**: 意図しないターゲットにもリンクライブラリが設定される可能性がある。
** ビルド依存性の管理が難しくなる
**: 例えば、特定のターゲットにのみ必要なライブラリがプロジェクト全体にリンクされると、ビルド依存性の管理が複雑になる。
** リンク順序の問題
**: このコマンドで追加したライブラリは、自動的にコマンドラインのリンカ引数の最後に追加される。
**: これにより、リンク順序に関する問題が発生する可能性がある。
*: 代わりに、<code>target_link_libraries</code>コマンドを使用する必要がある。
<br>
<br>
* キャッシュ変数には、必ず接頭辞を付加する
* キャッシュ変数には、必ず接頭辞を付加する
128行目: 167行目:
  endif()
  endif()
  </syntaxhighlight>
  </syntaxhighlight>
<br><br>
== 実行ファイルの構築 (add_executableコマンド) ==
<code>add_executable</code>コマンドは、CMakeにソースファイルのセットから実行ファイルを作成する。<br>
<syntaxhighlight lang="cmake">
add_executable(
    <ターゲット名>
    <ソースコードファイル名 1>
    <ソースコードファイル名 2>
    # ...略
)
# 例. myAppまたはmyApp.exeという名前の実行ファイルが生成される
add_executable(
    myApp
    main.cpp
)
</syntaxhighlight>
<br>
<code><ターゲット名></code>には、英数字、アンダースコア、ハイフンを使用することができる。<br>
CMakeプロジェクトのビルドが正常に終了すると、<code><ターゲット名></code>として実行ファイルが作成される。<br>
<br>
ターゲット名は、CMakeの機能であるターゲットプロパティでカスタマイズすることもできる。<Br>
また、ターゲット名を変更して、<code>add_executable</code>コマンドを複数回呼び出すことにより、1つのCMakeLists.txtファイル内で複数の実行ファイルを定義することができる。<br>
<br>
ただし、同じターゲット名を複数の<code>add_executable</code>コマンドで使用する場合は、CMakeは失敗してエラーがハイライトされる。<br>
<br>
<syntaxhighlight lang="cmake">
# CMakeプロジェクトの例
cmake_minimum_required(VERSION 3.2)
# C++コンパイラは未使用とするため、プラットフォームが持っていない場合に備えて、projectコマンドで使用されないように指定する
project(MyApp VERSION 4.7.2 LANGUAGES C)
# メインの実行ファイルを生成
add_executable(
    mainTool
   main.c
   debug.c # リリースビルドのために最適化される
)
# サブの実行ファイルの生成
add_executable(
    testTool
    testTool.c
)
</syntaxhighlight>
<br><br>
== ライブラリの構築 (add_libraryコマンド) ==
CMakeは様々な種類のライブラリのビルドをサポートしている。<br>
ライブラリを作成して使用する場合、<code>add_library</code>コマンドを使用する。<br>
<syntaxhighlight lang="cmake">
add_library(
    <ターゲット名>
    [<STATIC または SHARED または MODULE>]
    [EXCLUDE_FROM_ALL]
    <ソースコードファイル名 1>
    <ソースコードファイル名 2>
    # ...略
)
</syntaxhighlight>
<br>
<code><ターゲット名></code>は、CMakeLists.txtファイル内でライブラリを参照するために使用される。<br>
ビルドされたライブラリ名は、<code><ターゲット名></code>となる。<br>
<br>
<code>EXCLUDE_FROM_ALL</code>オプションは、<code>add_executable</code>コマンドと同様、ライブラリがデフォルトのALLターゲットに含まれないようにする。<br>
構築するライブラリの種類は、<code>STATIC</code>、<code>SHARED</code>、<code>MODULE</code>のうちの1つを指定する。<br>
<br>
* STATICオプション
*: 静的ライブラリまたはアーカイブを指定する。
*: Windowsでは、デフォルトのライブラリ名は、<u><ライブラリファイル名>.lib</u>となる。
*: Linuxでは、デフォルトのライブラリ名は、<u>lib<ライブラリファイル名>.a</u>となる。
* SHARED
*: 共有ライブラリまたは動的ライブラリを指定する。
*: Windowsでは、デフォルトのライブラリ名は、<u><ライブラリファイル名>.dll</u>となる。
*: Linuxでは、デフォルトのライブラリ名は、<u>lib<ライブラリファイル名>.so</u>となる。
* MODULE
*: 共有ライブラリに似ているが、ライブラリや実行ファイルに直接リンクされるのではなく、実行時に動的にロードされることを意図しているライブラリを指定する。
*: これらは、ユーザがロードするかどうかを選択できるプラグイン、または、オプションのコンポーネントである。
*: Windowsでは、DLL向けのインポートライブラリは作成されない。
<br>
よほどのことがない限り、<code>STATIC</code>または<code>SHARED</code>オプションは、それが必要であることが分かるまで付加しないことを推奨する。<br>
これにより、プロジェクト全体を通して、スタティックライブラリかダイナミックライブラリかをより柔軟に選択することができる。<br>
<br>
ビルドするライブラリの種類を定義するオプションを省略することも可能である。<br>
特定のライブラリが必要でない限り、プロジェクトファイルには指定せずに、プロジェクトの構築時に開発者が選択できるようにすることが望ましい。<br>
そのような場合、ライブラリは<code>STATIC</code>か<code>SHARED</code>のどちらかになり、変数<code>BUILD_SHARED_LIBS</code>の値により選択される。<br>
<br>
変数<code>BUILD_SHARED_LIBS</code>が<code>true</code>を代入する場合はライブラリのターゲットはダイナミックライブラリ、それ以外の場合はスタティックライブラリとなる。<br>
<code>add_library</code>コマンドを呼び出すたびに変更する必要がなく、1ヶ所に記述するだけで設定を変更することができる。<br>
ただし、<code>add_library</code>コマンドを呼び出す前に、変数<code>BUILD_SHARED_LIBS</code>を記述する必要がある。<br>
<syntaxhighlight lang="cmake">
set(BUILD_SHARED_LIBS YES)
</syntaxhighlight>
<br>
変数<code>BUILD_SHARED_LIBS</code>を設定する方法として、<code>cmake</code>コマンドに<code>-DBUILD_SHARED_LIBS</code>オプションを付加する方法がある。<br>
cmake -DBUILD_SHARED_LIBS=YES /path/to/source
<br><br>
<br><br>


326行目: 267行目:
<br>
<br>
qmakeもCMakeも制御構文を持ち複雑なプロジェクトの作成も可能であるが、プロジェクトでの採用検討という視点から将来性も含めて考慮した場合、CMakeの方が有力である。<br>
qmakeもCMakeも制御構文を持ち複雑なプロジェクトの作成も可能であるが、プロジェクトでの採用検討という視点から将来性も含めて考慮した場合、CMakeの方が有力である。<br>
<br><br>
== set(CMAKE_AUTORCC ON)コマンド ==
このコマンドは、CMakeの機能の一部であり、Qtプロジェクトで特によく使用される。<br>
ただし、この機能はQtプロジェクトの開発のために設計されている。<br>
<br>
この機能は比較的新しく、CMake 3.9以降で導入された。<br>
<br>
変数<code>CMAKE_AUTORCC</code>を有効にする場合、CMakeは、Qtのqrcファイルを自動的にコンパイルすることができる。<br>
qrcファイルは、アプリケーションにバイナリリソース (画像、アイコン、翻訳ファイル等) を埋め込むために使用される。<br>
<br>
* CMakeの機能
*: 変数<code>CMAKE_AUTORCC</code>は、CMakeに組み込まれた変数である。
*: CMakeはQtに限らず、多くのプロジェクトタイプをサポートする汎用的なビルドシステムジェネレータである。
* Qtの統合
*: CMakeはQtプロジェクトとの統合を強化するために、この機能を提供している。
*: Qtのリソースコンパイラ (RCC) と連携して動作する。
* 他のフレームワークでの使用
*: RCCと同様のリソース処理システムを持つ他のフレームワークでも使用できる可能性があるが、実際にはQt以外での使用は一般的ではない。
<br>
Qtプロジェクトでqrcファイルを使用する場合、変数<code>CMAKE_AUTORCC</code>を有効にすることが推奨されている。<br>
* 自動リソース処理
*: CMakeが自動的にqrcファイルを検出し、必要なリソースコンパイル (rcc) ステップを実行する。
* ビルドプロセスの簡素化
*: 手動でリソースファイルの処理を記述する必要がなくなる。
* 依存関係の管理
*: リソースファイルが変更された場合、CMakeが自動的に再ビルドを行う。
<br>
ただし、以下に示すような場合は、変数<code>CMAKE_AUTORCC</code>を使用しない場合もある。<br>
これらのケースでは、<code>qt_add_resources()</code>コマンドを使用して手動で処理を行うことができる。<br>
* より細かな制御が必要な場合
* 特定のqrcファイルのみを処理したい場合
* パフォーマンス上の理由で手動処理を行う場合
<br>
したがって、多くの場合は<code>set(CMAKE_AUTORCC ON)</code>コマンドを実行することにより、qrcファイルの処理が簡単になる。<br>
<br><br>
== set(CMAKE_AUTOMOC ON)コマンド ==
変数<code>CMAKE_AUTOUIC</code>は、CMakeにおいてQt User Interface Compiler (UIC) の自動実行を制御するための設定である。<br>
<br>
変数<code>CMAKE_AUTOUIC</code>は、Qt開発を効率化するための重要な機能の1つである。<br>
Qt Designerで作成された.uiファイルを自動的にコンパイルして、対応するC++ヘッダファイルを生成する。<br>
これにより、UIファイルの変更が自動的にビルドプロセスに反映される。<br>
<br>
多くの場合、この変数を有効にすることで、UIファイルの処理に関する手間を大幅に削減することができる。<br>
<br>
Qtコンソールアプリケーションの場合は、GUIを持たないため、.uiファイルを使用しない。<br>
したがって、この変数の設定は不要である。<br>
<br>
この機能は、CMake 2.8.11以降で利用可能である。<br>
<br>
* 目的
*: QtのUIファイル (.ui) を自動的に処理して、対応するヘッダファイルを生成する。
* 動作
*: 変数<code>CMAKE_AUTOUIC</code>を有効にする時、CMakeはプロジェクト内の.uiファイルを自動的に検出して、UICを実行してヘッダファイルを生成する。
*: 生成されたファイルは、一般的に、ビルドディレクトリに配置される。
* 利点
*: 手動でUICの実行を設定する必要がなくなり、ビルドプロセスが簡素化される。
*: UIファイルが変更された場合、自動的に再処理される。
* 対象ファイル
*: プロジェクト内の全ての.uiファイルが処理の対象となる。
* 関連する変数
*: CMAKE_AUTOUIC_SEARCH_PATHS : UICが.uiファイルを検索するパスを指定する。
*: CMAKE_AUTOUIC_OPTIONS : UICに渡す追加オプションを指定する。
* パフォーマンス
*: 大規模プロジェクトでは、自動処理が若干のビルド時間の増加をもたらす可能性がある。
<br>
変数<code>CMAKE_AUTOUIC</code>を無効にする場合、<code>qt_wrap_ui()</code>コマンドを使用して手動で.uiファイルを処理することもできる。<br>
<br>
また、Qtプロジェクトによっては、特定のUIファイルのみを処理したい場合がある。<br>
その場合は、この変数<code>CMAKE_AUTOUIC</code>を無効にして手動で制御することも可能である。<br>
<br>
<u>※注意</u><br>
<u>変数<code>CMAKE_AUTOUIC</code>は、Qt Widgetベースのアプリケーションで使用される.uiファイル (XML形式) を処理するためのものである。</u><br>
<u>QMLは独自の宣言的UIフォーマットを使用して、.qmlファイルで定義される。</u><br>
<u>したがって、QMLを使用したプロジェクトでは、この変数<code>CMAKE_AUTOUIC</code>の設定は不要である。</u><br>
<br><br>
== set(CMAKE_AUTOMOC ON)コマンド ==
変数<code>CMAKE_AUTOMOC</code>は、CMakeにおいてQt Meta-Object Compiler (MOC) の自動実行を制御するための重要な設定である。<br>
<br>
<u>この変数は、ほとんどのQtプロジェクトで必須の設定である。</u><br>
Qtのメタオブジェクトシステムに必要なメタデータを生成するために、MOCを自動的に実行する。<br>
これにより、開発者はQtの高度な機能 (シグナル / スロット、プロパティシステム等) を簡単に利用できるようになり、同時にビルドプロセスも自動化される。<br>
<br>
この機能はCMake 2.8.6以降で利用可能である。<br>
<br>
* 動作
*: 変数<code>CMAKE_AUTOMOC</code>を有効にする時、CMakeはプロジェクト内のQtクラス (<code>Q_OBJECT</code>マクロを使用しているクラス等) を自動的に検出して、
*: 必要に応じてMOCを実行する。
* 処理対象
** Q_OBJECTマクロを含むヘッダファイル
** シグナルやスロットを使用しているクラス
** プロパティシステムを使用しているクラス
** その他のQt固有の機能をC++で使用する場合
* メリット
** 手動でMOCの実行を設定する必要がなくなり、開発プロセスが簡素化される。
** ソースファイルの変更時に自動的にMOC処理が行われる。
* 生成ファイル
*: moc_*.cppファイルがビルドディレクトリに生成される。
* 関連する変数
** <code>CMAKE_AUTOMOC_MACRO_NAMES</code>
**: 追加のマクロ名を指定して、MOC処理の対象を拡張できる。
** <code>CMAKE_AUTOMOC_PATH_PREFIX</code>
**: 生成されるmocファイルのパスプレフィックスを設定する。
*  パフォーマンスへの影響
*: 大規模プロジェクトでは、ビルド時間が若干増加する可能性がある。
* デバッグ
*: 変数<code>CMAKE_AUTOMOC_VERBOSE</code>を有効にする時、MOC処理の詳細なログが出力され、問題のデバッグに役立つ。
* QtとC++の統合
*: この変数を有効にすることにより、QtのメタオブジェクトシステムとC++のコードがシームレスに統合される。
<br>
また、特定のファイルのみMOCを処理をしたい場合は、変数<code>CMAKE_AUTOMOC</code>を無効にして、<code>qt_wrap_cpp()</code>コマンドを使用して手動で制御できる。<br>
<br>
<u>※注意</u><br>
<u>プリコンパイル済みヘッダ (PCH、GCH等) を使用する場合、追加の設定が必要になることがある。</u><br>
<br><br>
<br><br>


351行目: 408行目:
  </syntaxhighlight>
  </syntaxhighlight>
<br><br>
<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__
__FORCETOC__
[[カテゴリ:Qt]]
[[カテゴリ:Qt]]
「http://mochiuwiki.e2.valueserver.jp/index.php?title=Qtの設定_-_CMake」から取得