入门指南
双平台支持
福昕转换 SDK 提供全面的跨平台兼容性，完美支持 Windows 和 Linux 操作系统，确保您的应用在不同环境下均能稳定运行。
📦 下载 SDK
官方下载
- 官方网站下载： 访问福昕官方网站，选择并下载适合您项目需求的 SDK 版本。
包管理器集成
.NET 集成
bash
# NuGet 包管理器
Install-Package Foxit.PDFConversionSDK.DotnetNode.js 集成
bash
# npm 安装
npm i @foxitsoftware/foxit-pdf-conversion-sdk-node
# yarn 安装
yarn add @foxitsoftware/foxit-pdf-conversion-sdk-nodePython 集成
bash
# pip 安装
pip install FoxitPDFConversionSDKPython3
# 或使用 conda
conda install -c foxitsoftware foxit-pdf-conversion-sdk💻 示例工程
本地示例
- 工程示例: 请参阅 示例，了解如何构建和运行本地示例工程，快速上手 SDK 的集成和使用。
在线演示
- 在线转换演示：通过在线转换演示，体验基于
Node.js后端的实时文档转换功能，无需本地部署。
开发环境
🚀 快速环境检查清单
在开始使用福昕转换 SDK 之前，请确认您的开发环境满足以下要求：
编程语言支持
| 语言 | 版本要求 | 支持平台 |
|---|---|---|
| Node.js | v10-v20 | Windows, Linux |
| GO | Go 1.18+ | Linux |
| Python | 见下方版本兼容性表格 | Windows, Linux, ARM |
| C/C++ | 见下方编译器要求 | Windows, Linux, ARM |
| Java | 见下方编译器要求 | Windows, Linux, ARM |
| .NET Core | .NET Core 2.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 | ✔️ | ✔️ | 见上方版本兼容性表格 |
| 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 | 见上方版本兼容性表格 |
| Go | ✔️ | ✔️ | ❌ | 需要 Go 1.18+ |
| Node.js | ❌ | ✔️ | ❌ | 支持 v10-v20 |
| .NET Core | ❌ | ✔️ | ✔️ | 支持 .NET Core 2.1+ |
| .NET Framework | ❌ | ❌ | ❌ | 仅支持 Windows |
| Objective-C | ❌ | ❌ | ❌ | 仅支持 macOS |
编译器要求
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目录。