福昕开发者文档中心

Office 转 PDF 示例配置与运行指南 (第三方引擎) ​

本指南将介绍如何配置和运行福昕 PDF SDK 的 Office 转 PDF 示例程序。开发者可以通过 Office 转 PDF 了解如何调用相关接口，使用此功能模块。

系统要求 ​

  • 平台： Windows, Linux (x86, x64 和 armv8)
  • 开发语言： C, C++, Python, Java, C#, Node.js
  • 授权许可： 包含 Conversion 模块的授权码
  • SDK 版本：
    • Word 和 Excel：SDK C++/C#/Java 7.3 或更高版本， SDK 7.4 或更高版本，SDK Python 8.3 或更高版本。
    • PowerPoint：SDK C/C++/C#/Java 7.4 或更高版本，SDK Python 8.3 或更高版本。
    • Word/Excel/PowerPoint：SDK Node.js 10.0 及更高版本。

运行环境要求 ​

在运行示例或调用相关模块类之前，请确保满足以下条件：

  • Windows 系统： 已安装 Microsoft Office 2007 或更高版本。
  • Excel 转换： 在将 Excel 文件转换为 PDF 之前，请确保已在 Windows 系统上设置默认打印机（虚拟打印机亦可）。
  • Linux x86/x64 系统： 已安装 LibreOffice。
  • Linux armv8 系统： 已安装金山 WPS 办公软件。
  • LibreOffice 兼容性： 使用 LibreOffice 7.0 或更高版本时，如果遇到 "An unknown error has occurred" 错误，请在运行程序前设置环境变量, 设置指令如下，其中，'x' 代表 LibreOffice 的版本号。
    sh
    export URE_BOOTSTRAP=vnd.sun.star.pathname:/opt/libreoffice7.x/program/fundamentalrc

LibreOffice 转 PDF 资源包获取 ​

福昕 Office 转 PDF 功能支持两种调用 LibreOffice 引擎的方式：

  • 直接调用 LibreOffice 引擎： 无需额外资源包，确保系统中已安装 LibreOffice 即可。不支持多线程转换。
  • 调用福昕提供的 LibreOffice 可执行程序： 需要下载福昕提供的专用资源包。专用资源包包含福昕优化的 LibreOffice 引擎，支持多线程转换。

资源包获取：

如需获取 LibreOffice 转 PDF 专用资源包，您可以：

  • 联系福昕技术支持或您的销售代表。
  • 从福昕官网直接下载。

Linux 平台转换引擎参数配置指南 ​

在 Linux 平台上使用 office 转 PDF 功能模块或运行示例时，需要正确配置 engine_path 参数，指定相应的引擎路径。以下是针对不同 Linux 架构的详细配置说明：

1. Linux x86/x64 架构：

  • 引擎类型： LibreOffice
  • 参数配置： engine_path 参数应设置为 LibreOffice 引擎所在的目录路径。
  • 路径查找： 您可以通过在终端执行以下命令查找 LibreOffice 引擎的完整路径：
    bash
    locate soffice.bin
  • 示例： 如果上述命令返回 /usr/lib/libreoffice/program/soffice.bin，则将 engine_path 参数设置为 /usr/lib/libreoffice/program。

2. Linux x86/x64 架构：

  • 引擎类型： 福昕专用 LibreOffice
  • 参数配置： engine_path 参数应设置为福昕专用 LibreOffice 引擎所在的目录路径。
  • 示例： 请参阅下方“配置示例程序”部分说明。

3. Linux armv8 架构：

  • 引擎类型： 金山 WPS Office
  • 参数配置： engine_path 参数应设置为 WPS 引擎库（librpcwpsapi.so）所在的目录路径。
  • 路径查找： 请手动查找 librpcwpsapi.so 文件所在的目录。
  • 示例： 如果 librpcwpsapi.so 文件位于 /opt/kingsoft/wps-office/office6 目录中，则将 engine_path 参数设置为 /opt/kingsoft/wps-office/office6。

示例运行指南 ( Linux X64 C++) ​

示例程序位置：

  • Libreoffice 转 pdf 示例程序位于 \examples\simple_demo\office2pdf 目录下。以下配置说明以 Linux X64 C++ 语言库为例。

引擎选择：

配置步骤：

  1. 构建 office2pdf 资源目录：

    • 将获取到的专用资源包解压至指定目录。
    • 解压后的目录结构应如下所示：
    x86/
├── fxoffice2pdf
x64/
├── fxoffice2pdf

    提示： 请根据您的操作系统架构选择相应的引擎文件。

  2. 配置示例程序：

    • 编辑 \examples\simple_demo\pdf2office\office2pdf.cpp 文件，配置示例程序。
    • 根据您的 CPU 架构，将 engine_path 参数设置为专用资源引擎目录下 x64/fxoffice2pdf 或 x86/fxoffice2pdf 的完整路径。
    c++
    WString engine_path = L"/resource-folder/x64/fxoffice2pdf"; // 请替换为正确的引擎路径。
foxit::addon::conversion::Convert::FromWord(word_file_path, L"", output_path, engine_path, word_convert_setting_data);

  3. 运行示例程序：