Articles

cmake(1)Options

by admin

オプション-S <path-to-source>

ビルドするCMakeプロジェクトのルートディレクトリへのパス。CMakeがビルドディレクトリのルートとして使用するディレクトリへのパス。

-B <path-to-build>

CMakeがビルドディレクトリのルートとして使用するディレディレクトリがまだ存在しない場合、CMakeはそれを行います。

-C <initial-cache>

キャッシュを設定するスクリプトを事前にロードします。CMakeが空のビルドツリーで最初に実行されると、CMakeCache.txtファイルが作成され、プロジェクトのカスタマイズ可能な設定が設定されます。 このオプションは、プロジェクトのscmake listfilesを最初に通過する前にキャッシュエントリをロードするファイルを指定するために使用できます。 ロードされたエントリは、プロジェクトのデフォルト値よりも優先されます。 指定されたファイルは、acache形式のファイルではなく、set()オプションを使用するCMake scriptcontainingCACHEコマンドでなければなりません。

スクリプト内のCMAKE_SOURCE_DIRCMAKE_BINARY_DIRへの参照は、トップレベルのソースとビルドツリーに評価されます。CMakeを作成または更新します。CACHEエントリ。CMakeが空のビルドツリーで最初に実行されると、CMakeCache.txtCACHEエントリに対して実行できます。

:<type>set()CACHE:<type>部分が省略されている場合、エントリは型が既に存在しない場合、型なしで作成されます。 プロジェクトのacommandがタイプをPATHFILEPATH<value>は絶対パスに変換されます。

このオプションは、単一の引数として指定することもできます:-D<var>:<type>=<value>-D<var>=<value>。CMakeから一致するエントリを削除します。CACHECMakeCache.txt*?aresupportedを使用して式をグロブするために使用できます。 このオプションは、必要な数だけCACHECMakeCache.txt非動作にすることができます。

-G <generator-name>

ビルドシステムジェネレータを指定します。

CMakeは、特定のplatforms上で複数のネイティブビルドシステムをサポートすることがあります。 発電機は、特定の生成を担当しますビルドシステム。 可能なジェネレータ名は、cmake-generators(7)マニュアルで指定されています。

指定されていない場合、CMakeはCMAKE_GENERATORenvironmentvariableをチェックし、それ以外の場合は組み込みのデフォルト選択にフォールバックします。

-T <toolset-spec>

サポートされている場合は、ジェネレータのツールセット仕様。

一部のCMakeジェネレータは、ネイティブビルドシステムにコンパイラの選択方法を伝えるツールセット仕様をサポートしています。 詳細については、CMAKE_GENERATOR_TOOLSET変数を参照してください。

-A <platform-name>

ジェネレータでサポートされている場合は、プラットフォーム名を指定します。

いくつかのCMakeジェネレータは、コンパイラやSDKを選択するためにthenativeビルドシステムに与えられるプラットフォーム名をサポートしています。 詳細については、CMAKE_GENERATOR_PLATFORM変数を参照してください。

-Wno-dev

開発者の警告を抑制します。p>

CMakeLists.txtファイルの作成者向けの警告を抑制します。 デフォルトでは、これはまた、offdeprecation警告をオフにします。

-Wdev

開発者の警告を有効にします。p>

CMakeLists.txtファイルの作成者向けの警告を有効にします。 デフォルトでは、非推奨の警告もオンになります。

-Werror=dev

開発者の警告エラーを作成します。

CMakeLists.txtファイルエラーの作成者向けの警告を作成します。 デフォルトでは、これは非推奨の警告をエラーとしてオンにします。

-Wno-error=dev

開発者の警告はエラーではありません。

CMakeLists.txtファイルnoterrorsの作成者向けの警告を作成します。 デフォルトでは、これは非推奨の警告をエラーとしてオフにします。

-Wdeprecated

非推奨の機能警告を有効にします。CMakeLists.txtファイルの作成者にとって意味される非推奨の機能の使用に関する警告を有効にします。

-Wno-deprecated

非推奨の機能警告を抑制します。CMakeLists.txtファイルの作成者にとって意味される、非推奨の機能の使用に関する警告を抑制します。

CMakeLists.txtファイルの作成者にとって意味

-Werror=deprecated

非推奨のマクロと関数の警告エラーを作成します。CMakeLists.txtファイルの作成者にとって意味される非推奨のマクロと関数の使用に関する警告、エラーを作成します。

-Wno-error=deprecated

非推奨のマクロと関数の警告をエラーではないようにします。

非推奨のマクロと関数の使用に関する警告を作成します。CMakeLists.txtファイルの作成者のためのものであり、エラーではありません。

-L

非高度なキャッシュされた変数を一覧表示します。変数はCMakeを実行し、CMakeのすべての変数をリストしますCACHEINTERNALADVANCED。これにより、現在のCMake設定が効果的に表示され、-DAHが指定されている場合、各変数のヘルプも表示されます。p>-N

ビューモードのみ。

キャッシュのみをロードします。 実際にはconfigureとgeneratestepsを実行しないでください。依存関係のgraphvizを生成します。CMakeGraphVizOptionsCMakeGraphVizOptionsを参照してください。プロジェクト内のすべてのライブラリと実行可能な依存関係を含むgraphviz入力ファイルを生成します。 詳細については、CMakeGraphVizOptionsのドキュメントを参照してください。

--system-information

このシステムに関する情報をダンプします。

現在のシステムに関する幅広い情報をダンプします。 CMakeプロジェクトのバイナリツリーの先頭から実行すると、キャッシュ、ログファイルなどの追加情報がダンプされます。p>--log-level=<ERROR|WARNING|NOTICE|STATUS|VERBOSE|DEBUG|TRACE>

ログレベルを設定します。

message()STATUSです。CMakeの実行間にログレベルを維持するには、代わりにキャッシュ変数としてCMAKE_MESSAGE_LOG_LEVELを設定します。コマンドラインオプションと変数の両方が指定されている場合は、コマンドlineoptionが優先されます。

下位互換性の理由から、--loglevelはこのオプションのasynonymとしても受け入れられます。

--log-context

message()各メッセージに添付されたコンテキストを出力するコマンドを有効にします。

このオプションは、現在のCMake実行のコンテキストの表示をオンにしますonly.To 後続のすべてのCMake実行でコンテキストを永続的に表示するには、代わりにCMAKE_MESSAGE_CONTEXT_SHOWCMAKE_MESSAGE_CONTEXT_SHOWは無視されます。p>--debug-trycompile

try_compile()try_compile()でのみ有用です。

try_compile()呼び出し用に作成されたファイルとディレクトリを削除しないでください。 これは、失敗したtry_compilesのデバッグに便利です。 Try-compileの結果を古いジャンクとして変更すると、別のテストが誤って合格するか、失敗する可能性があります。 このオプションは、atime時に1回のtry-compileに使用するのが最適です。p>--debug-output

cmakeをデバッグモードにします。cmakeの実行中に、message(SEND_ERROR)呼び出しを使用してスタックトレースのように追加情報を出力します。

message(SEND_ERROR)呼び出しを使用して、cmakeの実行中にp>--debug-find

cmake findコマンドをデバッグモードにします。cmakeの実行中に追加のfind呼び出し情報をstandarderrorに出力します。 出力は人間の消費のために設計され、解析のために設計されていません。プロジェクトのよりローカルな部分をデバッグするためのCMAKE_FIND_DEBUG_MODE変数も参照してください。p>cmakeをトレースモードにします。

--trace

cmakeをトレースモードにします。

--trace

行われたすべての呼び出しとどこからのトレースを印刷します。p>cmakeをトレースモードにします。

--trace-expand

cmakeをトレースモードにします。

--trace-expandP>

--traceと同様ですが、変数が展開されています。p>--trace-format=<format>

cmakeをトレースモードにし、トレース出力形式を設定します。p>

<format>は、次のいずれかの値にすることができます。

human

人間が読める形式で各トレース行を出力します。 これはデフォルトの形式です。p>json-v1

各行を個別のJSONドキュメントとして出力します。 各ドキュメントは改行によって分離されます（\n）。 改行以外の文字がJSONドキュメント内に存在することが保証されています。メンバーは次のとおりです。

file

関数が呼び出されたCMakeソースファイルへのフルパス。p>line

関数呼び出しのfileの行。

defer

関数呼び出しがdeferredbyだったときに存在するオプションのメンバーcmake_language(DEFER)<id>を含むastringです。p>cmd

呼び出された関数の名前。

args

すべての関数パラメータの文字列リスト。p>time

関数呼び出しのタイムスタンプ（エポックからの秒）。

frame

呼び出された関数のスタックフレームの深さ。さらに、出力される最初のJSONドキュメントには、現在のメジャーおよびマイナーバージョンの

JSONトレース形式のversionキーが含:/p>

{ "version": { "major": 1, "minor": 1 }}

メンバーは次のとおりです。

version

JSON形式のバージョンを示します。 このバージョンでは、amajorとマイナーコンポーネントがセマンティックバージョンの規則に従っています。cmakeをトレースモードにしますが、指定されたファイルの行のみを出力します。

複数のオプションを使用できます。p>--trace-redirect=<file>

cmakeをトレースモードにし、トレース出力をstderrの代わりにファイルにリダイレクトします。

--warn-uninitialized

初期化されていない値について警告します。

初期化されていない変数が使用されたときに警告を表示します。p>--warn-unused-vars

何もしません。 CMakeバージョン3.2以下では、この変数についての警告が有効になっていました。 CMakeバージョン3.3から3.18では、オプションは次のとおりでしたbroken.In CMake3.19以上のオプションは削除されました。

--no-warn-unused-cli

コマンドラインオプションについて警告しないでください。

コマンドラインで宣言されているが、使用されていない変数は見つかりません。p>--check-system-vars

システムファイル内の変数の使用に関する問題を見つけます。通常、未使用および初期化されていない変数は、CMAKE_SOURCE_DIRCMAKE_BINARY_DIRでのみ検索されます。このフラグは、他のファイルについても警告するようにCMakeに指示します。p>--profiling-output=<path>

--profiling-formatと組み合わせて使用され、指定されたパスに出力します。P>--profiling-format=<file>

指定された形式でCMakeスクリプトのプロファイリングデータの出力を有効にします。

これは、実行されたCMakeスクリプトのパフォーマンス分析に役立ちます。 Third partyapplicationsは、出力を人間が読める形式に処理するために使用する必要があります。現在サポートされている値は次のとおりです。google-traceGoogle Chromeのabout:tracingタブまたはTraceCompassのようなツールのプラグインを使用して解析できるGoogle Trace形式の出力。p>--preset <preset>--preset=<preset>

は、<path-to-source>/CMakePresets.json<path-to-source>/CMakeUserPresets.jsonpresetを読み取ります。 プリセットは、generatorとビルドディレクトリ、およびオプションでCMakeに渡す変数とその他の引数のリストを指定します。 現在の作業ディレクトリには、プリセットファイルが含まれている必要があります。 また、CMakePresets.jsonCMakeUserPresets.jsoncmake-presets(7)を参照してください。

プリセットは、他のすべてのコマンドラインオプションの前に読み込まれます。 プリセットによって指定されたオプション（変数、ジェネレータなど）。)コマンドラインで手動で指定することで、すべて上書きできます。 たとえば、プリセットがMYVAR12-D2は次のようになります。好ましい。

--list-presets, --list-presets=<>

使用可能なプリセットを一覧表示します。 オプションが指定されていない場合は、configure presetswillのみが一覧表示されます。 現在の作業ディレクトリには、CMakeプリセットファイルが含まれている必要があります。