HarfBuzz项目CMake构建系统升级指南

背景介绍

HarfBuzz是一个开源的文本整形引擎，广泛用于各种操作系统和应用程序中处理复杂文字布局。随着CMake 3.28.1及以上版本的发布，项目构建系统需要进行相应升级以保持兼容性。

关键升级点

1. 新增CMake策略支持

在CMakeLists.txt文件开头添加以下策略声明，以启用对<PackageName>_ROOT环境变量的支持：

cmake_policy(SET CMP0144 NEW)

这一策略确保了在较新版本的CMake中能够正确识别第三方库的根目录环境变量。

2. 替换过时的include命令

将原有的include(Find<Package>)形式替换为现代CMake推荐的find_package()命令：

# 旧方式
include(FindFreetype)

# 新方式
find_package(Freetype REQUIRED)

这种改变带来了几个优势：

• 更好的包管理集成
• 更清晰的依赖关系声明
• 更一致的跨平台行为

构建系统改进细节

第三方库依赖处理

升级后的构建系统对第三方库的处理更加规范：

if(HB_HAVE_FREETYPE AND NOT TARGET freetype)
  find_package(Freetype REQUIRED)
  if(NOT FREETYPE_FOUND)
    message(FATAL_ERROR "HB_HAVE_FREETYPE已设置但未找到FreeType库")
  endif()
  
  list(APPEND THIRD_PARTY_LIBS ${FREETYPE_LIBRARIES})
  include_directories(AFTER ${FREETYPE_INCLUDE_DIRS})
  add_definitions(-DHAVE_FREETYPE=1)
endif()

构建目标定义

项目的主要构建目标定义也进行了优化：

add_library(harfbuzz ${project_sources} ${project_headers})
target_link_libraries(harfbuzz ${THIRD_PARTY_LIBS})
target_include_directories(harfbuzz PUBLIC
  "$<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/src>"
  "$<INSTALL_INTERFACE:${CMAKE_INSTALL_INCLUDEDIR}/harfbuzz>")

兼容性考虑

升级后的构建系统考虑了不同平台和编译器的特性：

if(UNIX OR MINGW OR VITA)
  include(CheckCXXCompilerFlag)
  CHECK_CXX_COMPILER_FLAG(-Bsymbolic-functions CXX_SUPPORTS_FLAG_BSYMB_FUNCS)
  if(CXX_SUPPORTS_FLAG_BSYMB_FUNCS)
    link_libraries(-Bsymbolic-functions)
  endif()
endif()

安装配置

安装规则也进行了现代化改造：

install(TARGETS harfbuzz
  EXPORT harfbuzzConfig
  ARCHIVE DESTINATION ${CMAKE_INSTALL_LIBDIR}
  LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
  RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
  FRAMEWORK DESTINATION Library/Frameworks
)

总结

通过对HarfBuzz项目CMake构建系统的升级，我们获得了：

1. 更好的现代CMake兼容性
2. 更清晰的依赖管理
3. 更健壮的跨平台构建能力
4. 更符合当前CMake最佳实践的构建配置

这些改进不仅解决了新版本CMake的兼容性问题，还为项目的长期维护奠定了更好的基础。开发者现在可以更轻松地在各种环境下构建和使用HarfBuzz库。