★ FEATURED ARTICLE CLI开发工具【免费下载链接】qpdfqpdf: A content-preserving PDF document transformer项目地址https://gitcode.com/gh_mirrors/qp/qpdf点击查看免费下载qpdf 是一个同时提供命令行工具与 C 库的 PDF 处理项目核心定位是对 PDF 文件执行内容保真content-preserving的结构化变换涵盖线性化web 优化、加密解密、拆分合并、从零创建以及结构检查等能力。本文以仓库根目录 README.md 为主体结合 CMakeLists.txt、manual/installation.rst、manual/cli.rst 与核心头文件完整讲解 qpdf 的构建安装、依赖选择、加密提供者机制、随机数生成策略以及如何把 libqpdf 集成进你自己的 C 项目。qpdf 的能力边界做什么与不做什么从 README.md 与 manual/overview.rst 可以明确 qpdf 的定位能做线性化linearization、加密解密、文件拆分与合并、PDF 文件创建内容需由调用方提供、以及面向学习与分析的结构检查不做渲染 PDF、文本提取也不提供面向页面内容语义的高层接口本质一个面向 PDF 文件结构的低层工具非常适合需要以命令行或编程方式操纵 PDF 的开发者。即便只运行qpdf in.pdf out.pdf而不带任何选项输出文件与输入在功能上也是等价的只是结构可能被重新组织并且孤立的孤儿对象会被清除。这一点在 manual/cli.rst 的基础调用章节有明确说明。发行物验证sha256 cosign GPGqpdf 的官方发行包使用 cosign 签名。每个发行版都附带一个sha256校验文件包含所有发行文件的 SHA-256 校验和。验证流程分两层校验文件内容用sha256sum file或其他等价工具生成待验证文件的校验和与 sha256 文件中的记录比对校验 sha256 文件本身用 GPG 或cosign verify-blob验证签名。README 给出的 cosign 验证示例为cosign verify-blob qpdf-x.y.z.sha256 --bundle qpdf-x.y.z.sha256.sigstore \ --certificate-identitysigner-identityqpdf.org \ --certificate-oidc-issuerhttps://github.com/login/oauth其中signer-identityqpdf.org需要替换为实际签署人会在 release notes 中指明当前有效签署人为 Jay Berkenbilt 与 Manfred Holger。也可以使用 Jay Berkenbilt 的 GPG 公钥验证其指纹为C2C9 6B10 011F E009 E6D1 DF82 8A75 D109 9801 2C7E。许可证Apache 2.0 与可选的 Artistic 2.0qpdf 版权归 Jay Berkenbilt2005–2021以及 Jay Berkenbilt 与 Manfred Holger2022–2026所有采用Apache License 2.0授权全文见 LICENSE.txt。此外7.0 之前的版本基于 Artistic License 2.0见 Artistic-2.0发布使用者可以自行选择按该旧条款继续看待 qpdf。项目内嵌软件如 zlib、jpeg的许可信息见 NOTICE.md。构建前提与依赖根据 README 与 manual/installation.rst构建与使用 qpdf 的前提如下编译器构建和测试 qpdf 需要支持C20的编译器仅用 libqpdf 链接自己的程序C17 兼容编译器即可CMake3.16 或更高版本仓库顶层 CMakeLists.txt 的cmake_minimum_required(VERSION 3.16)与项目版本 12.4.1 与此对应外部库zlib或兼容实现与 libjpeg 兼容库jpeg或libjpeg-turbo这两个库存在于几乎所有 Linux 发行版中Windows 下可下载预编译二进制详见 README-windows.md可选库启用 gnutls / openssl 加密提供者时需要对应库可选构建选项ZOPFLI默认关闭需要 zopfli 库。值得注意的工程细节通过 pkg-config 或 cmake 使用 qpdf 时通常不需要依赖库的头文件。唯一例外是显式使用Pl_DCT.hhJPEG 相关管线时需要提供 libjpeg 的头文件而 qpdf 的 cmake/pkg-config 文件不会自动添加 JPEG include 路径——既然用到了Pl_DCT你的构建通常已经配置好了它。用 qpdf 链接自己的程序pkg-config 与 CMake 集成README 提供了一个最小可用的CMakeLists.txt示例通过find_package(qpdf)引入包目标qpdf::libqpdfcmake_minimum_required(VERSION 3.16) project(some-application LANGUAGES CXX) find_package(qpdf) add_executable(some-application some-application.cc) target_link_libraries(some-application qpdf::libqpdf)pkg-config 方式包名为libqpdf。仓库中的 libqpdf.pc.in 显示其声明Name: libqpdf、Version: PROJECT_VERSION、Requires.private: zlib, libjpeg并默认以-stdc20暴露编译标志CMake 方式安装的 qpdfConfig.cmake.in 会include(.../libqpdfTargets.cmake)从而导出可用的qpdf::libqpdf目标。相关开关INSTALL_PKGCONFIG与INSTALL_CMAKE_PACKAGE均默认开启控制这两个集成文件是否安装。API 学习入口阅读 include/qpdf 下的头文件注释是最好的文档尤其是 QPDF.hh文档对象入口、QPDFObjectHandle.hhPDF 对象句柄、QPDFWriter.hh写出器。此外 libqpdf/QPDFJob.cc 几乎覆盖了全部公共接口可作为库用法的活教材examples 目录也提供了大量可运行示例如 pdf-attach-file、pdf-split-pages、qpdf-job 等每个示例在 examples/qtest 下还有对应 .test 测试文件。C 语言绑定则见 libqpdf/qpdf-c.cc 与 include/qpdf/qpdf-c.h其中processFile、processMemoryFile与QPDFWriter的封装印证了从文件/内存读取并写出的完整链路。从源码构建UNIX/Linux 与 Windows自 qpdf 11 起构建系统统一为 CMake。默认配置在大多数系统上可直接工作。UNIX/Linux 示例cmake -S . -B build -DCMAKE_BUILD_TYPERelWithDebInfo cmake --build buildMSYS2 mingw 环境示例cmake -S . -B build -G MSYS Makefiles -DCMAKE_BUILD_TYPERelWithDebInfo cmake --build buildMSVC 示例从 MSYS shell 或带有 VS 命令行工具的 Windows shell 中cmake -S . -B build cmake --build build --config Release安装与打包安装用cmake --install必要时在.bashrc中设置export LD_LIBRARY_PATH/usr/local/lib64:$LD_LIBRARY_PATH打发行包用cpack。安装时可按组件拆分组件内容cli命令行工具lib运行时库仅动态库时需要与dev一起装dev静态库、头文件等开发所需文件doc文档examples示例源码例如只装开发文件且仅使用静态库cmake -S . -B build -DCMAKE_BUILD_TYPERelWithDebInfo -DBUILD_SHARED_LIBSOFF cmake --build build --parallel --target libqpdf cmake --install build --component devWindows 补充mingw 与 MSVC 均可构建并通过测试32 位与 64 位均可用。用 Visual Studio 默认 cmake 选项构建无需额外工具要跑测试套件则需要 MSYS2mingw 构建同样依赖 MSYS2。若用共享库需将 libqpdf 的输出目录加入 PATH否则可执行文件找不到 DLL。仓库还自带 CMakePresets.json内置debug、release、msvc、msvc-release、sanitizersclang ASan/UBSan OpenSSL/GnuTLS 强制开启等预设便于一键配置构建。常用构建选项从 CMakeLists.txt 到实际语义所有构建选项集中在顶层 CMakeLists.txt与 manual/installation.rst 的 Build Options 一节保持同步。面向大多数用户的关键选项BUILD_SHARED_LIBS/BUILD_STATIC_LIBS控制动态/静态库二者至少选一快速迭代时可只选其一以减半构建时间ZOPFLI启用 zopfli 压缩支持见下文QTEST_COLOR控制 qtest 测试输出是否着色WERROR把编译警告视为错误适合用新编译器验证 qpdf 时开启BUILD_DOC/BUILD_DOC_HTML/BUILD_DOC_PDF是否用 sphinx 构建文档HTML 需要 sphinx 与主题PDF 还需要 LaTeX 工具链MAINTAINER_MODE/CI_MODE维护者模式会打开BUILD_DOC、ENABLE_QTC、GENERATE_AUTO_JOB、WERROR、REQUIRE_NATIVE_CRYPTO、REQUIRE_SHELLSCI 模式打开SHOW_FAILED_TEST_OUTPUT与WERROR并强制构建 native 加密提供者SHOW_FAILED_TEST_OUTPUT让 qtest 的失败细节直接输出到构建日志否则要查看构建目录里的qtest.logSKIP_OS_SECURE_RANDOM/USE_INSECURE_RANDOM影响随机数来源详见随机数生成一节高级选项AVOID_WINDOWS_HANDLE禁用 WindowsHANDLE类型面向嵌入式 Windows仍可处理内存中的 PDF、OSS_FUZZ仅为 oss-fuzz 项目专用、INSTALL_MANUAL/BUILD_DOC_DIST手动安装文档发行版。Zopfli 压缩支持若以ZOPFLI选项构建且安装了 zopfli 库qpdf 就能用 zopfli 替代 zlib 生成 flate 压缩流输出略小但速度慢约 100 倍适合制作归档类 PDF对体积敏感、对速度不敏感。运行期通过环境变量QPDF_ZOPFLI控制行为值行为disabled或未设置不使用 zopfliforce强制使用 zopfli未编译进 zopfli 则失败silent有 zopfli 则用否则静默回退 zlib其他任意值有 zopfli 则用否则回退并给出警告加密提供者Crypto Providers机制自 qpdf 9.1.0 起密码学功能通过可插拔的crypto provider提供可在编译期与运行期选择。当前实现为gnutls链接 GnuTLS 库openssl链接 OpenSSL或 BoringSSL库native源码内嵌、无外部依赖的原生实现。编译期选择默认行为是 cmake 自动探测可用外部库构建所有可用的外部提供者并优先选择外部提供者而非 native只有在没有任何外部提供者可用时native 才作为默认。相关选项USE_IMPLICIT_CRYPTO默认开关闭后只构建显式选中的提供者ALLOW_CRYPTO_NATIVE默认开关闭后禁止回退到 nativeREQUIRE_CRYPTO_NATIVE/REQUIRE_CRYPTO_GNUTLS/REQUIRE_CRYPTO_OPENSSL强制构建对应提供者依赖缺失时报错DEFAULT_CRYPTO显式指定默认提供者不指定时按 gnutls → openssl → native 的优先级自动选择。例如只构建 gnutls 提供者-DUSE_IMPLICIT_CRYPTO0 -DREQUIRE_CRYPTO_GNUTLS1。9.1.0 之前的全部版本所用的 native 实现仍保留但只要有外部提供者可用默认就不再编译进 qpdf。运行期选择用qpdf --show-crypto列出可用提供者默认提供者排第一其余按字典序每个一行、无多余文本便于脚本解析设置环境变量QPDF_CRYPTO_PROVIDER覆盖默认提供者——这常用于对比两个提供者的行为差异、复现 bug 或性能问题qpdf 的 CI 也用它在每个受支持提供者下跑完整测试套件。供开发者自定义加密实现库使用方可以通过 QPDFCryptoProvider.hh 的静态接口控制提供者setDefaultProvider(name)强制使用某个提供者自定义实现则需派生自QPDFCryptoImpl见 QPDFCryptoImpl.hh再用registerImpl(name, fn)注册。该类采用单例模式借助 C11 局部静态变量初始化保证线程安全其设计动机与取舍在 manual/installation.rst 的 Crypto Provider Design Notes 一节有详细阐述。加密实现至少要提供 MD5、SHA2256/384/512哈希与 RC4、AES-256含 CBC 模式加解密能力。关于弱加密算法的提示PDF 格式历史上依赖 RC4 加密256 位密钥一律使用 AES128 位密钥可选用 AES。qpdf 在写入含弱加密算法的文件时会尽力告警但必须保留读写弱加密文件的能力以完整支持旧版 PDF 文件与旧版阅读器。随机数生成native 提供者下的安全策略默认情况下 qpdf 用当前加密提供者生成随机数以下仅针对 native 提供者当检测到 Windows 密码学 API 或/dev/urandom、/dev/arandom、/dev/random存在时优先使用它们生成密码学安全随机数若上述条件都不满足构建会直接失败SKIP_OS_SECURE_RANDOMcmake 选项或预处理器宏禁用 Windows 密码学 API 与随机设备此时必须自备随机数据源或允许使用不安全的随机数USE_INSECURE_RANDOM在关闭 OS 安全随机数后回退到 stdlib 的random()/rand()。注意它不是自动回退——不关闭 OS 安全随机数时找不到 OS 随机源属于编译错误。不安全随机数下库功能完整但加密密钥更易被猜测自定义随机源派生 RandomDataProvider.hh 中的qpdf/RandomDataProvider基类自 5.1.0 起提供并在创建任何QPDF对象前调用QUtil::setRandomDataProvider。自定义提供者一旦设置就始终生效。若同时定义SKIP_OS_SECURE_RANDOM且不定义USE_INSECURE_RANDOM则任何未提供随机源的随机数生成尝试都会抛出运行时错误。测试套件ctest、qtest 与可选测试测试由 ctest 驱动、以嵌入的 qtestPerl 实现执行真实用例。想看底层细节请用ctest --verbose关掉颜色可传-DQTEST_COLOR0。默认关闭慢速测试与需要额外依赖的测试图像对比测试设置环境变量QPDF_TEST_COMPARE_IMAGES1开启需要 libtiff 命令行工具与 GhostScript 8.60。此前qpdf 11 之前是在qpdf.test中默认启用、需设QPDF_SKIP_TEST_COMPARE_IMAGES关闭现在语义反转为显式开启。它用于确保内容变换不破坏页面渲染只有当你深改库、影响生成 PDF 内容时才必须跑大文件测试设置QPDF_LARGE_FILE_TEST_PATH为一个至少有 11 GB 空闲空间、可容纳超 4 GB 文件的目录绝对路径Windows 下用 Windows 路径例如C:\LargeFileTemp打包场景autobuilder 环境建议-DSHOW_FAILED_TEST_OUTPUT1并搭配ctest --verbose或ctest --output-on-failure否则需访问qtest.log查看失败详情Debian 包即如此配置只跑单个测试TESTSqutil ctest --verbose -R libtests只运行 libtests 套件中的qutil.test。默认测试即可提供近乎完整的覆盖率仅仅验证qpdf 在你的构建下能正常工作时完全够用。命令行实战README 之外的核心用法结合 manual/cli.rstqpdf 命令行遵循qpdf [infile] [options] [outfile]形式输入输出顺序灵活、--empty表示零页空输入、--replace-input表示就地覆盖输入、outfile为-时写 stdout不支持 stdin 读取、filename可作为参数文件。几个与 README 所述能力对应的关键选项--linearize生成线性化web 优化文件允许兼容阅读器在文件下载完成前就开始显示因为普通文件的关键交叉引用信息通常在文件末尾--encrypt ... --开始加密选项组user/owner 密码、密钥长度、权限限制等--decrypt去除加密仅用于合法用途--copy-encryptionfile从另一文件复制完整加密参数含/ID前半段--remove-restrictions移除数字签名带来的限制并失效签名但保留其视觉外观--qdf生成适合文本编辑器查看甚至编辑的 QDF 文件可解压的流全部解压、内容流归一化配合fix-qdf修复手工编辑过的文件注意--linearize会禁用 QDF 模式也可与--object-streamsdisable组合便于定位具体对象--split-pages[n]按页或每 n 页一组拆分为多个输出文件例如qpdf --split-pages infile.pdf %d-out与qpdf --split-pages2 infile.pdf outfile.pdf--password/--password-file打开受密码保护的输入文件。文档构建与贡献生态用户手册用 reStructured Text 编写、以 sphinx 构建源码位于 manual 目录conf.py、index.rst、cli.rst、library.rst、json.rst 等。构建 HTML 文档通常执行pip install sphinx sphinx_rtd_themePDF 版需要pdflatex、latexmk与较完整的 LaTeX 安装。仓库另有面向维护者的 README-developer.md、README-maintainer.md、README-hardening.md 等文档以及 completionsbash/zsh 补全、fuzzOSS-Fuzz 目标与 pkg-test 等配套目录可视为阅读源码之外的补充材料。小结从本文可以提炼出使用 qpdf 的三条主线作为命令行工具围绕--linearize、--encrypt/--decrypt、--split-pages、--qdf完成内容保真的结构变换作为构建目标掌握 CMake 选项、加密提供者选择与随机数策略作为库通过find_package(qpdf)/ pkg-config 接入qpdf::libqpdf并以 QPDF.hh、QPDFObjectHandle.hh、QPDFWriter.hh 为起点学习 API。理解内容保真这一核心约束是正确使用 qpdf 的前提——它处理的是 PDF 的结构而非内容语义因此特别适合作为 Web 优化、加密包装、批量拆分合并与结构分析等自动化流水线中的底层基础设施。赞分享CLI开发工具【免费下载链接】qpdfqpdf: A content-preserving PDF document transformer项目地址https://gitcode.com/gh_mirrors/qp/qpdf点击查看免费下载相关推荐MaxViT 特征提取实战从图像到嵌入向量的完整流程MaxViT 特征提取实战从图像到嵌入向量的完整流程 MaxViT 是一种结合卷积与注意力机制的多轴视觉Transformer模型在图像分类和特征提取任务中Haystack 集成 OpenDataLoader PDF从本地 PDF 到结构化 Document 的转换实战指南Haystack 集成 OpenDataLoader PDF从本地 PDF 到结构化 Document 的转换实战指南 本文围绕 Haystack 生态中的人工智能大模型RAGAI AgentNLPqpdf架构设计揭秘内容保持PDF转换的实现原理qpdf架构设计揭秘内容保持PDF转换的实现原理 QPDF是一个功能强大的 内容保持PDF文档转换器 它的架构设计巧妙平衡了PDF处理的灵活性与内容完整性。CLI开发工具上一篇鸣潮后台自动战斗与声骸托管 ok-ww 完整上手指南附避坑自查清单下一篇OpenAPI Tool Servers架构设计为什么OpenAPI是AI工具集成的未来创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
阅读完成 · 觉得有帮助？
