次の方法で共有

vcpkg_cmake_configure

  • [アーティクル]

CMake ベースのプロジェクトを構成します。

使用方法

vcpkg_cmake_configure(
    SOURCE_PATH <source-path>
    [DISABLE_PARALLEL_CONFIGURE]
    [NO_CHARSET_FLAG]
    [WINDOWS_USE_MSBUILD]
    [GENERATOR <generator>]
    [LOGFILE_BASE <logname-base>]
    [OPTIONS
        <configure-setting>...]
    [OPTIONS_RELEASE
        <configure-setting>...]
    [OPTIONS_DEBUG
        <configure-setting>...]
    [MAYBE_UNUSED_VARIABLES
        <option-name>...]
)

この関数を使用するには、ヘルパー ポートの vcpkg-cmakeに依存する必要があります。

"dependencies": [
  {
    "name": "vcpkg-cmake",
    "host": true
  }
]

パラメーター

SOURCE_PATH

CMakeLists.txtを含むディレクトリを指定します。

通常、この値は、 vcpkg_from_github()などのソース取得コマンドを呼び出した結果として取得されます。

DISABLE_PARALLEL_CONFIGURE

CMake 構成ステップの並列実行を無効にします。

既定では、vcpkg はソース ディレクトリへの書き戻しを無効にし (文書化されていない CMake フラグ CMAKE_DISABLE_SOURCE_CHANGESを使用して)、Release と Debug を並列で構成します。 このフラグは、ソース ディレクトリの書き込みを許可し、構成手順を順番に実行するように vcpkg に指示します。

NO_CHARSET_FLAG

組み込みの Windows ツールチェーンを使用する場合、/utf-8の受け渡しを無効にします。

これは、MSVC をターゲットにするときに独自のソース コードの文字セットを設定するライブラリに必要です。 詳細については、/utf-8のMSVC ドキュメントを参照してください。

WINDOWS_USE_MSBUILD

Windows プラットフォームを対象とする場合は、別のジェネレーターの代わりに MSBuild を使用します。

既定では、vcpkg は、すべてのプラットフォームの CMake ジェネレーターとして Ninja を使用することを好みます。 ただし、MSBuild の動作が Ninja とは異なるエッジ ケースがあります。 このフラグは、プロジェクトで MSBuild を正しくビルドする必要がある場合にのみ渡す必要があります。 このフラグは MinGW ターゲットには影響しません。

ジェネレータ

使用する CMake ジェネレーターを指定します。

既定では、vcpkg では、すべてのプラットフォームで CMake ジェネレーターとして Ninja を使用し、Ninja を使用できない場合は Windows 以外のプラットフォームの場合は "Unix Makefiles" を使用します。 このパラメーターは、プロジェクト固有のビルドシステムが特定のジェネレーターに依存するエッジ ケースに使用できます。

LOGFILE_BASE

構成ログの代替ルート名。

既定値は config-${TARGET_TRIPLET} です。 パス区切り記号は含めないようにしてください。 パターンに一致するログが生成されます ${CURRENT_BUILDTREES_DIR}/${LOGFILE_BASE}-<suffix>.log

[オプション (オプション)]

構成中に CMake に渡す追加のオプション。

「 Implicit オプション」も参照してください。

OPTIONS_RELEASE

リリース構成中に CMake に渡す追加のオプション。

これらは、 OPTIONSに加えてあります。

OPTIONS_DEBUG

デバッグ構成中に CMake に渡す追加のオプション。

これらは、 OPTIONSに加えてあります。

MAYBE_UNUSED_VARIABLES

構成手順中に読み取られない可能性がある CMake オプションの一覧。

vcpkg は、CMake 構成手順中に読み取られないオプションについて、このリストの外部にあるオプションについて警告します。 この一覧には、特定の構成中にのみ読み取るオプション ( VCPKG_LIBRARY_LINKAGE が "static" されたときや、特定の機能が有効になっている場合など) が含まれている必要があります。

暗黙的なオプション

このコマンドは、CMake にいくつかのオプションを自動的に提供します。

このコマンドは、 VCPKG_CMAKE_CONFIGURE_OPTIONS のすべてのオプションと、 VCPKG_CMAKE_CONFIGURE_OPTIONS_RELEASE または VCPKG_CMAKE_CONFIGURE_OPTIONS_DEBUGから構成固有のオプションも渡します。

最後に、依存すべきではない追加の内部オプションが渡されます ( VCPKG_ プレフィックスを使用)。

例

vcpkg_from_github(OUT_SOURCE_PATH source_path ...)
vcpkg_cmake_configure(
    SOURCE_PATH "${source_path}"
    OPTIONS
        -DBUILD_EXAMPLES=OFF
        -DBUILD_TESTS=OFF
)
vcpkg_cmake_install()

例については、microsoft/vcpkg を検索してください

解説

このコマンドは、 vcpkg_configure_cmake()を置き換えます。

ソース

ports/vcpkg-cmake/vcpkg_cmake_configure.cmake