福昕开发者文档中心

快速开始 ​

本页说明如何获取并接入 福昕 PDF/OFD SDK 精简版，以及如何运行随包示例。精简版仅支持 C++，操作系统为 Windows 与 Linux。产品定位见 概述。

获取与解压 ​

  1. 通过 福昕开发中心 申请试用，或联系福昕技术支持 / 销售获取精简版发布包。
  2. 解压后得到与 zip 主名一致的目录。中国区包名示例：
    • Windows：foxit_pdf_ofd_sdk_mini_{version}_win.zip
    • Linux x86_64：foxit_pdf_ofd_sdk_mini_{version}_linux64.zip
    • Linux LoongArch64：foxit_pdf_ofd_sdk_mini_{version}_linux_loongarch64.zip

请选用与目标平台匹配的发布包。

包结构 ​

目录 / 文件说明
include/C++ 头文件（精简版能力范围以本目录为准）
lib/库文件与试用授权文件
examples/simple_demo/示例：ofd_render、pdf2image（Windows 为 VS 工程；Linux 为 CMake / RunDemo.sh）
doc/接口参考（若与 include/ 不一致，以 include/ 为准）
release_note.txt发版说明
legal.txt法律声明

Windows 库文件（lib/） ​

文件说明
fsdk_win32_mini.lib / fsdk_win32_mini.dllWindows x86
fsdk_win64_mini.lib / fsdk_win64_mini.dllWindows x64
gsdk_sn.txt / gsdk_key.txt试用授权（SN= / Sign= 后的字符串）

Linux 库文件（lib/） ​

以 Linux x86_64 精简版为例：

文件说明
libfsdk_linux64_mini.so动态库
gsdk_sn.txt / gsdk_key.txt试用授权（SN= / Sign= 后的字符串）

其他 Linux 架构若单独发版，库文件名以该包 lib/ 目录为准。

初始化库 ​

在调用任何精简版接口之前，须使用有效授权码初始化：

c++
#include "common/fs_common.h"

using namespace foxit;
using foxit::common::Library;

// sn：gsdk_sn.txt 中 SN= 后的字符串
// key：gsdk_key.txt 中 Sign= 后的字符串
ErrorCode code = Library::Initialize(sn, key);
if (code != e_ErrSuccess) {
  return 1;
}

// … 业务逻辑 …

Library::Release();

更多试用与授权说明可参考全功能库文档 试用与授权（授权文件路径与库文件名以精简版发布包为准）。

Windows：用 Visual Studio 运行示例 ​

  1. 进入 examples/simple_demo/。
  2. 按本机 VS 版本打开对应解决方案，例如：
    • simple_demo_mini_vs2022.sln
    • simple_demo_mini_vs2019.sln
    • 另有 vs2017 / vs2015 / vs2010 解决方案。
  3. 选择平台（Win32 或 x64）与配置（Debug / Release），生成并运行：
    • ofd_render：OFD 渲染出图
    • pdf2image：PDF 转图片

示例工程已配置链接 fsdk_win32_mini / fsdk_win64_mini。运行前请确认可执行文件能加载同架构的 fsdk_*_mini.dll（可将 lib/ 下对应 DLL 复制到输出目录，或将 lib/ 加入 PATH）。

输入文件位于 examples/simple_demo/input_files/；输出默认写入 examples/simple_demo/output_files/ 下以示例名命名的子目录。

Windows：新建工程接入 ​

  1. 将精简版 include/、lib/ 拷贝到工程可访问的位置。
  2. 在工程属性中增加头文件目录：指向 include/。
  3. 链接对应库：fsdk_win32_mini.lib 或 fsdk_win64_mini.lib。
  4. 运行时提供同架构的 fsdk_*_mini.dll。
  5. 在入口代码中 #include 所需头文件，调用 Library::Initialize / Library::Release。

也可在源文件中按架构指定库，例如：

c++
#if defined(_WIN64)
#pragma comment(lib, "fsdk_win64_mini.lib")
#elif defined(_WIN32)
#pragma comment(lib, "fsdk_win32_mini.lib")
#endif

（库搜索路径需已包含精简版 lib/。）

Linux：用 CMake / 脚本运行示例 ​

环境要求（与随包 examples/simple_demo/readme.md 一致）：

  • CMake ≥ 3.1
  • GCC（建议与全功能库 Linux 要求一致，如 gcc ≥ 5.4、对应 GLIBC）

在 examples/simple_demo/ 下执行：

bash
# 编译并运行 OFD 渲染示例
chmod +x RunDemo.sh
./RunDemo.sh ofd_render

# 编译并运行 PDF 转图片示例
./RunDemo.sh pdf2image

RunDemo.sh 会调用 CMake 生成可执行文件。在 Linux x86_64 上，生成名形如：

  • ofd_render_linux64
  • pdf2image_linux64

随包 CMakeLists.txt 会优先链接精简版库（若存在 libfsdk_linux64_mini.so，则使用该库，而非全功能库的 libfsdk_linux64.so）。

运行时需能加载 lib/ 下的 .so（脚本通常在当前目录执行；若找不到库，可将 SDK 的 lib/ 加入 LD_LIBRARY_PATH，或在链接时设置 rpath）。

输入 / 输出路径约定与 Windows 相同：input_files/、output_files/<示例名>/。

也可手动编译单个示例：

bash
cmake . -DPRJ_NAME=ofd_render
make
./ofd_render_linux64

Linux：新建工程接入 ​

  1. 将精简版 include/、lib/ 放到工程可访问的位置。
  2. 编译时增加 -I<path-to-include>。
  3. 链接 libfsdk_linux64_mini.so（或对应架构的 _mini 库），例如：
bash
g++ -std=c++11 your_app.cpp \
  -I/path/to/include \
  -L/path/to/lib -lfsdk_linux64_mini \
  -Wl,-rpath,/path/to/lib \
  -lpthread -o your_app
  1. 入口代码中调用 Library::Initialize / Library::Release。

全功能库 Linux C++ 工程组织方式可参考 C++（Linux/Mac） 与 Linux 平台，库文件名需改为精简版包内实际名称（带 _mini）。