鸿蒙PDF编辑开发实战：文本、图片与批注处理

1. 鸿蒙PDF编辑实战：从入门到精通

作为一名在鸿蒙生态开发领域深耕多年的开发者，我经常被问到关于PDF文档处理的问题。PDF作为办公场景中最常用的文档格式之一，其编辑功能在实际开发中尤为重要。今天，我将分享鸿蒙PDF Kit在文本添加、图片插入和批注处理方面的完整解决方案。

PDF Kit是鸿蒙系统提供的一套强大的PDF文档处理框架，它封装了PDF文档的创建、编辑、渲染等核心功能。不同于简单的PDF阅读器，PDF Kit允许开发者在应用层实现对PDF内容的深度操作，这为办公类应用的开发提供了极大便利。

在开始之前，我们需要明确几个核心概念：

• PDF页面(PdfPage)：PDF文档的基本组成单位，每个页面独立维护自己的内容和批注
• 图形对象(GraphicsObject)：包括文本、图片等可视元素
• 批注(Annotation)：附加在文档上的标记和注释信息

2. 环境准备与基础配置

2.1 开发环境搭建

要使用PDF Kit功能，首先需要确保开发环境配置正确。在DevEco Studio中，我们需要在module.json5文件中添加必要的权限和依赖：

json复制{
  "module": {
    "requestPermissions": [
      {
        "name": "ohos.permission.READ_MEDIA",
        "reason": "读取PDF文件"
      },
      {
        "name": "ohos.permission.WRITE_MEDIA",
        "reason": "保存PDF文件"
      }
    ],
    "dependencies": [
      "@kit.PDFKit",
      "@kit.PerformanceAnalysisKit",
      "@kit.ArkUI"
    ]
  }
}

2.2 基础代码结构

创建一个基本的PDF编辑页面，我们需要先初始化PDF文档对象：

typescript复制import { pdfService } from '@kit.PDFKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { Font } from '@kit.ArkUI';

@Entry
@Component
struct PdfPage {
  private pdfDocument: pdfService.PdfDocument = new pdfService.PdfDocument();
  private context = this.getUIContext().getHostContext() as Context;

  aboutToAppear(): void {
    // 加载示例PDF文档
    let filePath = this.context.filesDir + '/input.pdf';
    this.pdfDocument.loadDocument(filePath);
  }
  
  // 后续代码将在这里添加
}

注意：在实际项目中，应该添加对文件是否存在的检查，以及错误处理逻辑。PDF文档操作可能会抛出各种异常，良好的错误处理是保证应用稳定性的关键。

3. 文本处理全攻略

3.1 文本添加详解

在PDF中添加文本看似简单，实则有很多需要注意的细节。PDF Kit提供了addTextObject接口，但它的使用有一些特殊限制：

typescript复制Button('添加文本')
  .onClick(async () => {
    try {
      let page: pdfService.PdfPage = this.pdfDocument.getPage(0);
      let textContent = '鸿蒙PDF Kit文本添加示例';
      
      // 字体配置是文本添加的关键
      let fontInfo = new pdfService.FontInfo();
      let font: Font = new Font();
      fontInfo.fontPath = font.getFontByName('HarmonyOS Sans')?.path;
      fontInfo.fontName = ''; // 留空表示使用fontPath指定的字体
      
      // 文本样式配置
      let style: pdfService.TextStyle = {
        textColor: 0x000000,  // 黑色文本
        textSize: 30,         // 字体大小
        fontInfo: fontInfo,   // 字体信息
        underline: false,     // 是否下划线
        strikeThrough: false  // 是否删除线
      };
      
      // 添加文本到指定位置(单位:点，1点=1/72英寸)
      page.addTextObject(textContent, 72, 72, style); // 距离左、下各1英寸
      
      // 保存文档
      let outPdfPath = this.context.filesDir + '/output.pdf';
      let result = this.pdfDocument.saveDocument(outPdfPath);
      
      hilog.info(0x0000, 'PdfPage', '文本添加%s', result ? '成功' : '失败');
    } catch (e) {
      hilog.error(0x0000, 'PdfPage', '添加文本失败: %s', JSON.stringify(e));
    }
  })

关键点解析：

1. 坐标系统：PDF使用左下角为原点的坐标系，y轴向上为正方向
2. 单位换算：默认使用点(point)作为单位，1点=1/72英寸≈0.35mm
3. 字体限制：必须使用系统已安装的字体，或者提供字体文件路径

3.2 多行文本处理方案

PDF Kit的addTextObject接口有一个重要限制：它不支持自动换行。这意味着长文本需要开发者手动处理换行逻辑。下面是一个实用的多行文本添加方案：

typescript复制function addMultiLineText(page: pdfService.PdfPage, text: string, x: number, y: number,