vcpkg_msbuild_install

[アーティクル]
01/10/2024

MSBuild プロジェクトをビルドしてインストールします。

この関数が vcpkg_install_msbuild置き換えられます。

vcpkg_msbuild_install は、CMake ツールチェーンビルドフラグを含む props ファイルとターゲットファイルを生成し、 /p:ForceImportAfterCpp(Props|Targets)

使用方法

vcpkg_install_msbuild(
    SOURCE_PATH <${SOURCE_PATH}>
    PROJECT_SUBPATH <port.sln>
    [ADD_BIN_TO_PATH]
    [NO_INSTALL]
    [NO_TOOLCHAIN_PROPS]
    [CLEAN]
    [RELEASE_CONFIGURATION <Release>]
    [DEBUG_CONFIGURATION <Debug>]
    [TARGET <Build>]
    [PLATFORM <Win32>]
    [OPTIONS </p:ZLIB_INCLUDE_PATH=X>...]
    [OPTIONS_RELEASE </p:ZLIB_LIB=X>...]
    [OPTIONS_DEBUG </p:ZLIB_LIB=X>...]
    [DEPENDENT_PKGCONFIG <zlib>]
    [ADDITIONAL_LIBS <getopt.lib>]
    [ADDITIONAL_LIBS_DEBUG <zlibd.lib>]
    [ADDITIONAL_LIBS_RELEASE <zlib.lib>]
)

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

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

パラメーター

SOURCE_PATH

ソースツリーのルートへのパス。

MSBuild ではソース内ビルドが使用されるため、ソースツリーはビルドの一時的な場所にコピーされます。このパラメーターは、そのコピーのベースであり、すべてのXYZ_SUBPATHオプションのベースを形成します。

PROJECT_SUBPATH

ソリューション () またはプロジェクト.vcxproj (.sln) ファイルの相対パスSOURCE_PATH。

ADD_BIN_TO_PATH

ビルドの前に、構成依存バイナリパスを PATH 環境変数に追加します。これは、プロジェクト自体によってビルドされたツールを実行するために必要です。環境変数は PATH 、次の場合 VCPKG_CROSSCOMPILING は変更されません。 true

NO_TOOLCHAIN_PROPS

cmake を使用してツールチェーンプロパティを生成しないでください。これにより、vcpkg 統合が自動的に無効になります。

NO_INSTALL

.lib|を自動的にインストールしないでください。dll|.pdb|.ビルドディレクトリに見つかった exe ファイル。

きれい

インストール後に中間ファイルを削除する必要があることを示します。

RELEA Standard Edition_CONFIGURATION

リリースビルドに使用される構成 (/p:Configuration msbuild パラメーター)。既定値は次のとおりです。 Release

DEBUG_CONFIGURATION

デバッグビルドに使用される構成 (/p:Configuration msbuild パラメーター)。既定値は次のとおりです。 Debug

TARGET

ビルドする MSBuild ターゲット (/t:<TARGET>)。既定値は次のとおりです。 Rebuild

プラットフォーム

ビルドに使用されるプラットフォーム (/p:Platform msbuild パラメーター)。

これは、次の値を作成するときに Visual Studio で使用される既定値への値マッピング VCPKG_TARGET_ARCHITECTURE に既定で .vcxproj設定されます。

x86 は Win32 になります。
x64 は x64 になります
arm は ARM になります
arm64 は arm64 になります。

ではなく a .vcxprojを.sln渡す場合、ソリューションで使用されるプラットフォーム文字列と一致するように${VCPKG_TARGET_ARCHITECTURE}設定し直す必要がある場合があります。

OPTIONS

すべてのビルドの MSBuild に渡す追加のオプション。

OPTIONS_RELEAStandard Edition

リリースビルド用に msbuild に渡される追加のオプション。これらに加えて OPTIONS.

OPTIONS_DEBUG

デバッグビルド用に msbuild に渡される追加のオプション。これらに加えて OPTIONS.

DEPENDENT_PKGCONFIG

ビルドに追加する依存関係の pkg-config 一覧。これにより、必要なすべてのビルドフラグ (インクルード/定義/ライブラリ) がビルドプロパティに追加されます。

ADDITIONAL_LIBS

プロジェクトに追加する追加のライブラリ。

ADDITIONAL_LIBS_DEBUG

リリースビルド用に msbuild に追加する追加のライブラリ。これらに加えて ADDITIONAL_LIBS.

ADDITIONAL_LIBS_RELEAStandard Edition

デバッグビルド用に msbuild に追加する追加のライブラリ。これらに加えて ADDITIONAL_LIBS.

ソース

ports/vcpkg-msbuild/vcpkg_msbuild_install.cmake

次の方法で共有