使用 CMake 和 MinGW 构建 PoDoFo 库

Building PoDoFo library using CMake and MinGW

本文关键字：PoDoFo 构建 MinGW CMake 使用      更新时间：2023-10-16

我正在尝试在我的Windows平台上构建PoDoFo Library（用作API）。它是使用 CMake 完成的。ReadMe文件如下。不幸的是，我是CMake的新手，我无法从中得到太多。

在Windows上构建PoDoFo

CMake 2.6.x 是 Windows 所必需的。您可以从以下位置下载 cmake.org .

在Windows上，PoDoFo可以构建为共享库或静态库。 不支持同时构建两者。默认情况下，仅共享库 将建成。如果你想要一个静态库，只需禁用生成 的共享库，带有额外的 cmake 参数：

    -DPODOFO_BUILD_SHARED=FALSE

在 win32 上处理库命名

特别是在Windows上，自定义构建的库也很常见 与可能作为预构建副本下载的名称不同。 如果它们被称为其他东西，CMake 将无法找到它们 除非你告诉它。使用这些变量告诉 CMake 要命名的名称 在以下位置查找库： 

•FREETYPE_LIBRARY_NAMES_DEBUG, FREETYPE_LIBRARY_NAMES_RELEASE and FREETYPE_LIBRARY_NAMES
•TIFF_LIBRARY_NAMES_DEBUG, TIFF_LIBRARY_NAMES_RELEASE and TIFF_LIBRARY_NAMES 
•LIBJPEG_LIBRARY_NAMES_DEBUG, LIBJPEG_LIBRARY_NAMES_RELEASE and LIBJPEG_LIBRARY_NAMES
•ZLIB_LIBRARY_NAMES_DEBUG, ZLIB_LIBRARY_NAMES_RELEASE,ZLIB_LIBRARY_NAMES

CMake 使用 MinGW 构建在 Windows 上

设置MinGW后，请确保MinGW"bin"目录已打开 您的路径，并确保设置CMAKE_INCLUDE_PATH和 CMAKE_LIBRARY_PATH以便 CMake 可以找到标头和 .lib 文件 对于PoDoFo所需的库。来自 GnuWin32 库包 众所周知，http://gnuwin32.sf.net/可以使用PoDoFo，因此安装时 Zlib，FreeType和libjpeg应该可以解决问题。

使用默认的 GnuWin32 安装和 MinGW已经在您的道路上： 

md ..podofo-debug 
cd ..podofo-debug
cmake -G "MinGW Makefiles" ..podofo-src -DCMAKE_INCLUDE_PATH=c:progra~1gnuwin32include -DCMAKE_LIBRARY_PATH=c:progra~1gnuwin32lib -DPODOFO_BUILD_SHARED:BOOL=FALSE mingw32-make

我已经安装了CMake并下载了提到的其他库，例如freetype, zlib, libjpeg.它们的头文件和二进制文件位于各自的文件夹中。

现在DCMAKE_INCLUDE_PATH和DCMAKE_LIBRARY_PATH应该是什么？还有什么是"MinGW Makefiles"？我必须提供任何额外的参数吗？

如果有人能用简单的步骤解释我该怎么做，我将不胜感激。

编辑：执行CMAKE时出错：

-- Ensure you cppunit installed version is at least 1.12.0
Cppunit not found. No unit tests will be built.
CMake Error at C:/Program Files (x86)/CMake 2.8/share/cmake-2.8/Modules/FindPack
ageHandleStandardArgs.cmake:97 (message):
  Could NOT find FREETYPE (missing: FREETYPE_LIBRARY FREETYPE_INCLUDE_DIR)
Call Stack (most recent call first):
  C:/Program Files (x86)/CMake 2.8/share/cmake-2.8/Modules/FindPackageHandleStan
dardArgs.cmake:291 (_FPHSA_FAILURE_MESSAGE)
  cmake/modules/FindFREETYPE.cmake:75 (FIND_PACKAGE_HANDLE_STANDARD_ARGS)
  CMakeLists.txt:372 (FIND_PACKAGE)

要构建PoDoFo，您需要安装GnuWin32，CMake，MinGW32和PoDoFo源

  1. 下载 GetGnuWin32
  2. 安装到 C：\getgnuwin32
  3. 打开CMD.exe
  4. CD C：\getgnuwin32
  5. download.bat
  6. install.bat

然后按照@ibizaman答案中的建议

cmake -G "MinGW Makefiles"  -DCMAKE_INCLUDE_PATH="C:gnuwin32include" -DCMAKE_LIBRARY_PATH="C:gnuwin32lib" -DPODOFO_BUILD_STATIC=TRUE ..

FreeType 应该与 GnuWin32 软件包一起安装

如果您遵循所有说明，编译它通常应该足以执行以下操作：

cd <podofo root directory (where CMakeLists.txt is)>
mkdir build 
cd build
cmake -G "MinGW Makefiles" -DCMAKE_INCLUDE_PATH=<path to headers> -DCMAKE_LIBRARY_PATH=<path to libraries> -DPODOFO_BUILD_SHARED:BOOL=FALSE ..
mingw32-make

循序渐进：首先，转到您的 podofo 源所在的目录。您应该会看到一个CMakeLists.txt文件。

第二（和第三），创建（并进入）将完成编译的目录。我称之为构建，但它可以是任何名称。这是最佳实践，因为您只需删除构建目录并返回到干净状态。

第四，要求 cmake 为 mingw 创建生成文件：

  • 指定手册中宣传的PODOFO_BUILD_SHARED：构建共享或静态版本。

  • CMAKE_INCLUDE_PATH 和 CMAKE_LIBRAY_PATH 用于引用构建 podofo 所需的包。如果您像以前一样下载了预编译包，因为您有 de 标头和二进制文件，那么您需要提供 cmake 这些标头和二进制文件的路径。如果需要，您可以多次指定变量，例如：

    cmake -G "MinGW Makefiles" -DCMAKE_INCLUDE_PATH=/path/to/freetype/include -DCMAKE_LIBRARY_PATH=/path/to/freetype/lib  -DCMAKE_INCLUDE_PATH=/path/to/zlib/include -DCMAKE_LIBRARY_PATH=/path/to/zlib/lib -DPODOFO_BUILD_SHARED:BOOL=FALSE ..

  • "MinGW Makefiles"告诉cmake创建特定于mingw的makefile。否则，默认情况下，在Windows上，它会创建特定于Microsoft Visual Studio的makefile。

  • finaly 引用父目录中的CMakeLists.txt，末尾带有 ..。

最后，但并非最不重要的一点是，使用 mingw 版本的 make 进行编译。

相关文章：