图形学图像处理【免费下载链接】mupdfmupdf mirror项目地址https://gitcode.com/gh_mirrors/mu/mupdf点击查看免费下载本篇基于 MuPDF 官方安装文档展开系统讲解从源码获取、Git 子模块初始化到 Windows / macOS / Linux 三大平台的构建方法、依赖包选择、构建产物验证与系统级安装的完整流程并结合仓库中 Makefile、Makerules、Makethird 的源码逻辑深入剖析构建系统的默认目标、产物目录、特性开关与第三方库探测机制帮助你在任何类 Unix 系统或 Windows 环境下独立完成 MuPDF 的编译、验证与部署。一、获取源码构建 MuPDF 有两条途径下载官方发布包release tarball适合只关心稳定版本、不想拉取全部子模块的用户。克隆 Git 仓库适合跟踪最新代码或需要定制构建选项的用户。如果使用本仓库的镜像地址克隆git clone https://gitcode.com/gh_mirrors/mu/mupdf cd mupdf必须初始化 Git 子模块从 Git 克隆时必须初始化子模块否则thirdparty/下的大量第三方依赖目录是空的构建会失败git submodule update --init --depth 1仓库根目录的 .gitmodules 声明了全部子模块覆盖 MuPDF 默认内嵌编译的第三方库包括子模块对应目录用途freetypethirdparty/freetypeTrueType/OTF 字体解析harfbuzzthirdparty/harfbuzz复杂文本 shapingzlibthirdparty/zlibFlate 压缩流libjpegthirdparty/libjpegJPEG 解码openjpegthirdparty/openjpegJPEG 2000 解码lcms2thirdparty/lcms2ICC 色彩管理jbig2decthirdparty/jbig2decJBIG2 解码mujsthirdparty/mujsPDF JavaScript 引擎brotlithirdparty/brotliBrotli 压缩流gumbo-parserthirdparty/gumbo-parserHTML5 解析EPUB/HTML 文档freeglutthirdparty/freeglutmupdf-gl 查看器窗口系统curlthirdparty/curl远程流支持tesseract / leptonica / zxing-cpp / zint同名目录OCR、条码按需启用在 Makethird 中可以看到这些目录的源码默认会被编进libmupdf-third.a静态库通过Makelists汇总因此子模块是否初始化直接决定构建能否成功。platform/win32/README.txt也明确提示 MSVC 工程 needs the thirdparty sources to be in place。二、构建系统速览Makefile、Makerules 与 MakethirdMuPDF 的类 Unix 构建由三个文件协作完成理解它们的分工是灵活定制构建的前提Makefile主入口。定义默认目标、输出目录、编译/链接命令、mutool与各查看器的链接规则、安装规则与清理规则Makerules构建配置。根据uname识别操作系统探测pkg-config可用的系统库设定debug/release/sanitize等构建模式的编译参数并处理各功能开关Makethird第三方库的编译规则决定每个依赖是源码内嵌编译还是链接系统库。几个关键的默认行为均以当前仓库源码为准# Makefile default: apps libs # 直接 make 的默认目标 ifndef build build : release endif OUT : build/$(build_prefix)$(build)$(build_suffix)见 Makefile#L5-L14、Makefile#L9也就是说直接执行make时产物默认落在build/release/目录——这正是官方安装文档中libraries and binaries in thebuild/release/directory的由来。build/前缀还可能因共享库构建sharedyesMakerules会插入shared-前缀或功能后缀如-tesseract、-barcode、-tofu见 Makerules#L61-L96而变化。构建目标家族Makefile#L476-L482目标产物libslibmupdf.a或.so/.dylib、libmupdf-third.a、商业库tools核心命令行工具mutoolappstools 查看器mupdf-x11、mupdf-gl取决于平台探测结果extra-apps额外工具muraster、mupdf-x11-curlalllibs apps extra-apps全量构建三、在 Windows 上构建官方文档给出了一条明确指引Windows 使用 Visual Studio 解决方案文件 platform/win32/mupdf.sln。该解决方案位于platform/win32/组织了一整套 Visual Studio 工程从源码结构看platform/win32/*.vcxproj文件列表主要包括库工程libmupdf、libthirdparty、libmupdf-pkcs7、libmuthreads、libresources、libfreeglut等工具工程mutool、muraster、mudraw、mupdf、mupdf-gl查看器、mupdf-curl、javaviewer等绑定工程mupdfcppC 绑定、mupdfpyswig/mupdfcsharpswigSWIG 绑定、storytest/searchtest等示例。实操要点先执行git submodule update --init --depth 1拉齐thirdparty/源码platform/win32/README.txt 有明确提示用 Visual Studio 打开platform/win32/mupdf.sln选择 Release 配置编译即可产物为 Windows 可执行文件mutool等工具同样是自包含的便携式二进制。四、在 macOS 上构建官方文档的结论是macOS 与 Linux 使用同一套 GNU makefile 构建make但需要注意两点所需系统库的组合可能不同默认不提供查看器viewer选项。源码可以印证并细化这一说明。Makerules 中对 Darwin 做了专门处理ifeq ($(OS),Darwin) LDREMOVEUNREACH : -Wl,-dead_strip SO : dylib共享库后缀为.dylib而非.so且 Makefile 中 Darwin 默认不设置 soname 版本链接USE_SONAME逻辑被ifneq ($(OS),Darwin)跳过编译工具链被固定为xcrun cc / ar / ld / ranlib即要求安装 Xcode 命令行工具libcrypto的探测依赖pkg-config若系统没有pkg-config构建系统会打印警告 No pkg-config found, install it for proper integration of libcryptoMakerules#L223-L243。macOS 通常通过 Homebrew 安装pkg-config、freetype等库后执行make即可。关于 GLUT/OpenGL 探测macOS 上 Makerules 直接启用系统框架-framework GLUT -framework OpenGL因此 GUI 查看器能否构建取决于本机 Xcode 框架环境这与默认无 viewer的官方表述一致。五、在 Linux以及 BSD 与 macOS上构建在 Linux / BSD 上构建入口就是官方文档给出的一条命令make查看器所需的 X11 与 OpenGL 依赖make的默认目标包含查看器apps而查看器的编译依赖 X11以及mupdf-gl需要的 OpenGL的开发头文件与库。构建系统通过pkg-config探测这些依赖是否就绪Makerules#L322-L343HAVE_X11pkg-config --exists x11 xext决定mupdf-x11是否参与构建HAVE_GLUTpkg-config --exists gl x11 xrandr并优先使用系统glut否则回退-lglut决定mupdf-gl是否参与构建此外还会探测libcurl、libcrypto 1.1.0等影响mupdf-x11-curl与 pkcs7 签名支持。若探测失败查看器会被自动排除而不是报错但如果你的目标就是获得完整构建建议在 Debian/Ubuntu 系发行版上安装官方文档原样给出的包列表具体包名随发行版而异sudo apt install xorg-dev libxcursor-dev libxrandr-dev libxinerama-dev sudo apt install mesa-common-dev libgl1-mesa-dev libglu1-mesa-dev补充说明即使不安装 freeglut 开发包mupdf-gl仍可能构建成功——因为 Makethird 默认把thirdparty/freeglut的源码内嵌编译只需系统提供gl/x11相关库即可。只构建库与命令行工具make tools如果只需要 MuPDF 库和命令行工具、不想要任何 GUI 查看器make tools从源码看tools目标只链接$(TOOL_APPS)即 source/tools/mutool.c 驱动的单一mutool多命令入口见 Makefile#L371-L384muraster属于extra-apps目标查看器属于apps目标均不在make tools范围内。六、验证构建产物构建完成后库与二进制位于build/release/目录。MuPDF 的工具和查看器是便携式可执行文件运行期不需要任何辅助文件因此可以直接从构建目录运行验证。官方文档给出的验证命令./build/release/mutool -v其背后逻辑在 source/tools/mutool.c#L154-L164当第二个参数是-v时程序向 stderr 打印mutool version FZ_VERSION。版本号定义在 include/mupdf/fitz/version.h#L25-L30当前仓库对应FZ_VERSION 1.29.0因此本仓库构建产物应输出mutool version 1.29.0不需要辅助文件这一特性也解释了 Makefile 的设计内嵌字体URW CFF、Noto、思源等通过objcopy转成 ELF 对象直接链入库文件Linux 上HAVE_OBJCOPY : yes见 Makerules#L247-L249 与 Makefile#L205-L260连运行时的resources/fonts目录都不需要。mutool本身是多命令分发器不带参数运行时列出全部子命令draw、convert、show、grep、extract、clean、create、merge、poster、run等见 docs/tools/mutool.md可作为后续功能验证的入口。七、在 Linux 上安装构建验证通过后官方文档给出两种安装方式。方式一手动拷贝二进制推荐快速验证由于工具是便携式可执行文件可以直接复制到任意PATH目录cp ./build/release/mutool ~/.local/bin/mutool方式二系统级安装make install如偏好将二进制、库和头文件一起装到系统目录make prefix/usr/local installprefix的默认值就是/usr/localMakefile#L465-L474所以直接make install等价。该目标的展开Makefile#L527为install-libs install-apps install-docs子目标动作默认目标路径prefix/usr/localinstall-libs安装libmupdf.*静态或共享与全部include/mupdf头文件lib/、include/mupdf/install-apps安装mutool及已构建的查看器bin/install-docs安装 man 手册、README/CHANGES、示例代码share/man/man1来自 docs/man 的mupdf.1、mutool.1、share/doc/mupdf相关目录变量bindir、libdir、incdir、mandir、docdir均默认派生自prefix也支持用DESTDIR做打包式重定向安装见 Makefile#L485-L526。八、进阶构建选项官方文档只覆盖最常用路径而构建系统实际暴露了相当丰富的定制维度以下均以当前仓库 Makerules 与 Makefile 为准。构建模式buildMakerules#L154-L199 定义了各模式对应的编译参数常用入口有make debug、make release、make sanitizeMakefile#L603-L608模式关键参数适用场景release默认-O2 -DNDEBUG链接期剔除死代码--gc-sections/-dead_strip生产使用debug-g断点调试small-Os体积敏感sanitize/sanitize-release-fsanitizeundefined,address,leak内存错误排查profile-pggprof 性能分析coverage-fprofile-arcs -ftest-coverage覆盖率统计native-marchnative本机极限性能功能开关在 make 命令行传递即可裁剪或扩展功能Makerules#L14-L102变量效果brotlino关闭 Brotli 解码-DFZ_ENABLE_BROTLI0mujsno关闭 PDF JavaScript-DFZ_ENABLE_JS0htmlno关闭 HTML/EPUB/FB2/Markdown 引擎及 harfbuzz/gumbo/cmark 依赖xpsno/svgno关闭 XPS / SVG 文档格式extractno关闭 DOCX/ODT 输出tesseractyes启用 Tesseract OCR需 leptonica 与 tesseract产物目录追加-tesseract后缀barcodeyes启用 zxing-cpp 条码识别产物目录追加-barcode后缀tofuyes只嵌入 Noto 兜底字体显著减小字体数据体积sharedyes构建共享库build/shared-release等目录注意 Makefile#L21-L24 的提示不要在 make 命令行直接覆盖CFLAGS/LDFLAGS/LIBS应使用XCFLAGS、XLDFLAGS、XLIBS等增量变量否则 makefile 内的同名单元会被静默忽略。第三方库策略源码内嵌 vs 系统库默认情况下freetype、zlib、libjpeg、openjpeg、lcms2、mujs、harfbuzz 等全部从thirdparty/源码内嵌编译这也是子模块必须初始化的原因。若系统已装好对应开发库可用USE_SYSTEM_LIBSyes切换为系统库链接Makethird#L3-L21 会逐项打开USE_SYSTEM_*开关各库的探测逻辑如pkg-config --exists freetype2 18.3.12集中在 Makerules#L255-L320。平台与交叉编译目标除了原生构建Makefile 还提供了javaJNI/Java 平台对应platform/java、wasmWebAssembly对应platform/wasm与androidndk-build使用platform/java/Android.mk目标Makerules#L361-L407 定义了OSwasm/OSwasm-mt/OSpyodide三套 emscripten 交叉编译配置并提示交叉编译前需先执行make generate生成内嵌字体等生成文件。此外make clean/make nuke分别清理build/mode与整个build/目录。九、常见问题速查现象原因与处理make报第三方库源码缺失未执行git submodule update --init --depth 1对照 .gitmodules 检查thirdparty/各目录是否为空构建产物里没有mupdf-x11/mupdf-glpkg-config未探测到x11 xext或gl x11 xrandr安装上文列出的 X11/Mesa 开发包后重新makemacOS 提示缺少 pkg-config安装 Homebrew 版pkg-config及 freetype 等库libcrypto 集成依赖 pkg-config 探测修改了CFLAGS却无效果改用XCFLAGS等增量变量见 Makefile#L21-L24 注释产物不在build/release/检查是否叠加了sharedyes或tesseract/barcode/tofu等导致build_suffix/build_prefix变化按以上流程完成后你应当已经具备 MuPDF 的完整本地能力build/release/mutool可执行任意文档查看、转换与编辑子命令libmupdf与include/mupdf下的头文件可用于开发上层应用make prefix/usr/local install则可将整套工具链纳入系统PATH长期使用。赞分享图形学图像处理【免费下载链接】mupdfmupdf mirror项目地址https://gitcode.com/gh_mirrors/mu/mupdf点击查看免费下载相关推荐MuPDF 安装与编译指南在 SumatraPDF 仓库中从源码构建 PDF 引擎与 mutool 工具链MuPDF 安装与编译指南在 SumatraPDF 仓库中从源码构建 PDF 引擎与 mutool 工具链 导读 本文围绕 ext/mupdf/docs/gu桌面应用文档EOSIO 源码手动编译完整指南依赖安装、CMake 构建与多平台实操EOSIO 源码手动编译完整指南依赖安装、CMake 构建与多平台实操 本篇技术指南面向高级开发者系统讲解如何跳过一键脚本、以手动方式从源码编译 EOSIO区块链Shotcut 源码构建完全指南依赖解析、CMake 配置、跨平台编译与安装Shotcut 源码构建完全指南依赖解析、CMake 配置、跨平台编译与安装 本文以仓库根目录的 README.md https://link.gitcode音视频视频桌面应用视频处理创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考