本文操作按照《c&c++开源库编译指南》中内容规范编写,编译环境配置、工具下载、目录规划,及更多其他开源库编译方法请参考该文章。
c&c++开源库编译指南:https://blog.csdn.net/binary0006/article/details/144086155
本文章中的源代码已提交到gitee仓库,地址:https://gitee.com/binary0010/depends/tree/master/c/freetype-2.13.3
1.freetype 概述
FreeType 是一款开源的跨平台字体渲染引擎,支持 TrueType、OpenType、PostScript 等多种字体格式,提供高质量的字形渲染、抗锯齿、提示(hinting)及布局处理能力。其模块化设计允许开发者灵活集成,编译时支持多平台(Windows/Linux/macOS/Android/iOS)及编译器(GCC/Clang/MSVC),依赖项轻量(仅需 zlib 或 freetype),可生成静态 / 动态库适配不同项目需求。
该引擎广泛应用于图形库(如 SDL、Qt)、浏览器(Chrome、Firefox)、操作系统(Linux 字体渲染)及游戏引擎(Unity、Unreal)中,用于实现文本的高效渲染与排版。基于 BSD 许可开源,代码托管于 GitHub,社区维护活跃且文档完善,典型用户包括 Adobe、Mozilla 等技术公司,以及 LibreOffice、Inkscape 等开源项目。
2.freetype编译
2.1.源代码下载
从freetype官网https://freetype.org/index.html看到当前2.13.3版本,源代码下载地址:https://download.savannah.gnu.org/releases/freetype/,找到最新版2.13.3版本,点击下图所示链接直接下载即可。
也可以自己复制这个地址下载:https://download.savannah.gnu.org/releases/freetype/freetype-2.13.3.tar.gz
2.2.windows编译
先解压源代码到指定目录,freetype源代码中已经提供了CMakeList.txt脚本,后面我们按照规范会对该脚本进行修改。
2.2.1.修改CMake脚本
修改CMake脚本按照我们的设计的编译规范来进行构建和编译,修改源代码根目录下的CMakeLists.txt即可。
脚本涉及的内容主要是使用我们编译规范来对工程命名和输出,以及mt工程的链接库设置。freetype可选依赖zlib、bizp2、png、brotli、harfbuzz,之前已经按照规范编译了zlib、bizp2、png、brotli,由于harfbuzz在vs2008下无法编译通过,在CMakeLists.txt脚本的修改中不会涉及到harfbuzz相关内容。
CMakeLists.txt完整内容:
# CMakeLists.txt
#
# Copyright (C) 2013-2024 by
# David Turner, Robert Wilhelm, and Werner Lemberg.
#
# Written originally by John Cary <cary@txcorp.com>
#
# This file is part of the FreeType project, and may only be used, modified,
# and distributed under the terms of the FreeType project license,
# LICENSE.TXT. By continuing to use, modify, or distribute this file you
# indicate that you have read the license and understand and accept it
# fully.
#
#
# The following will (1) create a build directory, and (2) change into it and
# call cmake to configure the build with default parameters as a static
# library. See
#
# https://cmake.org/cmake/help/latest/variable/CMAKE_BUILD_TYPE.html
#
# for information about debug or release builds, for example
#
# cmake -B build -D CMAKE_BUILD_TYPE=Release
#
#
# For a dynamic library, use
#
# cmake -B build -D BUILD_SHARED_LIBS=true -D CMAKE_BUILD_TYPE=Release
#
# For a framework on OS X, use
#
# cmake -E chdir build cmake -G Xcode -D BUILD_FRAMEWORK:BOOL=true ..
#
# For an iOS static library, use
#
# cmake -E chdir build cmake -G Xcode -D IOS_PLATFORM=OS ..
#
# or
#
# cmake -E chdir build cmake -G Xcode -D IOS_PLATFORM=SIMULATOR ..
#
# or
#
# cmake -E chdir build cmake -G Xcode -D IOS_PLATFORM=SIMULATOR64 ..
#
#
# Finally, build the project with
#
# cmake --build build
#
# Install it with
#
# (sudo) cmake --build build --target install
#
# A binary distribution can be made with
#
# cmake --build build --config Release --target package
#
# Please refer to the cmake manual for further options, in particular, how
# to modify compilation and linking parameters.
#
# Some notes.
#
# - Say `cmake -LAH` to see all configuration options.
#
# - `cmake' creates configuration files in
#
# <build-directory>/include/freetype/config
#
# which should be further modified if necessary.
#
# - You can use `cmake' directly on a freshly cloned FreeType git
# repository.
#
# - `CMakeLists.txt' is provided as-is since it is normally not used by the
# developer team.
#
# - Set the `FT_REQUIRE_ZLIB', `FT_REQUIRE_freetype', `FT_REQUIRE_PNG',
# `FT_REQUIRE_HARFBUZZ', and `FT_REQUIRE_BROTLI' CMake variables to `ON'
# or `TRUE' to force using a dependency. Leave a variable undefined
# (which is the default) to use the dependency only if it is available.
# Example:
#
# cmake -B build -D FT_REQUIRE_ZLIB=TRUE \
# -D FT_REQUIRE_freetype=TRUE \
# -D FT_REQUIRE_PNG=TRUE \
# -D FT_REQUIRE_HARFBUZZ=TRUE \
# -D FT_REQUIRE_BROTLI=TRUE [...]
#
# - Set `FT_DISABLE_XXX=TRUE' to disable a dependency completely (where
# `XXX' is a CMake package name like `freetype'). Example for disabling all
# dependencies:
#
# cmake -B build -D FT_DISABLE_ZLIB=TRUE \
# -D FT_DISABLE_freetype=TRUE \
# -D FT_DISABLE_PNG=TRUE \
# -D FT_DISABLE_HARFBUZZ=TRUE \
# -D FT_DISABLE_BROTLI=TRUE [...]
#
# - NOTE: If a package is set as DISABLED, it cannot be set as REQUIRED
# without unsetting the DISABLED value first. For example, if
# `FT_DISABLE_HARFBUZZ=TRUE' has been set (Cache is present), you need to
# call `FT_DISABLE_HARFBUZZ=FALSE' before calling
# `FT_REQUIRE_HARFBUZZ=TRUE'.
#
# - Installation of FreeType can be controlled with the CMake variables
# `SKIP_INSTALL_HEADERS', `SKIP_INSTALL_LIBRARIES', and `SKIP_INSTALL_ALL'
# (this is compatible with the same CMake variables in zlib's CMake
# support).
# To minimize the number of cmake_policy() workarounds,
# CMake >= 3 is requested.
cmake_minimum_required(VERSION 3.0...3.15)
if(NOT CMAKE_VERSION VERSION_LESS 3.3)
# Allow symbol visibility settings also on static libraries. CMake < 3.3
# only sets the property on a shared library build.
cmake_policy(SET CMP0063 NEW)
# Support new IN_LIST if() operator.
cmake_policy(SET CMP0057 NEW)
endif()
include(CheckIncludeFile)
include(CMakeDependentOption)
# CMAKE_TOOLCHAIN_FILE must be set before `project' is called, which
# configures the base build environment and references the toolchain file
if(APPLE)
if(DEFINED IOS_PLATFORM)
if(NOT "${IOS_PLATFORM}" STREQUAL "OS"
AND NOT "${IOS_PLATFORM}" STREQUAL "SIMULATOR"
AND NOT "${IOS_PLATFORM}" STREQUAL "SIMULATOR64")
message(FATAL_ERROR
"IOS_PLATFORM must be set to either OS, SIMULATOR, or SIMULATOR64")
endif()
if(NOT "${CMAKE_GENERATOR}" STREQUAL "Xcode")
message(AUTHOR_WARNING
"You should use Xcode generator with IOS_PLATFORM enabled to get Universal builds.")
endif()
if(BUILD_SHARED_LIBS)
message(FATAL_ERROR
"BUILD_SHARED_LIBS can not be on with IOS_PLATFORM enabled")
endif()
if(BUILD_FRAMEWORK)
message(FATAL_ERROR
"BUILD_FRAMEWORK can not be on with IOS_PLATFORM enabled")
endif()
# iOS only uses static libraries
set(BUILD_SHARED_LIBS OFF)
set(CMAKE_TOOLCHAIN_FILE
${CMAKE_SOURCE_DIR}/builds/cmake/iOS.cmake)
endif()
else()
if(DEFINED IOS_PLATFORM)
message(FATAL_ERROR "IOS_PLATFORM is not supported on this platform")
endif()
endif()
project(freetype C)
set(VERSION_MAJOR "2")
set(VERSION_MINOR "13")
set(VERSION_PATCH "3")
# Generate LIBRARY_VERSION and LIBRARY_SOVERSION.
set(LIBTOOL_REGEX "version_info='([0-9]+):([0-9]+):([0-9]+)'")
file(STRINGS "${PROJECT_SOURCE_DIR}/builds/unix/configure.raw"
VERSION_INFO
REGEX ${LIBTOOL_REGEX})
string(REGEX REPLACE
${LIBTOOL_REGEX} "\\1"
LIBTOOL_CURRENT "${VERSION_INFO}")
string(REGEX REPLACE
${LIBTOOL_REGEX} "\\2"
LIBTOOL_REVISION "${VERSION_INFO}")
string(REGEX REPLACE
${LIBTOOL_REGEX} "\\3"
LIBTOOL_AGE "${VERSION_INFO}")
# This is what libtool does internally on Unix platforms.
math(EXPR LIBRARY_SOVERSION "${LIBTOOL_CURRENT} - ${LIBTOOL_AGE}")
set(LIBRARY_VERSION "${LIBRARY_SOVERSION}.${LIBTOOL_AGE}.${LIBTOOL_REVISION}")
set(CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/../../cmake ${CMAKE_MODULE_PATH})
include(${CMAKE_CURRENT_SOURCE_DIR}/../../cmake/third-common.cmake)
set(FREETYPE_VERSION "${VERSION_MAJOR}.${VERSION_MINOR}.${VERSION_PATCH}")
set(INSTALL_BIN_DIR "${third-bin}/${PROJECT_NAME}-${FREETYPE_VERSION}" CACHE PATH "Installation directory for executables")
set(INSTALL_LIB_DIR "${third-lib}/${PROJECT_NAME}-${FREETYPE_VERSION}" CACHE PATH "Installation directory for libraries")
set(INSTALL_INC_DIR "${third-include}/${PROJECT_NAME}-${FREETYPE_VERSION}" CACHE PATH "Installation directory for headers")
set(INSTALL_MAN_DIR "${CMAKE_INSTALL_PREFIX}/share/man" CACHE PATH "Installation directory for manual pages")
set(INSTALL_PKGCONFIG_DIR "${CMAKE_INSTALL_PREFIX}/share/pkgconfig" CACHE PATH "Installation directory for pkgconfig (.pc) files")
# External dependency library detection is automatic. See the notes at the
# top of this file, for how to force or disable dependencies completely.
option(FT_DISABLE_ZLIB
"Disable use of system zlib and use internal zlib library instead." OFF)
cmake_dependent_option(FT_REQUIRE_ZLIB
"Require system zlib instead of internal zlib library." OFF
"NOT FT_DISABLE_ZLIB" OFF)
option(FT_DISABLE_freetype
"Disable support of freetype compressed fonts." OFF)
cmake_dependent_option(FT_REQUIRE_freetype
"Require support of freetype compressed fonts." OFF
"NOT FT_DISABLE_freetype" OFF)
option(FT_DISABLE_PNG
"Disable support of PNG compressed OpenType embedded bitmaps." OFF)
cmake_dependent_option(FT_REQUIRE_PNG
"Require support of PNG compressed OpenType embedded bitmaps." OFF
"NOT FT_DISABLE_PNG" OFF)
option(FT_DISABLE_HARFBUZZ
"Disable HarfBuzz (used for improving auto-hinting of OpenType fonts)." OFF)
cmake_dependent_option(FT_REQUIRE_HARFBUZZ
"Require HarfBuzz for improving auto-hinting of OpenType fonts." OFF
"NOT FT_DISABLE_HARFBUZZ" OFF)
option(FT_DISABLE_BROTLI
"Disable support of compressed WOFF2 fonts." OFF)
cmake_dependent_option(FT_REQUIRE_BROTLI
"Require support of compressed WOFF2 fonts." OFF
"NOT FT_DISABLE_BROTLI" OFF)
option(FT_ENABLE_ERROR_STRINGS
"Enable support for meaningful error descriptions." OFF)
# Disallow in-source builds
if("${CMAKE_BINARY_DIR}" STREQUAL "${CMAKE_SOURCE_DIR}")
message(FATAL_ERROR
"In-source builds are not permitted! Make a separate folder for"
" building, e.g.,\n"
" cmake -E make_directory build\n"
" cmake -E chdir build cmake ..\n"
"Before that, remove the files created by this failed run with\n"
" cmake -E remove CMakeCache.txt\n"
" cmake -E remove_directory CMakeFiles")
endif()
# Add local cmake modules
list(APPEND CMAKE_MODULE_PATH ${PROJECT_SOURCE_DIR}/builds/cmake)
if(BUILD_FRAMEWORK)
if(NOT "${CMAKE_GENERATOR}" STREQUAL "Xcode")
message(FATAL_ERROR
"You should use Xcode generator with BUILD_FRAMEWORK enabled")
endif()
set(CMAKE_OSX_ARCHITECTURES "$(ARCHS_STANDARD)")
set(BUILD_SHARED_LIBS ON)
endif()
# Find dependencies
include(FindPkgConfig)
if(NOT FT_DISABLE_HARFBUZZ)
set(HARFBUZZ_MIN_VERSION "2.0.0")
if(FT_REQUIRE_HARFBUZZ)
find_package(HarfBuzz ${HARFBUZZ_MIN_VERSION} REQUIRED)
else()
find_package(HarfBuzz ${HARFBUZZ_MIN_VERSION})
endif()
endif()
if(NOT FT_DISABLE_PNG)
if(FT_REQUIRE_PNG)
find_package(PNG REQUIRED)
else()
find_package(PNG)
endif()
# FreePNG calls FindZLIB so unset ZLIB_FOUND to respect FT_DISABLE_ZLIB
unset(ZLIB_FOUND)
endif()
if(NOT FT_DISABLE_ZLIB)
if(FT_REQUIRE_ZLIB)
find_package(ZLIB REQUIRED)
else()
find_package(ZLIB)
endif()
endif()
if(NOT FT_DISABLE_freetype)
# Genuine freetype does not provide freetype.pc, but some platforms have it.
# For better dependency in freetype2.pc, freetype.pc is searched
# regardless of the availability of libbz2. If freetype.pc is found,
# Requires.private is used instead of Libs.private.
if(FT_REQUIRE_freetype)
find_package(freetype REQUIRED)
else()
find_package(freetype)
endif()
pkg_check_modules(PC_freetype freetype)
endif()
if(NOT FT_DISABLE_BROTLI)
if(FT_REQUIRE_BROTLI)
find_package(BrotliDec REQUIRED)
find_package(BrotliCommon REQUIRED)
else()
find_package(BrotliDec)
find_package(BrotliCommon)
endif()
endif()
# Create the configuration file
if(UNIX AND NOT WIN32)
check_include_file("unistd.h" HAVE_UNISTD_H)
check_include_file("fcntl.h" HAVE_FCNTL_H)
file(READ "${PROJECT_SOURCE_DIR}/builds/unix/ftconfig.h.in"
FTCONFIG_H)
if(HAVE_UNISTD_H)
string(REGEX REPLACE
"#undef +(HAVE_UNISTD_H)" "#define \\1 1"
FTCONFIG_H "${FTCONFIG_H}")
endif()
if(HAVE_FCNTL_H)
string(REGEX REPLACE
"#undef +(HAVE_FCNTL_H)" "#define \\1 1"
FTCONFIG_H "${FTCONFIG_H}")
endif()
else()
file(READ "${PROJECT_SOURCE_DIR}/include/freetype/config/ftconfig.h"
FTCONFIG_H)
endif()
set(FTCONFIG_H_NAME "${PROJECT_BINARY_DIR}/include/freetype/config/ftconfig.h")
if(EXISTS "${FTCONFIG_H_NAME}")
file(READ "${FTCONFIG_H_NAME}" ORIGINAL_FTCONFIG_H)
else()
set(ORIGINAL_FTCONFIG_H "")
endif()
if(NOT (ORIGINAL_FTCONFIG_H STREQUAL FTCONFIG_H))
file(WRITE "${FTCONFIG_H_NAME}" "${FTCONFIG_H}")
endif()
# Create the options file
file(READ "${PROJECT_SOURCE_DIR}/include/freetype/config/ftoption.h"
FTOPTION_H)
if(ZLIB_FOUND)
string(REGEX REPLACE
"/\\* +(#define +FT_CONFIG_OPTION_SYSTEM_ZLIB) +\\*/" "\\1"
FTOPTION_H "${FTOPTION_H}")
endif()
if(freetype_FOUND)
string(REGEX REPLACE
"/\\* +(#define +FT_CONFIG_OPTION_USE_freetype) +\\*/" "\\1"
FTOPTION_H "${FTOPTION_H}")
endif()
if(PNG_FOUND)
string(REGEX REPLACE
"/\\* +(#define +FT_CONFIG_OPTION_USE_PNG) +\\*/" "\\1"
FTOPTION_H "${FTOPTION_H}")
endif()
if(HARFBUZZ_FOUND)
string(REGEX REPLACE
"/\\* +(#define +FT_CONFIG_OPTION_USE_HARFBUZZ) +\\*/" "\\1"
FTOPTION_H "${FTOPTION_H}")
endif()
if(BROTLIDEC_FOUND)
string(REGEX REPLACE
"/\\* +(#define +FT_CONFIG_OPTION_USE_BROTLI) +\\*/" "\\1"
FTOPTION_H "${FTOPTION_H}")
endif()
if(FT_ENABLE_ERROR_STRINGS)
string(REGEX REPLACE
"/\\* +(#define +FT_CONFIG_OPTION_ERROR_STRINGS) +\\*/" "\\1"
FTOPTION_H "${FTOPTION_H}")
endif()
set(FTOPTION_H_NAME "${PROJECT_BINARY_DIR}/include/freetype/config/ftoption.h")
if(EXISTS "${FTOPTION_H_NAME}")
file(READ "${FTOPTION_H_NAME}" ORIGINAL_FTOPTION_H)
else()
set(ORIGINAL_FTOPTION_H "")
endif()
if(NOT (ORIGINAL_FTOPTION_H STREQUAL FTOPTION_H))
file(WRITE "${FTOPTION_H_NAME}" "${FTOPTION_H}")
endif()
file(GLOB PUBLIC_HEADERS "include/ft2build.h" "include/freetype/*.h")
file(GLOB PUBLIC_CONFIG_HEADERS "include/freetype/config/*.h")
file(GLOB PRIVATE_HEADERS "include/freetype/internal/*.h")
set(BASE_SRCS
src/autofit/autofit.c
src/base/ftbase.c
src/base/ftbbox.c
src/base/ftbdf.c
src/base/ftbitmap.c
src/base/ftcid.c
src/base/ftfstype.c
src/base/ftgasp.c
src/base/ftglyph.c
src/base/ftgxval.c
src/base/ftinit.c
src/base/ftmm.c
src/base/ftotval.c
src/base/ftpatent.c
src/base/ftpfr.c
src/base/ftstroke.c
src/base/ftsynth.c
src/base/fttype1.c
src/base/ftwinfnt.c
src/bdf/bdf.c
src/freetype/ftfreetype.c
src/cache/ftcache.c
src/cff/cff.c
src/cid/type1cid.c
src/gzip/ftgzip.c
src/lzw/ftlzw.c
src/pcf/pcf.c
src/pfr/pfr.c
src/psaux/psaux.c
src/pshinter/pshinter.c
src/psnames/psnames.c
src/raster/raster.c
src/sdf/sdf.c
src/sfnt/sfnt.c
src/smooth/smooth.c
src/svg/svg.c
src/truetype/truetype.c
src/type1/type1.c
src/type42/type42.c
src/winfonts/winfnt.c
)
if(WIN32)
list(APPEND BASE_SRCS "builds/windows/ftsystem.c")
elseif(UNIX)
list(APPEND BASE_SRCS "builds/unix/ftsystem.c")
else()
list(APPEND BASE_SRCS "src/base/ftsystem.c")
endif()
if(WIN32)
enable_language(RC)
list(APPEND BASE_SRCS builds/windows/ftdebug.c
src/base/ftver.rc)
elseif(WINCE)
list(APPEND BASE_SRCS builds/wince/ftdebug.c)
else()
list(APPEND BASE_SRCS src/base/ftdebug.c)
endif()
if(BUILD_FRAMEWORK)
list(APPEND BASE_SRCS builds/mac/freetype-Info.plist)
endif()
if(NOT DISABLE_FORCE_DEBUG_POSTFIX)
set(CMAKE_DEBUG_POSTFIX d)
endif()
# add_library(freetype
# ${PUBLIC_HEADERS}
# ${PUBLIC_CONFIG_HEADERS}
# ${PRIVATE_HEADERS}
# ${BASE_SRCS}
# )
# set_target_properties(
# freetype PROPERTIES
# C_VISIBILITY_PRESET hidden)
# target_compile_definitions(
# freetype PRIVATE FT2_BUILD_LIBRARY)
# if(WIN32)
# target_compile_definitions(
# freetype PRIVATE _CRT_SECURE_NO_WARNINGS _CRT_NONSTDC_NO_WARNINGS)
# if(BUILD_SHARED_LIBS)
# target_compile_definitions(
# freetype PRIVATE DLL_EXPORT)
# endif()
# endif()
# if(BUILD_SHARED_LIBS)
# set_target_properties(freetype PROPERTIES
# VERSION ${LIBRARY_VERSION}
# SOVERSION ${LIBRARY_SOVERSION})
# endif()
# Pick up ftconfig.h and ftoption.h generated above, first.
# target_include_directories(
# freetype
# PUBLIC
# $<INSTALL_INTERFACE:include/freetype2>
# $<BUILD_INTERFACE:${CMAKE_CURRENT_BINARY_DIR}/include>
# $<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
# PRIVATE
# ${CMAKE_CURRENT_BINARY_DIR}/include
# ${CMAKE_CURRENT_SOURCE_DIR}/include
# # Make <ftconfig.h> available for builds/unix/ftsystem.c.
# ${CMAKE_CURRENT_BINARY_DIR}/include/freetype/config
# )
# 静态库工程
add_library(freetypelib STATIC
${PUBLIC_HEADERS}
${PUBLIC_CONFIG_HEADERS}
${PRIVATE_HEADERS}
${BASE_SRCS}
)
# 动态库工程
add_library(freetypedll SHARED
${PUBLIC_HEADERS}
${PUBLIC_CONFIG_HEADERS}
${PRIVATE_HEADERS}
${BASE_SRCS}
)
set_target_properties(
freetypelib freetypedll PROPERTIES
C_VISIBILITY_PRESET hidden)
target_compile_definitions(
freetypelib PRIVATE FT2_BUILD_LIBRARY)
target_compile_definitions(
freetypedll PRIVATE FT2_BUILD_LIBRARY)
if(WIN32)
target_compile_definitions(
freetypelib PRIVATE _CRT_SECURE_NO_WARNINGS _CRT_NONSTDC_NO_WARNINGS)
target_compile_definitions(
freetypedll PRIVATE _CRT_SECURE_NO_WARNINGS _CRT_NONSTDC_NO_WARNINGS DLL_EXPORT)
set_target_properties(freetypedll PROPERTIES
VERSION ${LIBRARY_VERSION}
SOVERSION ${LIBRARY_SOVERSION})
endif()
target_include_directories(
freetypelib
PUBLIC
$<INSTALL_INTERFACE:include/freetype2>
$<BUILD_INTERFACE:${CMAKE_CURRENT_BINARY_DIR}/include>
$<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
PRIVATE
${CMAKE_CURRENT_BINARY_DIR}/include
${CMAKE_CURRENT_SOURCE_DIR}/include
# Make <ftconfig.h> available for builds/unix/ftsystem.c.
${CMAKE_CURRENT_BINARY_DIR}/include/freetype/config
)
target_include_directories(
freetypedll
PUBLIC
$<INSTALL_INTERFACE:include/freetype2>
$<BUILD_INTERFACE:${CMAKE_CURRENT_BINARY_DIR}/include>
$<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
PRIVATE
${CMAKE_CURRENT_BINARY_DIR}/include
${CMAKE_CURRENT_SOURCE_DIR}/include
# Make <ftconfig.h> available for builds/unix/ftsystem.c.
${CMAKE_CURRENT_BINARY_DIR}/include/freetype/config
)
if(MSVC)
# 静态库mt工程
add_library(freetypelibmt STATIC
${PUBLIC_HEADERS}
${PUBLIC_CONFIG_HEADERS}
${PRIVATE_HEADERS}
${BASE_SRCS}
)
set_property(TARGET freetypelibmt PROPERTY
MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")
# 动态库mt工程
add_library(freetypedllmt SHARED
${PUBLIC_HEADERS}
${PUBLIC_CONFIG_HEADERS}
${PRIVATE_HEADERS}
${BASE_SRCS}
)
set_property(TARGET freetypedllmt PROPERTY
MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")
set_target_properties(
freetypelib freetypedllmt PROPERTIES
C_VISIBILITY_PRESET hidden)
target_compile_definitions(
freetypelibmt PRIVATE FT2_BUILD_LIBRARY)
target_compile_definitions(
freetypedllmt PRIVATE FT2_BUILD_LIBRARY)
if(WIN32)
target_compile_definitions(
freetypelibmt PRIVATE _CRT_SECURE_NO_WARNINGS _CRT_NONSTDC_NO_WARNINGS)
target_compile_definitions(
freetypedllmt PRIVATE _CRT_SECURE_NO_WARNINGS _CRT_NONSTDC_NO_WARNINGS DLL_EXPORT)
set_target_properties(freetypedll PROPERTIES
VERSION ${LIBRARY_VERSION}
SOVERSION ${LIBRARY_SOVERSION})
endif()
target_include_directories(
freetypelibmt
PUBLIC
$<INSTALL_INTERFACE:include/freetype2>
$<BUILD_INTERFACE:${CMAKE_CURRENT_BINARY_DIR}/include>
$<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
PRIVATE
${CMAKE_CURRENT_BINARY_DIR}/include
${CMAKE_CURRENT_SOURCE_DIR}/include
# Make <ftconfig.h> available for builds/unix/ftsystem.c.
${CMAKE_CURRENT_BINARY_DIR}/include/freetype/config
)
target_include_directories(
freetypedllmt
PUBLIC
$<INSTALL_INTERFACE:include/freetype2>
$<BUILD_INTERFACE:${CMAKE_CURRENT_BINARY_DIR}/include>
$<BUILD_INTERFACE:${CMAKE_CURRENT_SOURCE_DIR}/include>
PRIVATE
${CMAKE_CURRENT_BINARY_DIR}/include
${CMAKE_CURRENT_SOURCE_DIR}/include
# Make <ftconfig.h> available for builds/unix/ftsystem.c.
${CMAKE_CURRENT_BINARY_DIR}/include/freetype/config
)
# 设置静态库pdb文件
set_lib_pdb_file(freetype lib)
set_lib_pdb_file(freetype libmt)
endif(MSVC)
# if(BUILD_FRAMEWORK)
# set_property(SOURCE ${PUBLIC_CONFIG_HEADERS}
# PROPERTY MACOSX_PACKAGE_LOCATION Headers/config
# )
# set_target_properties(freetype PROPERTIES
# FRAMEWORK TRUE
# MACOSX_FRAMEWORK_INFO_PLIST ${CMAKE_CURRENT_SOURCE_DIR}/builds/mac/freetype-Info.plist
# PUBLIC_HEADER "${PUBLIC_HEADERS}"
# XCODE_ATTRIBUTE_INSTALL_PATH "@rpath"
# )
# endif()
# # 'freetype-interface' is an interface library, to be accessed with
# # `EXPORT_NAME Freetype::Freetype`. This is the target name provided by
# # CMake's `FindFreetype.cmake`, so we provide it for compatibility.
# add_library(freetype-interface INTERFACE)
# set_target_properties(freetype-interface PROPERTIES
# EXPORT_NAME Freetype::Freetype
# INTERFACE_LINK_LIBRARIES freetype)
# set(PKGCONFIG_REQUIRES "")
# set(PKGCONFIG_REQUIRES_PRIVATE "")
# set(PKGCONFIG_LIBS "-L\${libdir} -lfreetype")
# set(PKGCONFIG_LIBS_PRIVATE "")
if(ZLIB_FOUND)
# target_link_libraries(freetype PRIVATE ${ZLIB_LIBRARIES})
# target_include_directories(freetype PRIVATE ${ZLIB_INCLUDE_DIRS})
# list(APPEND PKGCONFIG_REQUIRES_PRIVATE "zlib")
target_link_libraries(freetypelib PRIVATE ${ZLIB_LIBRARIES})
target_include_directories(freetypelib PRIVATE ${ZLIB_INCLUDE_DIRS})
target_link_libraries(freetypedll PRIVATE ${ZLIB_LIBRARIES})
target_include_directories(freetypedll PRIVATE ${ZLIB_INCLUDE_DIRS})
if(MSVC)
target_link_libraries(freetypelibmt PRIVATE ${ZLIB_LIBMT_LIBRARIES})
target_include_directories(freetypelibmt PRIVATE ${ZLIB_INCLUDE_DIRS})
target_link_libraries(freetypedllmt PRIVATE ${ZLIB_LIBMT_LIBRARIES})
target_include_directories(freetypedllmt PRIVATE ${ZLIB_INCLUDE_DIRS})
endif(MSVC)
list(APPEND PKGCONFIG_REQUIRES_PRIVATE "zlib")
endif()
if(freetype_FOUND)
# target_link_libraries(freetype PRIVATE ${freetype_LIBRARIES})
# target_include_directories(freetype PRIVATE ${freetype_INCLUDE_DIR}) # not freetype_INCLUDE_DIRS
target_link_libraries(freetypelib PRIVATE ${freetype_LIBRARIES})
target_include_directories(freetypelib PRIVATE ${freetype_INCLUDE_DIR}) # not freetype_INCLUDE_DIRS
target_link_libraries(freetypedll PRIVATE ${freetype_LIBRARIES})
target_include_directories(freetypedll PRIVATE ${freetype_INCLUDE_DIR}) # not freetype_INCLUDE_DIRS
if(MSVC)
target_link_libraries(freetypelibmt PRIVATE ${freetype_LIBMT_LIBRARIES})
target_include_directories(freetypelibmt PRIVATE ${freetype_INCLUDE_DIR})
target_link_libraries(freetypedllmt PRIVATE ${freetype_LIBMT_LIBRARIES})
target_include_directories(freetypedllmt PRIVATE ${freetype_INCLUDE_DIR})
endif(MSVC)
if(PC_freetype_FOUND)
list(APPEND PKGCONFIG_REQUIRES_PRIVATE "freetype")
else()
list(APPEND PKGCONFIG_LIBS_PRIVATE "-lbz2")
endif()
endif()
if(PNG_FOUND)
# target_link_libraries(freetype PRIVATE ${PNG_LIBRARIES})
# target_compile_definitions(freetype PRIVATE ${PNG_DEFINITIONS})
# target_include_directories(freetype PRIVATE ${PNG_INCLUDE_DIRS})
target_link_libraries(freetypelib PRIVATE ${PNG_LIBRARIES})
target_compile_definitions(freetypelib PRIVATE ${PNG_DEFINITIONS})
target_include_directories(freetypelib PRIVATE ${PNG_INCLUDE_DIRS})
target_link_libraries(freetypedll PRIVATE ${PNG_LIBRARIES})
target_compile_definitions(freetypedll PRIVATE ${PNG_DEFINITIONS})
target_include_directories(freetypedll PRIVATE ${PNG_INCLUDE_DIRS})
if(MSVC)
target_link_libraries(freetypelibmt PRIVATE ${PNG_LIBMT_LIBRARIES})
target_compile_definitions(freetypelibmt PRIVATE ${PNG_DEFINITIONS})
target_include_directories(freetypelibmt PRIVATE ${PNG_INCLUDE_DIRS})
target_link_libraries(freetypedllmt PRIVATE ${PNG_LIBMT_LIBRARIES})
target_compile_definitions(freetypedllmt PRIVATE ${PNG_DEFINITIONS})
target_include_directories(freetypedllmt PRIVATE ${PNG_INCLUDE_DIRS})
endif(MSVC)
list(APPEND PKGCONFIG_REQUIRES_PRIVATE "libpng")
endif()
if(HarfBuzz_FOUND)
# target_link_libraries(freetype PRIVATE ${HarfBuzz_LIBRARY})
# target_include_directories(freetype PRIVATE ${HarfBuzz_INCLUDE_DIRS})
target_link_libraries(freetypelib PRIVATE ${HarfBuzz_LIBRARY})
target_include_directories(freetypelib PRIVATE ${HarfBuzz_INCLUDE_DIRS})
target_link_libraries(freetypedll PRIVATE ${HarfBuzz_LIBRARY})
target_include_directories(freetypedll PRIVATE ${HarfBuzz_INCLUDE_DIRS})
if(MSVC)
target_link_libraries(freetypelibmt PRIVATE ${HarfBuzz_LIBMT_LIBRARY})
target_include_directories(freetypelibmt PRIVATE ${HarfBuzz_INCLUDE_DIRS})
target_link_libraries(freetypedllmt PRIVATE ${HarfBuzz_LIBMT_LIBRARY})
target_include_directories(freetypedllmt PRIVATE ${HarfBuzz_INCLUDE_DIRS})
endif(MSVC)
list(APPEND PKGCONFIG_REQUIRES_PRIVATE "harfbuzz >= ${HARFBUZZ_MIN_VERSION}")
endif()
if(BROTLIDEC_FOUND)
# target_link_libraries(freetype PRIVATE ${BROTLIDEC_LIBRARIES})
# target_compile_definitions(freetype PRIVATE ${BROTLIDEC_DEFINITIONS})
# target_include_directories(freetype PRIVATE ${BROTLIDEC_INCLUDE_DIRS})
# target_link_libraries(freetype PRIVATE ${BROTLICOMMON_LIBRARIES})
# target_compile_definitions(freetype PRIVATE ${BROTLICOMMON_DEFINITIONS})
# target_include_directories(freetype PRIVATE ${BROTLICOMMON_INCLUDE_DIRS})
target_link_libraries(freetypelib PRIVATE ${BROTLIDEC_LIBRARIES})
target_compile_definitions(freetypelib PRIVATE ${BROTLIDEC_DEFINITIONS})
target_include_directories(freetypelib PRIVATE ${BROTLIDEC_INCLUDE_DIRS})
target_link_libraries(freetypelib PRIVATE ${BROTLICOMMON_LIBRARIES})
target_compile_definitions(freetypelib PRIVATE ${BROTLICOMMON_DEFINITIONS})
target_include_directories(freetypelib PRIVATE ${BROTLICOMMON_INCLUDE_DIRS})
target_link_libraries(freetypedll PRIVATE ${BROTLIDEC_LIBRARIES})
target_compile_definitions(freetypedll PRIVATE ${BROTLIDEC_DEFINITIONS})
target_include_directories(freetypedll PRIVATE ${BROTLIDEC_INCLUDE_DIRS})
target_link_libraries(freetypedll PRIVATE ${BROTLICOMMON_LIBRARIES})
target_compile_definitions(freetypedll PRIVATE ${BROTLICOMMON_DEFINITIONS})
target_include_directories(freetypedll PRIVATE ${BROTLICOMMON_INCLUDE_DIRS})
if(MSVC)
target_link_libraries(freetypelibmt PRIVATE ${BROTLIDEC_LIBMT_LIBRARIES})
target_compile_definitions(freetypelibmt PRIVATE ${BROTLIDEC_DEFINITIONS})
target_include_directories(freetypelibmt PRIVATE ${BROTLIDEC_INCLUDE_DIRS})
target_link_libraries(freetypelibmt PRIVATE ${BROTLICOMMON_LIBMT_LIBRARIES})
target_compile_definitions(freetypelibmt PRIVATE ${BROTLICOMMON_DEFINITIONS})
target_include_directories(freetypelibmt PRIVATE ${BROTLICOMMON_INCLUDE_DIRS})
target_link_libraries(freetypedllmt PRIVATE ${BROTLIDEC_LIBMT_LIBRARIES})
target_compile_definitions(freetypedllmt PRIVATE ${BROTLIDEC_DEFINITIONS})
target_include_directories(freetypedllmt PRIVATE ${BROTLIDEC_INCLUDE_DIRS})
target_link_libraries(freetypedllmt PRIVATE ${BROTLICOMMON_LIBMT_LIBRARIES})
target_compile_definitions(freetypedllmt PRIVATE ${BROTLICOMMON_DEFINITIONS})
target_include_directories(freetypedllmt PRIVATE ${BROTLICOMMON_INCLUDE_DIRS})
endif()
list(APPEND PKGCONFIG_REQUIRES_PRIVATE "libbrotlidec")
endif()
# Installation
# include(GNUInstallDirs)
#安装sdk相关文件
#安装头文件
if(NOT SKIP_INSTALL_HEADERS AND NOT SKIP_INSTALL_ALL)
install(
# Note the trailing slash in the argument to `DIRECTORY'!
DIRECTORY ${PROJECT_SOURCE_DIR}/include/
DESTINATION ${INSTALL_INC_DIR}/freetype2
COMPONENT headers
PATTERN "internal" EXCLUDE
PATTERN "ftconfig.h" EXCLUDE
PATTERN "ftoption.h" EXCLUDE)
install(
FILES ${PROJECT_BINARY_DIR}/include/freetype/config/ftconfig.h
${PROJECT_BINARY_DIR}/include/freetype/config/ftoption.h
DESTINATION ${INSTALL_INC_DIR}/freetype2/freetype/config
COMPONENT headers)
endif()
if(NOT SKIP_INSTALL_LIBRARIES AND NOT SKIP_INSTALL_ALL)
#安装库文件
set(freetype_targets freetypelib freetypedll)
if(MSVC)
list(APPEND freetype_targets freetypelibmt freetypedllmt)
endif()
install(TARGETS ${freetype_targets}
RUNTIME DESTINATION "${INSTALL_BIN_DIR}"
ARCHIVE DESTINATION "${INSTALL_LIB_DIR}"
LIBRARY DESTINATION "${INSTALL_LIB_DIR}")
endif()
#安装pdb文件
if(NOT SKIP_INSTALL_PDB AND NOT SKIP_INSTALL_ALL)
install(FILES $<TARGET_PDB_FILE:freetypedll> $<TARGET_PDB_FILE:freetypedllmt>
DESTINATION "${INSTALL_BIN_DIR}"
OPTIONAL)
# 静态库pdb调用函数安装
install_lib_pdb_file(freetype lib)
install_lib_pdb_file(freetype libmt)
endif()
# if(NOT SKIP_INSTALL_HEADERS AND NOT SKIP_INSTALL_ALL)
# install(
# # Note the trailing slash in the argument to `DIRECTORY'!
# DIRECTORY ${PROJECT_SOURCE_DIR}/include/
# DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}/freetype2
# COMPONENT headers
# PATTERN "internal" EXCLUDE
# PATTERN "ftconfig.h" EXCLUDE
# PATTERN "ftoption.h" EXCLUDE)
# install(
# FILES ${PROJECT_BINARY_DIR}/include/freetype/config/ftconfig.h
# ${PROJECT_BINARY_DIR}/include/freetype/config/ftoption.h
# DESTINATION ${CMAKE_INSTALL_INCLUDEDIR}/freetype2/freetype/config
# COMPONENT headers)
# endif()
# if(NOT SKIP_INSTALL_LIBRARIES AND NOT SKIP_INSTALL_ALL)
# # Generate the pkg-config file
# file(READ "${PROJECT_SOURCE_DIR}/builds/unix/freetype2.in" FREETYPE2_PC_IN)
# string(REPLACE ";" ", " PKGCONFIG_REQUIRES_PRIVATE "${PKGCONFIG_REQUIRES_PRIVATE}")
# string(REPLACE "%prefix%" ${CMAKE_INSTALL_PREFIX}
# FREETYPE2_PC_IN ${FREETYPE2_PC_IN})
# string(REPLACE "%exec_prefix%" "\${prefix}"
# FREETYPE2_PC_IN ${FREETYPE2_PC_IN})
# string(REPLACE "%libdir%" "\${prefix}/${CMAKE_INSTALL_LIBDIR}"
# FREETYPE2_PC_IN ${FREETYPE2_PC_IN})
# string(REPLACE "%includedir%" "\${prefix}/${CMAKE_INSTALL_INCLUDEDIR}"
# FREETYPE2_PC_IN ${FREETYPE2_PC_IN})
# string(REPLACE "%ft_version%" "${LIBTOOL_CURRENT}.${LIBTOOL_REVISION}.${LIBTOOL_AGE}"
# FREETYPE2_PC_IN ${FREETYPE2_PC_IN})
# if(BUILD_SHARED_LIBS)
# string(REPLACE "%PKGCONFIG_REQUIRES%" "${PKGCONFIG_REQUIRES}"
# FREETYPE2_PC_IN ${FREETYPE2_PC_IN})
# string(REPLACE "%PKGCONFIG_REQUIRES_PRIVATE%" "${PKGCONFIG_REQUIRES_PRIVATE}"
# FREETYPE2_PC_IN ${FREETYPE2_PC_IN})
# string(REPLACE "%PKGCONFIG_LIBS%" "${PKGCONFIG_LIBS}"
# FREETYPE2_PC_IN ${FREETYPE2_PC_IN})
# string(REPLACE "%PKGCONFIG_LIBS_PRIVATE%" "${PKGCONFIG_LIBS_PRIVATE}"
# FREETYPE2_PC_IN ${FREETYPE2_PC_IN})
# else()
# string(REPLACE "%PKGCONFIG_REQUIRES%" "${PKGCONFIG_REQUIRES} ${PKGCONFIG_REQUIRES_PRIVATE}"
# FREETYPE2_PC_IN ${FREETYPE2_PC_IN})
# string(REPLACE "%PKGCONFIG_REQUIRES_PRIVATE%" ""
# FREETYPE2_PC_IN ${FREETYPE2_PC_IN})
# string(REPLACE "%PKGCONFIG_LIBS%" "${PKGCONFIG_LIBS} ${PKGCONFIG_LIBS_PRIVATE}"
# FREETYPE2_PC_IN ${FREETYPE2_PC_IN})
# string(REPLACE "%PKGCONFIG_LIBS_PRIVATE%" ""
# FREETYPE2_PC_IN ${FREETYPE2_PC_IN})
# endif()
# set(FREETYPE2_PC_IN_NAME "${PROJECT_BINARY_DIR}/freetype2.pc")
# if(EXISTS "${FREETYPE2_PC_IN_NAME}")
# file(READ "${FREETYPE2_PC_IN_NAME}" ORIGINAL_FREETYPE2_PC_IN)
# else()
# set(ORIGINAL_FREETYPE2_PC_IN "")
# endif()
# if(NOT(ORIGINAL_FREETYPE2_PC_IN STREQUAL FREETYPE2_PC_IN))
# file(WRITE "${FREETYPE2_PC_IN_NAME}" ${FREETYPE2_PC_IN})
# endif()
# install(
# FILES ${PROJECT_BINARY_DIR}/freetype2.pc
# DESTINATION ${CMAKE_INSTALL_LIBDIR}/pkgconfig
# COMPONENT pkgconfig)
# include(CMakePackageConfigHelpers)
# write_basic_package_version_file(
# ${PROJECT_BINARY_DIR}/freetype-config-version.cmake
# VERSION ${VERSION_MAJOR}.${VERSION_MINOR}.${VERSION_PATCH}
# COMPATIBILITY SameMajorVersion)
# install(
# TARGETS freetype freetype-interface
# EXPORT freetype-targets
# LIBRARY DESTINATION ${CMAKE_INSTALL_LIBDIR}
# ARCHIVE DESTINATION ${CMAKE_INSTALL_LIBDIR}
# RUNTIME DESTINATION ${CMAKE_INSTALL_BINDIR}
# FRAMEWORK DESTINATION Library/Frameworks
# COMPONENT libraries)
# install(
# EXPORT freetype-targets
# DESTINATION ${CMAKE_INSTALL_LIBDIR}/cmake/freetype
# FILE freetype-config.cmake
# COMPONENT headers)
# install(
# FILES ${PROJECT_BINARY_DIR}/freetype-config-version.cmake
# DESTINATION ${CMAKE_INSTALL_LIBDIR}/cmake/freetype
# COMPONENT headers)
# endif()
# Packaging
# set(CPACK_PACKAGE_NAME ${CMAKE_PROJECT_NAME})
# set(CPACK_PACKAGE_DESCRIPTION_SUMMARY "The FreeType font rendering library.")
# set(CPACK_PACKAGE_DESCRIPTION_FILE "${CMAKE_CURRENT_SOURCE_DIR}/README")
# set(CPACK_RESOURCE_FILE_LICENSE "${CMAKE_CURRENT_SOURCE_DIR}/LICENSE.TXT")
# set(CPACK_PACKAGE_VERSION_MAJOR ${VERSION_MAJOR})
# set(CPACK_PACKAGE_VERSION_MINOR ${VERSION_MINOR})
# set(CPACK_PACKAGE_VERSION_PATCH ${VERSION_PATCH})
# set(CPACK_PACKAGE_VERSION "${CPACK_PACKAGE_VERSION_MAJOR}.${CPACK_PACKAGE_VERSION_MINOR}.${CPACK_PACKAGE_VERSION_PATCH}")
# if (WIN32)
# set(CPACK_GENERATOR ZIP)
# else ()
# set(CPACK_GENERATOR TGZ)
# endif ()
# set(CPACK_COMPONENT_LIBRARIES_DISPLAY_NAME "Libraries")
# set(CPACK_COMPONENT_HEADERS_DISPLAY_NAME "C/C++ Headers")
# set(CPACK_COMPONENT_LIBRARIES_DESCRIPTION
# "Library used to build programs which use FreeType")
# set(CPACK_COMPONENT_HEADERS_DESCRIPTION
# "C/C++ header files for use with FreeType")
# set(CPACK_COMPONENT_HEADERS_DEPENDS libraries)
# set(CPACK_COMPONENT_LIBRARIES_GROUP "Development")
# set(CPACK_COMPONENT_HEADERS_GROUP "Development")
# include(CPack)
2.2.2.cmake构建目录设置
选择源代码根目录(CMakeLists.txt文件在这个目录),设置build目录为源代码根目录下的cmake-vs2008绝对路径为D:/x-app/depends/c/freetype-2.13.3/cmake-vs2008,保证源代码目录干净,会生成工程和临时文件,同时也方便后续有其他的构建工具扩展管理。
2.2.2.1.应用CMake配置
点击“Configure”会弹出编译器选择对话框,这里选择“Visual Studio 9 2008”点击“Finish”按钮等待配置参数完成,会有一个“CMake Warning at builds/cmake/FindHarfBuzz.cmake:99 ”警告,直接忽略不用管,因为这里并没有编译HarfBuzz库也不会使用它。
2.2.2.2.生成vs解决方案
下面的红色警告忽略不用管,意思是未来的cmake版本不再支持生成vs2008的解决方案。
2.2.2.3.编译工程
使用vs2008打开“freetype.sln”解决方案文件,分别编译Debug和RelWithDebInfo配置。
2.2.2.4.安装库文件、头文件
编译Install工程的Debug和RelWithDebInfo配置,.h文件和编译生成.dll、.lib、pdb文件会拷贝CMakeList.txt中设置的路径下。
至此通过一个CMakeLists配置文件将windows下vs2008常用编译类型的库全部编译出来了,最终库的对应关系如下。
库类型 | 运行库类型 | 库文件 |
动态库 | mdd | freetypedlld.dll、freetypedlld.lib |
md | freetypedll.dll、freetypedll.lib | |
mtd | freetypedllmtd.dll、freetypedllmtd.lib | |
mt | freetypedllmt.dll、freetypedllmt.lib | |
静态库 | mdd | freetypelibd.lib |
md | freetypelib.lib | |
mtd | freetypelibmtd.lib | |
mt | freetypelibmt.lib |
2.2.3.vs2015编译
vs2015编译与vs2008相同的,只需要在CMake生成工程时选择vs2015即可,其他版本的vs也是一样的,选择需要使用的vs版本即可,此处只演示一下vs2015的编译。
因为前面生成过vs2008的工程,需要将build目录设置成cmake-vs2015,再“Configure”选择vs2015即可,其他操作就是一样的了。