vcpkg 构建包报错缺少 debug/share 目录
结论
这个报错的原因是 Debug 安装阶段没有把 ankicpp 的 CMake package 配置文件安装到 ${CURRENT_PACKAGES_DIR}/debug/share/ankicpp,vcpkg_cmake_config_fixup 因此找不到目标目录。vcpkg 不需要你手工创建这个空目录。优先修改上游 CMakeLists.txt 的 install 规则;如果只是本地打包验证,可以在 portfile.cmake 里把 release 的 share/ankicpp 临时复制到 debug/share/ankicpp,再调用 fixup。
debug/share 是做什么的
vcpkg 默认会构建 Debug 和 Release 两套产物,vcpkg_cmake_install() 会分别安装到包目录和包目录下的 debug 子目录。vcpkg_cmake_config_fixup 会处理 share/<pkg> 与 debug/share/<pkg> 下的 *Config.cmake、*Targets.cmake 等文件,修正其中的安装前缀和导入目标路径,避免 Debug 配置引用 Release 路径。debug/share/ankicpp 是 Debug 配置的暂存位置;如果缺失,fixup 就会报出你看到的错误。
解决步骤
1. 先检查 CMake 安装规则
确认项目会无条件安装 package config,不要只在 Release 或某个选项打开时才执行。示例结构如下,目标名和路径按你的项目调整:
include(CMakePackageConfigHelpers)
install(TARGETS ankicpp EXPORT ankicppTargets ...)
install(EXPORT ankicppTargets
FILE ankicppTargets.cmake
NAMESPACE ankicpp::
DESTINATION ${CMAKE_INSTALL_DATADIR}/ankicpp)
write_basic_package_version_file(
"${CMAKE_CURRENT_BINARY_DIR}/ankicppConfigVersion.cmake"
VERSION ${PROJECT_VERSION}
COMPATIBILITY SameMajorVersion)
configure_package_config_file(
"${CMAKE_CURRENT_SOURCE_DIR}/cmake/ankicppConfig.cmake.in"
"${CMAKE_CURRENT_BINARY_DIR}/ankicppConfig.cmake"
INSTALL_DESTINATION ${CMAKE_INSTALL_DATADIR}/ankicpp)
install(FILES
"${CMAKE_CURRENT_BINARY_DIR}/ankicppConfig.cmake"
"${CMAKE_CURRENT_BINARY_DIR}/ankicppConfigVersion.cmake"
DESTINATION ${CMAKE_INSTALL_DATADIR}/ankicpp)
如果这段 install 被 if(CMAKE_BUILD_TYPE STREQUAL "Release") 之类的条件包住,Debug 安装就不会生成 debug/share/ankicpp,fixup 也会失败。
2. 核对 portfile 里的 CONFIG_PATH
如果配置文件实际安装在 share/ankicpp,现有的 vcpkg_cmake_config_fixup(PACKAGE_NAME "ankicpp") 参数没问题,要解决的是 Debug 安装缺失。如果实际安装在 lib/cmake/ankicpp,则需要显式指定路径:
vcpkg_cmake_config_fixup(
PACKAGE_NAME "ankicpp"
CONFIG_PATH "lib/cmake/ankicpp"
)
不要盲目改 CONFIG_PATH,先用打包目录确认 share/ankicpp 或 lib/cmake/ankicpp 到底哪个存在。
3. 临时办法:复制 release 配置到 debug 目录
如果只是想先让 overlay port 构建通过,可以在 vcpkg_cmake_config_fixup 之前加一段复制逻辑。它只适用于 share/ankicpp 这种默认布局;如果配置在 lib/cmake/ankicpp,需要把路径同步换掉。
if(NOT EXISTS "${CURRENT_PACKAGES_DIR}/debug/share/ankicpp")
file(MAKE_DIRECTORY "${CURRENT_PACKAGES_DIR}/debug/share")
file(COPY "${CURRENT_PACKAGES_DIR}/share/ankicpp"
DESTINATION "${CURRENT_PACKAGES_DIR}/debug/share")
endif()
vcpkg_cmake_config_fixup(PACKAGE_NAME "ankicpp")
这段代码会生成缺失的 debug/share/ankicpp,并把 release 的 CMake 配置复制过去供 fixup 修正。不要只 file(MAKE_DIRECTORY ...) 建空目录。那样 fixup 可能不再报目录不存在,但最终包里仍然没有可用的 Debug 配置。
4. 清理后重试
改完 portfile 后,清掉旧的 buildtrees 和 packages,避免缓存干扰:
rm -rf buildtrees/ankicpp packages/ankicpp_x64-linux
vcpkg install ankicpp --overlay-ports=./ankicpp/custom-overlay
注意事项
- 优先修改上游
CMakeLists.txt,让 Debug 和 Release 都安装同一套 package config;复制目录只是打包阶段的备用办法。 - 如果项目根本不导出 CMake config,就不要调用
vcpkg_cmake_config_fixup,而应自己提供并安装ankicppConfig.cmake和ankicppTargets.cmake。 - 你 portfile 里的
file(TOUCH "${CURRENT_PACKAGES_DIR}/share/${PORT}/usage-accurate")不是 vcpkg 标准的 usage 文件名。若希望 vcpkg 展示用法,通常应把usage文件安装到share/${PORT}/usage,而不是创建usage-accurate。 - 静态库包同样可能需要 CMake config;
ONLY_STATIC_LIBRARY不会自动绕过 fixup。
备注:内容仅供参考。
