MacOS下vcpkg自定义库缺失Release版静态文件问题排查

要让vcpkg同时构建并安装Debug和Release版本的mylib，需修改portfile.cmake中的关键配置，具体步骤如下：

1. 移除硬编码的Debug构建类型 #

如果你的portfile里存在set(CMAKE_BUILD_TYPE Debug)这类强制指定构建类型的代码，必须删除。vcpkg会根据安装目标自动传递对应构建类型参数，硬编码会导致仅生成Debug版本。

正确的vcpkg_cmake_configure调用示例：

vcpkg_cmake_configure(
    SOURCE_PATH "${SOURCE_PATH}"
    OPTIONS
        # 这里添加库所需的其他配置选项，例如-DMYLIB_ENABLE_FEATURE=ON
)

2. 构建阶段指定全配置 #

在vcpkg_cmake_build步骤中，显式声明要构建Debug和Release两个版本，避免仅构建Debug：

vcpkg_cmake_build(
    BUILD_TARGET ALL
    CONFIGURATION_RELEASE Release
    CONFIGURATION_DEBUG Debug
)

若无需额外参数，也可直接使用默认调用，vcpkg会自动处理多配置构建：

vcpkg_cmake_build()

3. 安装阶段覆盖全配置 #

确保vcpkg_cmake_install同时安装两个版本的产物：

vcpkg_cmake_install(
    CONFIGURATION_RELEASE Release
    CONFIGURATION_DEBUG Debug
)

只要mylib自身的CMakeLists.txt中install(TARGETS)指令未限制配置，CMake会自动将对应版本的库安装到vcpkg的指定目录。

4. 检查原库的安装规则 #

确认mylib自身的CMakeLists.txt中，静态库的安装规则未限定仅Debug版本：

# 正确写法：无配置限制，安装所有构建类型的库
install(
    TARGETS mylib
    ARCHIVE DESTINATION lib
)

# 错误写法：仅安装Debug版本
install(
    TARGETS mylib
    ARCHIVE DESTINATION lib
    CONFIGURATIONS Debug
)

若原库存在上述错误，需修改其CMakeLists.txt，或在portfile的OPTIONS中添加参数覆盖该限制。

5. 清理并重新安装 #

修改完成后，执行以下命令清理旧产物并重新安装：

vcpkg remove mylib --clean
vcpkg install mylib --triplet x64-osx

完成以上操作后，vcpkg_installed/x64-osx/lib目录下即可生成Release版本的libmylib.a静态库。

内容的提问来源于stack exchange，提问作者Source