入门指南
双平台支持
福昕转换 SDK 提供全面的跨平台兼容性，完美支持 Windows 和 Linux 操作系统，确保您的应用在不同环境下均能稳定运行。
下载 SDK
福昕开发中心
- SDK 获取： 请通过 福昕开发中心 申请试用或获取下载指引，或联系福昕技术支持团队与销售代表，获取适合您项目需求的 SDK 版本。
包管理器集成
.NET 集成
bash
# NuGet 包管理器
Install-Package Foxit.PDFConversionSDK.Dotnet
Node.js 集成
bash
# npm 安装
npm i @fuxinsoft/foxit-pdf-conversion-sdk-node
# yarn 安装
yarn add @fuxinsoft/foxit-pdf-conversion-sdk-node
Python 集成
bash
# pip 安装
pip install FoxitPDFConversionSDKPython3
# 或使用 conda
conda install -c foxitsoftware foxit-pdf-conversion-sdk
示例工程
本地示例
- 工程示例: 请参阅 示例，了解如何构建和运行本地示例工程，快速上手 SDK 的集成和使用。
在线演示
- 在线转换演示：通过在线转换演示，体验基于
Node.js后端的实时文档转换功能，无需本地部署。
环境要求说明
阅读前请先确定两点：使用的编程语言，以及目标运行环境是 Windows 还是 Linux。
- 语言与运行时要求：按语言列出版本要求；Python 另附与 SDK 版本的对应关系。
- 操作系统与平台支持：按 Windows、Linux 分别给出系统版本、架构，并以表格说明各语言在不同平台上的支持情况（含编译器与依赖说明）。
语言与运行时要求
快速环境检查清单
在开始使用福昕转换 SDK 之前，请确认您的开发环境满足以下要求：
编程语言支持
| 语言 | 版本要求 | 支持平台 |
|---|---|---|
| Node.js | v10-v20 | Windows, Linux |
| GO | Go 1.18+ | Linux |
| Python | 见下文 Python 版本兼容性 | Windows, Linux, ARM |
| C/C++ | 见下文 Linux 编译器要求 | Windows, Linux, ARM |
| Java | 见下文 Linux 编译器要求 | Windows, Linux, ARM |
| .NET Core | .NET Core 2.1+（Linux ARM 需 3.1+） | Windows, Linux, ARM |
| .NET Framework | .NET Framework 4.0+ | Windows |
Python 版本兼容性
| SDK 版本 | Python 2.7 | Python 3.6-3.10 | Python 3.11+ (ABI3) |
|---|---|---|---|
| Conversion SDK < 3.0 | 支持 | 支持 | 不支持 |
| Conversion SDK 3.0+ | 支持 | 支持 | 支持 |
操作系统与平台支持
Windows 环境配置
系统要求
- 操作系统: Windows Vista, 7, 8, 10, 11 (32-bit 和 64-bit)
- 服务器系统: Windows Server 2003, 2008, 2012, 2016, 2019, 2022 (32-bit 和 64-bit)
编程语言支持
| 编程语言 | Windows x86 | Windows x64 | 备注 |
|---|---|---|---|
| C/C++ | 支持 | 支持 | 支持 Visual Studio 2010+ |
| Java | 支持 | 支持 | 支持 JDK 8+ |
| .NET Framework | 支持 | 支持 | 需要 .NET Framework 4.0+ |
| .NET Core | 支持 | 支持 | 支持 .NET Core 2.1+ |
| Python | 支持 | 支持 | 见上文 Python 版本兼容性 |
| Node.js | 支持 | 支持 | 支持 v10-v20 |
| Objective-C | 不支持 | 不支持 | 仅支持 macOS |
注意：
- SDK 仅支持 Windows 8/10 经典样式桌面应用，不支持 Store APP 和 Universal App
- 如果您使用低版本 Windows 系统，可能需要安装 D3DCOMPILER_47.dll
Linux 环境配置
系统要求
- 架构支持: Linux x86/x64, ARM v7/v8
- 发行版: Ubuntu 14.04.6，Ubuntu16.04，Ubuntu 20.04 等发行版
编程语言支持
| 编程语言 | Linux x86 | Linux x64 | Linux ARM | 备注 |
|---|---|---|---|---|
| C/C++ | 支持 | 支持 | 支持 | 需要 GCC ≥ 5.4 支持 cmake ≥ 3.1 |
| Java | 支持 | 支持 | 支持 | 需要 JDK 8+ |
| Python | 支持 | 支持 | 支持 ArmV8 | 见上文 Python 版本兼容性 |
| Go | 支持 | 支持 | 不支持 | 需要 Go 1.18+ |
| Node.js | 不支持 | 支持 | 不支持 | 支持 v10-v20 |
| .NET Core | 不支持 | 支持 | 支持 | x86/x64: .NET Core 2.1+ ARM:.NET Core 3.1+ |
| .NET Framework | 不支持 | 不支持 | 不支持 | 仅支持 Windows |
| Objective-C | 不支持 | 不支持 | 不支持 | 仅支持 macOS |
Linux 编译器要求
GCC 版本要求：
- SDK 8.4+ 版本：GCC ≥ 4.9.4 或 libstdc++.so.6 ≥ 6.0.20
- SDK 11.0+ 版本：GCC ≥ 5.4 或 libstdc++.so.6 ≥ 6.0.20
各架构最低版本要求：
| 架构 | 工具链 | GLIBC | 备注 |
|---|---|---|---|
| Linux x86/x64 | GCC ≥ 5.4 | GLIBC ≥ 2.17 | 推荐使用最新稳定版本 |
| Linux ARM v7 | ARM GCC ≥ 8.3 | GLIBC ≥ 2.28 | 需要 ARM 交叉编译工具链 |
| Linux ARM v8 | ARM GCC ≥ 8.3 | GLIBC ≥ 2.27 | 需要 AArch64 交叉编译工具链 |
提示：
bash# 检查 GCC 版本 gcc --version # 检查 GLIBC 版本 ldd --version # 检查 libstdc++ 版本 strings /usr/lib/x86_64-linux-gnu/libstdc++.so.6 | grep GLIBCXX
包结构说明
福昕转换 SDK 提供了适用于 Windows 和 Linux 平台的库文件。请注意，不同编程语言的库可能包含不同的目录和文件。
核心目录
| 目录 | 内容 | 说明 |
|---|---|---|
| doc | API手册和开发者指南 | 包含完整的API文档和使用说明 |
| examples | 示例代码 | 包含多个子目录的示例项目 |
| FoxitPDFConversionSDKPython2 | Python 2.7 库文件 | 仅 Python 库包含此目录 |
| include | C/C++ 头文件 | 仅 C/C++ 库包含此目录 |
| lib | SDK 库文件和授权文件 | 支持 x86 和 x64 CPU 架构 |
| res | 配置文件和资源文件 | 字体和排版相关资源 |
示例目录结构
examples/
├── pdf2office demo/ # PDF 转 Office 示例代码
└── office2pdf demo/ # Office 转 PDF 示例代码（仅 Windows）
资源目录结构
res/
├── metrics_data/ # PDF2Office 排版度量数据（v2.1+ 已内置）
└── office2pdf/ # Office2PDF 排版资源文件
提示：从 v2.1 版本开始，度量数据已包含在动态库中，无需手动配置
metrics_data目录。