# vcpkg_install_msbuild Build and install an msbuild-based project. This replaces `vcpkg_build_msbuild()`. ## Usage ```cmake vcpkg_install_msbuild( SOURCE_PATH <${SOURCE_PATH}> PROJECT_SUBPATH [INCLUDES_SUBPATH ] [LICENSE_SUBPATH ] [RELEASE_CONFIGURATION ] [DEBUG_CONFIGURATION ] [TARGET ] [TARGET_PLATFORM_VERSION <10.0.15063.0>] [PLATFORM <${TRIPLET_SYSTEM_ARCH}>] [PLATFORM_TOOLSET <${VCPKG_PLATFORM_TOOLSET}>] [OPTIONS ...] [OPTIONS_RELEASE ...] [OPTIONS_DEBUG ...] [USE_VCPKG_INTEGRATION] [ALLOW_ROOT_INCLUDES | REMOVE_ROOT_INCLUDES] ) ``` ## Parameters ### SOURCE_PATH The path to the root of the source tree. Because MSBuild uses in-source builds, the source tree will be copied into a temporary location for the build. This parameter is the base for that copy and forms the base for all XYZ_SUBPATH options. ### USE_VCPKG_INTEGRATION Apply the normal `integrate install` integration for building the project. By default, projects built with this command will not automatically link libraries or have header paths set. ### PROJECT_SUBPATH The subpath to the solution (`.sln`) or project (`.vcxproj`) file relative to `SOURCE_PATH`. ### LICENSE_SUBPATH The subpath to the license file relative to `SOURCE_PATH`. ### INCLUDES_SUBPATH The subpath to the includes directory relative to `SOURCE_PATH`. This parameter should be a directory and should not end in a trailing slash. ### ALLOW_ROOT_INCLUDES Indicates that top-level include files (e.g. `include/zlib.h`) should be allowed. ### REMOVE_ROOT_INCLUDES Indicates that top-level include files (e.g. `include/Makefile.am`) should be removed. ### RELEASE_CONFIGURATION The configuration (``/p:Configuration`` msbuild parameter) used for Release builds. ### DEBUG_CONFIGURATION The configuration (``/p:Configuration`` msbuild parameter) used for Debug builds. ### TARGET_PLATFORM_VERSION The WindowsTargetPlatformVersion (``/p:WindowsTargetPlatformVersion`` msbuild parameter) ### TARGET The MSBuild target to build. (``/t:``) ### PLATFORM The platform (``/p:Platform`` msbuild parameter) used for the build. ### PLATFORM_TOOLSET The platform toolset (``/p:PlatformToolset`` msbuild parameter) used for the build. ### OPTIONS Additional options passed to msbuild for all builds. ### OPTIONS_RELEASE Additional options passed to msbuild for Release builds. These are in addition to `OPTIONS`. ### OPTIONS_DEBUG Additional options passed to msbuild for Debug builds. These are in addition to `OPTIONS`. ## Examples * [libimobiledevice](https://github.com/Microsoft/vcpkg/blob/master/ports/libimobiledevice/portfile.cmake) ## Source [scripts/cmake/vcpkg_install_msbuild.cmake](https://github.com/Microsoft/vcpkg/blob/master/scripts/cmake/vcpkg_install_msbuild.cmake)