PDF随身工具箱SDK(鸿蒙版):高效便捷的PDF处理解决方案

随着移动办公的普及,用户对于随时随地处理文档的需求日益增长。PDF作为最常用的文档格式之一,其处理需求尤为突出。然而,在鸿蒙生态系统中,缺乏轻量级且功能全面的PDF处理工具。

基于这一背景,我开发了这款PDF随身工具箱SDK,这是一款专为鸿蒙生态设计的PDF处理工具,它针对HarmonyOS进行了专门优化,提供轻量化API接口,让开发者能够便捷地实现各种PDF处理功能。

环境要求

开发环境

  • DevEco Studio 5.0或以上版本

运行环境

  • 最低要求:HarmonyOS 5.0
  • 建议配置:HarmonyOS 5.1或更高版本

如何使用

1. 下载SDK包

访问下载页面,下载最新版本的Pdftoolbox-X.X.X.har包,并将其放入项目的libs文件夹内。

2. 申请API密钥

  1. 访问开发者控制台注册账号

    image-20250318161420900

  2. 在控制台中点击"管理API密钥"按钮
  3. 创建新的API密钥并妥善保存(密钥仅会显示一次)

    image-20250318161445165

3. 添加依赖

在项目的oh-packages.json5文件中,添加SDK依赖:

"dependencies": {
  // ...其它依赖
  "@foxhank/pdftoolbox": "file:./libs/PDFToolboxSDK.har",
  // ...其它依赖
}

然后点击IDE上方的"Sync Now"进行同步。

4. 申请权限

SDK需要以下权限:

权限名称权限描述使用时段
ohos.permission.INTERNET用于与服务器通信Always
ohos.permission.READ_MEDIA用于读取要处理的文件Inuse
ohos.permission.WRITE_MEDIA用于写入文件Inuse

在项目入口的module.json5中申请这些权限。

5. 初始化SDK

有两种方式初始化SDK:

方式一:通过工厂函数创建实例

import { createPdfToolbox } from '@foxhank/pdftoolbox';

// 创建SDK实例
const pdfToolbox = createPdfToolbox('您的API密钥');

// 使用SDK实例
pdfToolbox.pdf2Word().convert();

方式二:直接实例化构建

import { PdfToolbox } from '@foxhank/pdftoolbox';

// 创建SDK实例
const pdfToolbox = new PdfToolbox('您的API密钥');

// 使用SDK实例
pdfToolbox.pdf2Word().convert(/* ... */);

自定义配置选项

import { createPdfToolbox } from '@foxhank/pdftoolbox';

// 创建带配置选项的SDK实例
const pdfToolbox = createPdfToolbox('您的API密钥', {
  timeout: 120000, // 请求超时时间(毫秒),默认60000(60秒)
  debug: true // 开启调试模式,会输出详细日志
});
注意:调试模式仅供开发调试使用,正式环境下请关闭此功能。

主要功能

该SDK提供了丰富的PDF处理功能,包括但不限于:

  • 格式转换:PDF转Word、Excel、PPT、图片等
  • 多语言翻译:支持PDF文档的多语言翻译
  • 文档操作:合并、拆分、压缩PDF文件等功能

详细API文档可参考开发文档中的PDF转化部分、PDF翻译部分、PDF操作部分。

联系我

如果在使用过程中遇到任何问题,欢迎通过邮件联系我:summer76527@163.com

我将尽力为您解决使用中的问题。同时,也非常欢迎您提出宝贵的建议和反馈,共同探讨如何让产品变得更好。


版本信息:PDF随身工具箱SDK(鸿蒙版) V1.0.0