入门指南
安装并集成Foxit PDF Conversion SDK非常简单。本手册将提供SDK包的简要介绍。本章的主要内容是介绍系统要求、SDK包结构、以及如何运行demo和初始化Foxit PDF Conversion SDK。
系统要求
| 平台 | 系统要求 | 备注 |
|---|---|---|
| Windows | Windows Vista, 7, 8, 10 (32-bit 和 64-bit) Windows Server 2003, 2008, 2012 (32-bit 和 64-bit) | 仅支持 Windows 8/10经典样式，不支持Store APP和 Universal App。 |
| Linux | x86/x64 (32-bit 和64-bit OS) armv7/armv8 Foxit PDF Conversion SDK for Linux（x86和x64）支持的最低GCC编译器版本为gcc4.9.4。 | 所有的Linux (x86/x64) 示例在 Ubuntu14.0 32/64 bit上进行过测试。所有的 Linux (armv7/armv8) 示例都在armv7或者armv8系统中进行过测试。 |
TIP
- 从1.1版本开始，Foxit PDF Conversion SDK支持基于机器学习的识别功能，可以识别PDF文档中的无边框表格。默认情况下，该功能是禁用的，如果想要启用它，请首先确保网络是连接的。
- 当前，PDF2Office支持Windows和Linux平台，Office2PDF只支持Windows平台。
Windows
在本手册中，图片上面高亮的矩形区域指的是SDK的版本号，当前SDK的版本是2.0，则其代表2_0。
包结构说明
下载Foxit PDF Conversion SDK for Windows C++ API zip包，解压到一个新的目录如 "foxitpdfconversionsdk_2_0_win"。 其中解压包中包括如下的内容：
| 目录 | 功能 |
|---|---|
| doc | API手册，开发者指南 |
| examples | 示例demo |
| include | Foxit PDF Conversion SDK API的头文件 |
| lib | SDK库和授权文件 |
| res | 与字体相关的配置文件 |
TIP
- "res\metrics_data" 包含了用于在将PDF转换为Office文档时模拟Office格式排版过程所需的文件。
- "res\office2pdf" 包含了用于在将Office转换为PDF文档时模拟Office格式排版过程所需的文件。
运行demo
在 "examples" 文件夹下，Foxit PDF Conversion SDK 提供了一个pdf2office 和office2pdf demo。在Visual Studio中运行这两个demo，您可以按照如下的步骤：
在 "\examples\simple_demo" 文件夹下，根据您Visual Studio的版本双击 "simple_demo_vs2010.sln" 或者 " simple_demo_vs2015.sln" 或者 "simple_demo_vs2017.sln" 或者 “simple_demo_vs2019.sln” 或者 “simple_demo_vs2022.sln”。
单击 "Build > Build Solution" 编译这两个demo。或者，如果您只想编译单个demo，您可以右击该demo工程，然后选择 "Build" ，或者在该demo工程的文件夹下双击"*.vcxproj"，然后编译该工程。
编译后，在 "\examples\simple_demo\bin" 文件夹下将生成 ".exe" 可执行文件。可执行文件的名称取决于工程编译的配置。对于office2pdf demo，您需要将 " res\office2pdf" 文件夹下的所有文件拷贝到 "\examples\simple_demo\bin" 文件夹下。
运行某个特定的可执行文件，只需要双击即可。
在"\examples\simple_demo\output_files" 文件夹下将生成以该demo名称命名的文件夹，输出文件 (Word, Excel, PowerPoint 或者 PDF) 将会在该文件夹下生成。
TIP
如果您需要查看详细的执行过程，您可以在命令行中运行。启动 “cmd.exe”，导航到 "\examples\simple_demo\bin" ，然后运行可执行文件。*
Linux
在本手册中，图片上面高亮的矩形区域指的是SDK的版本号，当前SDK的版本是2.0，则其代表2_0。
包结构说明
Linux for x86/x64
下载Foxit PDF Conversion SDK zip for Linux (x86/x64) C++包，解压到一个新的目录如 "foxitpdfconversionsdk_2_0_linux" 。其中解压包中包括如下的内容：
| 目录 | 功能 |
|---|---|
| doc | API手册，开发者指南 |
| examples | 示例demo |
| include | Foxit PDF Conversion SDK API的头文件 |
| lib | SDK库和授权文件 |
| res | 与字体相关的配置文件 |
TIP
- "res\metrics_data" 文件夹下包含了metrics data文件，其用于在转换中模拟Office格式文档排版过程。
Linux for armv7/armv8
下载Foxit PDF Conversion SDK zip for Linux armv7/armv8 C++ API包，解压到一个新的目录如 "foxitpdfconversionsdk _2_0_linux_arm"。其中解压包中包括如下的内容：
| 目录 | 功能 |
|---|---|
| doc | API手册，开发者指南 |
| examples | 示例demo |
| include | Foxit PDF Conversion SDK API的头文件 |
| lib | SDK库和授权文件 |
| res | 与字体相关的配置文件 |
TIP
"res\metrics_data" 文件夹下包含了metrics data文件，其用于在转换中模拟Office格式文档排版过程。
运行demo
在 "examples" 文件夹下，Foxit PDF Conversion SDK 提供了一个pdf2office demo。在运行demo之前，请确保您已经正确配置环境，并且已安装CMake 3.1或更高版本。
以下列举了当前Foxit PDF Conversion SDK发布版本所支持的最低版本列表：
| OS | Tool chain | GLIBC |
|---|---|---|
| Linux x86/x64 | gcc 4.9.4 | GLIBC_2.17 |
| Linux armv7 | gcc-arm-8.3-2019.03-x86_64-arm-linux-gnueabihf | GLIBC_2.28 |
| Linux armv8 | gcc-arm-8.3-2019.03-x86_64-aarch64-linux-gnu | GLIBC_2.27 |
在终端窗口中运行demo，您可以按照如下的步骤：
打开一个终端，导航到 "foxitpdfconversionsdk_2_0_linux/examples/simple_demo" for Linux x86/x64, 或者 " foxitpdfconversionsdk_2_0_linux_arm/examples/simple_demo" for Linux armv7/armv8;
输入
./RunDemo.sh pdf2office以运行demo。输出文件 (Word, Excel, 和PowerPoint) 将会生成在 "\examples\simple_demo\output_files\pdf2office" 文件夹下。
初始化
在调用任何APIs之前，应用程序必须使用license授权码初始化Foxit PDF Conversion SDK 库。试用license文件在 "lib" 文件夹下。
C++
const char* sn = " ";
const char* key = " ";
foxit::ErrorCode code = Library::Initialize(sn, key);
if (code != foxit::e_ErrSuccess) {
return FALSE;
}TIP
参数 "sn"的值在 "conversionsdk_sn.txt" 中 ("SN="后面的字符串)，"key" 的值在 "conversionsdk_key.txt" 中 ("Sign="后面的字符串)。*