简介对于需要在Visual Studio 2010环境下处理PDF文档的C开发者这份基于PoDoFo 0.9.4核心源码的VS2010工程可直接用于解析、修改和创建PDF。作者绕过了cmake生成解决方案时常见的配置失败手工整理src核心代码未附带Samples等外围示例在Win10 x64 VS2010下可顺利编译生成dll和lib。依赖的freetype2与zlib均已提前编译为静态库并放在对应目录省去自行链接的麻烦如需调整也可自行修改头文件与库的包含路径。整个压缩包共370个文件以263个头文件与93个C源文件为主体另含少量lib库、资源脚本与解决方案文件整体仅2.43MB目录简洁适合深入阅读已有749人浏览学习。相比自行搭建依赖和工程这套资源能显著缩短集成PoDoFo核心能力的时间特别适合需要在桌面或后端服务中快速加入PDF功能的开发者参考也适合作为PDF格式学习与二次开发的起点。1. podofo-0.9.4 在 VS2010 下搭建 PDF 处理工程老项目啃 PDF 的务实解法我遇到很多还在用 VS2010 维护老项目的团队业务上突然要加 PDF 解析、合并或者生成。换编译器和迁移工程不是小事成本全在存量代码和第三方依赖上。这时候把 podofo-0.9.4 接进来是最省事的路径之一。podofo 是个开源的 C PDF 库0.9.4 这个版本当年就是跟 VS2010 同一代人CMake 一跑就能生成 V100 平台工具集的解决方案编译出来给老工程用不用动主项目。这篇文章讲的就是怎么用 VS2010 把 podofo-0.9.4 工程搭起来、编出库、接到自己项目里以及哪些地方最容易踩坑。适合手里有老 MFC、Win32 工程需要做 PDF 功能的人也适合想在本地快速验证 podofo 能不能满足需求的初学者。2. 先摸清 podofo-0.9.4 的家底CMake 工程、依赖库与 VS2010 的缘分2.1 为什么官方没有直接给你 VS2010 的 .slnpodofo 的源码包解压后顶层只有 CMakeLists.txt没有现成的 podofo.sln 或 podofo.vcxproj。很多从 VS6 时代过来的人会不适应open 一个工程文件不就行了为什么还要 CMake因为 PoDoFo 在 0.9.x 时代就全面转向 CMake 构建。项目本身要跨 Windows、Linux、macOS没法每个平台维护一套工程。Windows 这边CMake 负责根据你本机装的 VS 版本生成对应的 .sln 和 .vcxproj。VS2010 对应的是 “Visual Studio 10” 这个 generator。这个工程文件不是你平时手动新建的那种空项目而是 CMake 根据源码里的目标、依赖和宏定义自动生成的。所以想要 podofo-0.9.4 的 VS2010 工程第一步不是打开源码而是先把 CMake 跑通。我当时下载 podofo-0.9.4 源码后第一件事是确认本机的 CMake 版本。VS2010 是 2010 年的东西CMake 版本越新对老 generator 的支持越差。我这边习惯用 CMake 3.2 或更早的 2.8.x 来生成虽然新版本也能跑但生成的工程里偶尔会带一些新语法的 CMake 脚本变量VS2010 的旧环境下反而会报错。如果你手里只有新 CMake也能试真碰壁了就换 2.8.12。这一步没什么玄学只是工具链代差问题。2.2 从源码引出 VS2010 工程CMake 参数与第三方库路径用 CMake 生成工程时我一般不在源码目录里直接跑因为生成的文件会污染源码树后面想重新配置就很乱。常见做法是新建一个 build 目录比如 podofo-0.9.4/build-vs2010然后在这个目录里执行 cmake指定源码路径和 generator。命令长这样mkdir build-vs2010 cd build-vs2010 cmake .. -G Visual Studio 10 2010 ^ -DCMAKE_PREFIX_PATHD:/dev/3rdparty/podofo-deps ^ -DPODOFO_BUILD_SHAREDON ^ -DPODOFO_BUILD_STATICOFF ^ -DCMAKE_BUILD_TYPERelease在 Windows 命令行下^是换行符。这里每个参数都有实际意义-G Visual Studio 10 2010是明确让 CMake 用 VS2010 的生成器如果本机只装了 VS2010不写也会自动识别但写上更稳-DCMAKE_PREFIX_PATH指向第三方依赖库的安装位置zlib、libjpeg 这些库如果装在不常见的位置必须有这一项PODOFO_BUILD_SHAREDON表示生成 DLL 形式的动态库PODOFO_BUILD_STATICOFF表示不生成静态库两者可以同时开但当时我只需要动态库就只开了 SHARED。跑完之后build-vs2010 目录下会出现 PODOFO.sln 和一堆 vcxproj。这里有个容易忽略的点-DCMAKE_BUILD_TYPERelease在 VS 的 multi-config 生成器下是不生效的VS 的 Release/Debug 是在 IDE 里切换的不是 CMake 指定。所以这条命令里不写CMAKE_BUILD_TYPE也没关系我写出来是为了让从 Linux 切过来的人不犯迷糊。2.3 依赖项该选哪些zlib/libjpeg/libpng/freetype/OpenSSL 的取舍podofo-0.9.4 不是全裸编译它有几样必选和可选的依赖。必选的是 zlib 和 libjpeg。zlib 用于 PDF 流的 FlateDecode 解压libjpeg 用于 DCTDecode 图像解码。这两个如果缺失编译也能过但生成的库打开很多 PDF 时会报错因为常见 PDF 内部压缩格式就是这两种。可选的是 libpng、freetype 和 OpenSSL。libpng 对应的 PDF 图像格式很罕见跳过也能用freetype 是某些字体提取功能要用如果你只做文本提取和 PDF 合并可以不管OpenSSL 是给加密 PDF 用的开启后会有额外符号导入部署时还要带上 libeay32.dll 和 ssleay32.dll。我个人在 VS2010 工程里做 PDF 功能时通常只开 zlib 和 libjpeg其余全部关掉减少部署体积。怎么关在 CMake GUI 里搜PODOFO_HAVE_LIBPNG、PODOFO_HAVE_FREETYPE、PODOFO_HAVE_OPENSSL把不用的取消勾选。依赖库的构建本身也是个工程。我用的第三方的 zlib 是从 zlib 官方拿的源码用 VS2010 直接编译libjpeg 用的是 IJG 的 jpeg-9a 版本源码同样用 VS2010 编。编出来的 lib 文件放进一个统一目录比如D:/dev/3rdparty/podofo-deps然后通过CMAKE_PREFIX_PATH让 CMake 去找。如果你不想费这个事也可以让 CMake 直接编译源码里的第三方podofo-0.9.4 源码包不包含第三方源码必须自己准备。这是很多新手翻车的地方以为 CMake 会全部搞定结果第一步就卡在找不到 zlib.h。3. 编译 podofo-0.9.4 的 VS2010 工程配置项、生成顺序与第一个 DLL3.1 用 CMake 生成 VS2010 工程后先检查的 4 个配置打开 PODOFO.sln 后VS2010 会自动加载一系列项目。这里不要急着按 F7先花几分钟检查几个配置。第一个是解决方案配置默认会有 Debug 和 Release确认你最终要的是哪一种我一般在贴到老工程里前先在 Release 下编一遍因为老项目的线上发布都是 Release。第二个是平台CMake 默认生成 Win32。如果你的 VS2010 工程是 x64 的需要用-G Visual Studio 10 2010 Win64重新生成不能直接在 IDE 里把 Win32 改成 x64那样会有一堆依赖路径错乱。第三个是检查PODOFO_BUILD_SHARED是否生效方法是看生成目标里有没有podofo这个 DLL 项目如果没有回到 CMake 配置看选项第四个是确认第三方库头文件路径有没有进入 VC 目录。CMake 在 find_package 时会把找到的头文件路径写进 vcxproj 的 Include 目录但如果你用的是自己编译的第三方库路径信息经常缺失我会手动在 VS 的项目属性里加上。这一节如果忽略后面编译报错的光是 C1083 找不到头文件就能耗你半天。VS2010 的报错信息不像现在新版本那么智能它只告诉你某个文件找不到不会提示你去哪找。检查完这四样再编译心里才有底。3.2 编译顺序先第三方库还是先 PoDoFo解决方案里默认有一个 ALL_BUILD右键生成它VS 会自动按依赖关系先编译 zlib、jpeg再编译 podofo。但如果你发现 ALL_BUILD 总是先编译 podofo 然后报错说找不到 zlib那大概率是 CMake 没找到第三方库的 lib 文件导致 podofo 项目并没有依赖 zlib 项目。这种情况下我的做法是先把 zlib 和 jpeg 项目单独编译成 lib然后手动把 lib 文件放到 CMake 查找路径下再重新运行 CMake 生成一次。这一步的作用是让 find_package 在构建之前就拿到完整的库文件链接时不会出现 LNK1181 之类的问题。如果你不想手动排序也可以用 CMake 的add_subdirectory把第三方库源码直接引进来但这就得改 podofo 的 CMakeLists后续升级不方便。我一般不这么干而是保持第三方库独立编译。另外podofo 0.9.4 的解决方案里可能会有 INSTALL 项目它负责把生成的头文件、DLL 和 lib 复制到CMAKE_INSTALL_PREFIX。这个项目对集成到老工程很有用。我会在 ALL_BUILD 生成后单独生成 INSTALL然后去安装目录里找最终的产物。这样做比在 build 目录里翻 .lib 更清晰。3.3 让 Release 和 Debug 都闭嘴宏定义与运行库VS2010 工程里编译 DLL 时podofo 的头文件会根据一个宏来决定是导入符号还是导出符号。这个宏叫PODOFO_IMPORT。使用 DLL 的一方必须定义它否则链接时会报一堆 unresolved external symbol。我自己写的工程会在 preprocessor definitions 里加上PODOFO_IMPORT。如果是静态库则绝不能加这个宏。很多血泪经验就出在这Release 里忘了加链接时报错几百行看不出来。除了宏还有运行库设置。podofo 的默认 CMake 配置会用多线程 DLL 版/MD。你的调用工程也要保持一致否则 Debug 下正常Release 下崩或者反过来。VS2010 的运行库选项在项目属性 - C/C - 代码生成 - 运行库。我用 pb 的时候统一设成/MD因为老工程里 MFC 通常也是/MD保持一致最省事。// 头文件里 pch.h 或 stdafx.h 开头加这一段 #ifndef _USE_MATH_DEFINES #define _USE_MATH_DEFINES #endif #include cmath这个代码块来自一个我自己遇到的编译错误M_PI未定义。VS2010 的cmath在默认情况下不暴露M_PI除非定义_USE_MATH_DEFINES。podofo 内部有些几何计算会用到 π不定义这个宏编译期会报“在命名空间 std 中不存在 M_PI”。在工程属性里加一个预处理定义就能解决。这一段代码块建议放到你项目的公共头文件顶部尤其是 MFC 工程的 stdafx.h 里。4. 在自己的 VS2010 项目里接进 podofo-0.9.4三步配置与最小样例4.1 头文件、库目录、附加依赖项三步走配置编译好 podofo 之后集成到自己的 VS2010 工程里其实只有三步没有新鲜玩法。第一步在项目属性里找到 C/C 常规的“附加包含目录”把 podofo 的 include 路径加进去。这个路径不是源码目录是 CMake 生成的 include 目录里面是安装脚本收集好的头文件。如果没跑 INSTALL也可以直接用源码里的 src 目录但那样头文件组织不一样以后升级容易漏。第二步在链接器常规的“附加库目录”里把安装目录下的 lib 文件夹加进去。第三步在链接器输入的“附加依赖项”里写上 podofo.lib如果用了 zlib 和 jpeg还需要 zlib.lib 和 jpeg.lib。这三样都填完工程配置才算齐。我给初学者一个检查技巧配置完这三步后先不要写任何代码直接编译一个空的 C 源文件如果链接不报错说明路径没问题如果报错 LNK1104 找不到 podofo.lib优先看附加库目录有没有拼错如果报一大堆 unresolved external基本就是PODOFO_IMPORT宏的问题。4.2 最小 C 样例打开 PDF 并读出页数接 podofo 的第一个样例我建议直接做“打开 PDF 并读取页数”。这个流程最短但能验证头文件、库链接、DLL 加载是否都正常。代码长这样#include podofo/podofo.h using namespace PoDoFo; int main() { PdfMemDocument doc; try { doc.Load(sample.pdf); int pageCount doc.GetPageCount(); printf(PDF page count: %d\n, pageCount); } catch (PdfError err) { fprintf(stderr, PDF load failed, code%d\n, err.GetError()); return 1; } return 0; }这段代码的逻辑是创建PdfMemDocument对象调用Load加载 PDF 文件然后用GetPageCount获取页数。PdfError是 podofo 统一的异常类型任何解析错误都会抛它。这里的printf是老工程里常见写法VS2010 的控制台程序用 C 库的 printf 最稳如果换成std::cout也能跑但混合工程里容易引入 unicode 配置问题。运行前记得把编译好的podofo.dll和依赖的zlib.dll、jpeg.dll复制到 exe 同目录。如果不复制程序一启动就会弹“找不到 podofo.dll”。这也是老工程接入新库最常见的首跑错误。4.3 在 MFC 与 C/CLI 工程里混用的注意点如果你的 VS2010 工程是 MFC 对话框程序使用 podofo 时要留意消息循环和文件加载的阻塞。MFC 界面线程里直接Load一个很大的 PDF界面会卡住。podofo 的Load是同步解析没有异步接口。我的做法是把 PDF 加载放到工作线程里或者先读文件大小超过 10MB 的提前显示“解析中”。如果工程是 C/CLI情况更麻烦。你自己项目里的 CLR 和本地代码混用没问题但 podofo 的 DLL 是纯本地库必须确保/clr项目链接的是原生库并且不能把 podofo 头文件引入到/clr的模块里来引发二次编译错误。常见的做法是写一个本地 C 的 wrapper内部用 podofo外面只暴露托管接口。这是老生常谈却也是最稳的。分类讨论一下如果只是调用一个简单函数直接在.cpp文件顶部用#pragma comment(lib, podofo.lib)也能绕过工程配置但可维护性差我自己只在临时测试时用。5. VS2010 编译 podofo 的避坑手册5 个我实测过的问题5.1 编译报 C1083 找不到 zlib.h现象CMake 配置通过打开 VS2010 工程后编译podofo 项目报 C1083fatal error C1083: Cannot open include file: zlib.h。原因CMake 的find_package(ZLIB)找到了 zlib 的 lib 文件但没有找到头文件路径。这通常是因为第三方库的 include 目录和 lib 目录不在同一个 prefix 结构里比如 zlib.lib 在D:/lib而 zlib.h 在D:/includeCMake 没有自动推断。解决在 CMake 配置时增加-DZLIB_INCLUDE_DIRD:/include或者把 zlib.h 复制到 podofo 源码的第三方头文件统一目录中。我习惯用-DZLIB_INCLUDE_DIR和-DZLIB_LIBRARY明确指定虽然麻烦但一次配置完不会再犯。注意改完 CMake 参数后要重新打开 IDE 生成的解决方案或重新运行 CMake不能让旧工程残留。5.2 链接报 LNK2019 unresolved external symbol现象自己的工程编译正常链接时报一片LNK2019 unresolved external symbol public: int __thiscall PoDoFo::PdfMemDocument::GetPageCount(...)各种Pdf*符号找不到。原因没有定义PODOFO_IMPORT宏。podofo 的 DLL 导出声明在头文件里是#ifdef PODOFO_IMPORT控制导入的不定义它头文件会按静态库或导出库的方式处理符号修饰名对不上链接器找不到导入符号。解决在项目属性 - C/C - 预处理器 - 预处理器定义里加PODOFO_IMPORT。如果你是 Debug 和 Release 分开配置的两个都要加。我一开始只改了 ReleaseDebug 链接时又报一遍白折腾半小时。提示用了宏之后如果报错变成没有错误但链接成功程序运行时找不到 DLL那说明还需要把 DLL 复制到 exe 目录。5.3 Debug 正常 Release 崩溃现象Debug 模式下程序运行正常切到 Release 模式后一加载 PDF 就崩溃而且崩溃位置不稳定。原因最常见的是运行库不一致。podofo 库编译时用的是/MD你的 Release 工程却用了/MT两边运行库不同导致 CRT 堆管理对象不同跨 DLL 边界传递了 C 对象或者分配的内存被另一个 CRT 释放。VS2010 里 Debug 默认是/MDdRelease 默认/MD如果你手动改过很容易出这种问题。解决检查 podofo 的 DLL 编译配置和你自己工程的“运行库”一项保证 Release 都是/MDDebug 都是/MDd。另一个原因是_ITERATOR_DEBUG_LEVEL不一致。Debug 下 STL 迭代器是安全级别 2Release 是 0如果你把一个包含 STL 容器的 podofo 数据结构从 Release 库传到 Debug 工程就会崩。统一两边工程的“运行时库”和“迭代器调试级别”即可没有别的捷径。5.4 生成的 lib 放到别的机器上提示缺 MSVCR100现象编译好 podofo.dll 后拷贝到没有装 VS2010 的目标机器上程序运行提示“缺少 MSVCR100.dll”或“缺少 MSVCP100.dll”。原因VS2010 默认动态链接到 VC 运行库目标机器没有装 Visual C 2010 Redistributable。这是部署层面的问题不是 podofo 的问题。解决在目标机器安装 VS2010 运行库或者编译 podofo 时把运行库设置从/MD改成/MT静态链接 CRT。注意/MT后 podofo.dll 就不再依赖 MSVCR100.dll但如果你自己的程序也用了new/delete跨模块分配建议不要混用/MT否则内存释放会踩坑。我的选择是发布包里带 VC2010 运行库安装包省得纠结。5.5 PDF 中文提取出来是乱码现象用 podofo 抽取 PDF 文本英文正常中文全是乱码或者抽出来只有半个字。原因podofo 0.9.4 的文本提取功能只负责按 PDF 内容流的编码映射规则返回字符不做 Unicode 归一化。很多 PDF 的中文字体用的是自定义编码比如 Identity-HPodofo 拿到的是字形 ID不是 Unicode 码点。这时候输出乱码是正常的不是库坏了。解决先确认 PDF 是不是带 CID 字体。如果是文本提取只能得到 CID 值需要配合 CMap 文件做映射。podofo 0.9.4 自己不带完整的字体解析层我建议要么换用专门的 PDF 文本提取方案要么在调用层做编码转换。这个问题在 podofo 新版本里也没有完全解决遇到加密字体或非嵌入字体光靠 PoDoFo 是不够的。别在这里死磕换思路更快。6. 让 podofo-0.9.4 在 VS2010 里更顺手三个进阶验证技巧6.1 用自带命令行工具快速验证库是否可用podofo 源码里带了几个命令行工具比如 podofomerge、podofoimpose、podofotxt2pdf。在 VS2010 里编译 ALL_BUILD 时这些工具也会被编译出来。这其实是验证库是否可用的最好方法。不用写代码直接打开命令行跑到 build 目录下的 Debug 或 Release 文件夹执行podofotxt2pdf.exe test.txt test.pdf如果正常生成 PDF说明所有核心功能都通了。我在接自己工程前都会先跑这一步把库本身的问题和接入时的配置问题隔离开。如果工具跑起来报缺 DLL那先复制依赖再试如果报 PDF 库内部错误那可能是第三方依赖的编码问题。这一步能帮你节省大量找 bug 的时间别跳过。6.2 用 CRT 的调试堆找 PdfObject 泄漏podofo 的对象模型里到处都是 new/deleteVS2010 的 MFC 工程如果检测到内存泄漏只能看到PdfObject之类的符号。想在 VS2010 下定位可以在代码里用_CrtSetBreakAlloc在特定分配序号处断点。常见做法是在 main 函数开头加#include crtdbg.h int main() { _CrtSetBreakAlloc(1024); _CrtSetDbgFlag(_CRTDBG_LEAK_CHECK_DF | _CRTDBG_ALLOC_MEM_DF); // 你的 podofo 调用代码 }这里_CrtSetBreakAlloc(1024)是让调试器在分配序号为 1024 的堆分配时中断具体序号从 VS 输出窗口的泄漏报告里读取。_CRTDBG_LEAK_CHECK_DF会在程序退出时输出泄漏报告。这个技巧不是 podofo 特有的但对付老版 C 库内存泄漏很有效。如果你发现泄漏位置总在 podofo 内部而且你调用方式正确那可能是 podofo 自己在那次解析路径上的缺陷换个 API 规避比解剖库更划算。6.3 把 PoDoFo 编成静态库来减小部署体积如果你的 VS2010 工程对部署体积敏感或者目标机器上不能随便装 DLL可以考虑把 podofo 编成静态库。做法是在 CMake 配置时设PODOFO_BUILD_SHAREDOFF和PODOFO_BUILD_STATICON。生成后在 lib 目录会得到 podofo_static.lib 之类的文件链接时你的工程里去掉PODOFO_IMPORT宏改为定义PODOFO_STATIC或干脆不定义任何 podofo 相关宏。这块要特别小心因为静态库的符号导出规则和 DLL 不同宏定义错了会报奇怪的重复符号或未解析符号。编译静态库时zlib 和 libjpeg 也要以静态方式链路不能是 DLL 版。否则你的 exe 里既要带 podofo 的静态目标又要带 zlib 的 DLL绕一圈又回到部署问题。我自己给一个内部工具编过 podofo 0.9.4 静态版最终 exe 体积比动态版多出约 500KB但省了运行库和 DLL 的打包在老系统上反而更省心。VS2010 带 podofo-0.9.4 这件事踩过一轮坑之后其实很稳定。只要你坚持“第三方库独立编译、运行库统一、宏定义正确”这三条原则PDF 解析的功能就能稳稳落到老工程里。希望这些实战记录能帮你少走点弯路。本文还有配套的精品资源点击获取
