如何在 iOS 项目中集成 MuPDF 1.3

Question

iOS 有内置的 PDF 渲染引擎，但它不能解决“透明度扁平化”问题。因此，我尝试将 MuPDF 1.3 集成到项目中。 我尝试使用参考 MuPDF 项目，但失败了。 然后我为每个架构构建调试静态库，并使用“库搜索路径”和“其他链接标志”来分隔链接库，同时构建不同架构的二进制文件，但 XCode 一直显示“架构 armxxx 的未定义符号”。 最后，我构建了 MuPDF 的发布版静态库，它应该兼容所有架构，XCode 仍然显示和以前一样的东西。 有没有人成功集成和编译 MuPDF 1.3？请给我一些提示。 非常感谢。

Answer 1

很抱歉回答迟了，但它可以帮助人们一天或一天​​。 由于我必须将 MuPDF 库集成到我的 (Swift) 项目之一中，因此我生成了 静态 fat 库并将它们集成到 Xcode 中。

这里有一个分步快速教程：

如何构建静态fat库：

1. git clone --recursive git://git.ghostscript.com/mupdf.git
2. 转到mupdf/platform/ios
3. 用 Xcode 打开 MuPDF.xcodeproj。
4. 将 MuPDF 目标的方案配置为 Release。
5. 在 iPhone 模拟器上构建和运行应用程序。
   • 这将为i386 和x86_64 平台生成库
6. 在真正的 iPhone 设备上构建和运行应用程序 - 使用您自己的捆绑包 ID、证书和配置文件。
   • 这将为armv7 和arm64 平台生成库
7. 转到mupdf/build/
   • 您将找到两个文件夹，其中包含所有已构建的库：release-ios-i386-x86_64 和 release-ios-armv7-arm64
8. 现在您需要为 mupdf 及其所有依赖项创建包含所有 4 种架构的胖库。

lipo -create ./*/libcurl.a -output 'libcurl.a' ; lipo -create ./*/libfreetype.a -output 'libfreetype.a' ; lipo -create ./*/libjbig2dec.a -output 'libjbig2dec.a' ; lipo -create ./*/libjpeg.a -output 'libjpeg.a' ; lipo -create ./*/libmujs.a -output 'libmujs.a' ; lipo -create ./*/libmupdf.a -output 'libmupdf.a' ; lipo -create ./*/libopenjpeg.a -output 'libopenjpeg.a' ; lipo -create ./*/libz.a -output 'libz.a'

如何将 MuPDF 集成到您的项目中：

1. 添加/导入到您的项目中：
   • 来自mupdf/include/mupdf 的所有头文件
   • 来自mupdf/platform/ios/classes 的所有 obj-c 类
   • 来自mupdf/platform/ios 的 common.[h,m] 文件
2. 添加/导入之前生成的fat库（8个文件）
3. 通过添加库文件的路径来配置Library Search Path。
   • 例如$(inherited) $(PROJECT_DIR)/External/MuPDF/lib/

您现在应该可以使用包含的库构建和运行您的应用了。 使用示例项目了解库的工作原理或任何在线教程。

专业提示：

最终的胖库非常大（~ 46mb）。 您可以通过导入轻松减小应用的最终大小：

1. 在发布文件夹下，只有来自 mupdf/build/release-ios-armv7-arm64 的 lib.a
2. 在调试文件夹下，来自mupdf/build/ 的大型生成胖库
3. 为Debug 和Release 配置设置不同的Library Search Path。

完成后，您将能够在每个模拟器和设备上在Debug 上构建和运行。但仅适用于Release 的设备。您最终需要哪个作为您的应用程序，通过 AppStore 应该只在真实设备上运行。无需包含调试模拟器架构静态库。

这是我 Xcode 项目中所有导入文件的屏幕截图：

Answer 2

最简单的方法可能是使用我刚刚创建的MuPDF CocoaPod。有一个example application based on that pod。