HarmonyOS鸿蒙Next ArkTS生成PDF文件

在鸿蒙（HarmonyOS）应用开发中，实现本地生成PDF文件主要有两种核心思路，可根据场景选择：

📄 方案一：使用PDF原生服务（适用于自定义内容） 通过@ohos.file.pdf模块直接创建PDF文档并添加内容（如图片/文本），适合需要精确控制PDF布局的场景。 实现步骤：

1. 创建PDF文档

   let pdfDocument = new pdfService.PdfDocument();
   pdfDocument.createDocument(width, height); // 单位：点（1英寸=72点）
   

2. 添加内容到页面

   const page = pdfDocument.getPage(0);
   // 添加图片（需先保存到沙箱）
   page.addImageObject(imagePath, x, y, width, height);
   

3. 保存PDF文件

   const sandboxPath = getContext().filesDir;
   const docPath = sandboxPath + "/output.pdf";
   pdfDocument.saveDocument(docPath); // 返回布尔值表示成功状态
   

⚠️ 关键注意事项：

• 图片处理：需先将图片保存到应用沙箱（使用getComponentSnapshot()截图 + saveImage()存本地）
• 坐标系统：原点(0,0)位于页面左下角（非左上角），布局时需注意Y轴计算
• 单位换算：推荐使用vp2px()/px2vp()处理像素与虚拟像素的转换

🌐 方案二：通过Web组件生成（适用于网页内容） 使用Web组件的createPdf()方法（API version 14+），适合将前端页面直接转为PDF。 实现步骤：

1. 配置PDF参数

   pdfConfig: webview.PdfConfiguration = {
     width: 8.27, // A4纸宽度(英寸)
     height: 11.69, // A4纸高度(英寸)
     margin: 0, // 页边距
     shouldPrintBackground: true
   }
   

2. 调用生成接口

   webviewController.createPdf(
     this.pdfConfig,
     (error, result: webview.PdfData) => {
       if (!error) {
         const pdfBuffer = result.pdfArrayBuffer().buffer;
         // 保存二进制数据到文件
       }
     }
   );
   

3. 写入沙箱文件

   import { fileIo as fs } from '@kit.CoreFileKit';
   let file = fs.openSync(filePath, fs.OpenMode.READ_WRITE | fs.OpenMode.CREATE);
   fs.write(file.fd, pdfBuffer);
   

⚠️ 关键注意事项：

• 权限要求：需在module.json5声明ohos.permission.INTERNET（网络资源适用）
• CSS优化：使用@media print媒体查询优化PDF打印样式
• 调试模式：开发阶段可启用setWebDebuggingAccess(true)，正式发布需移除

🧩 方案对比

推荐选择：

• 需要插入本地图片/自定义文本 → 方案一
• 已有现成Web页面需导出 → 方案二 两种方案均需操作应用沙箱路径（getContext().filesDir），生成后可通过@kit.ArkShare实现文件分享。

信息推荐

使用Web组件的PDF文档预览能力

pdf文档生成

使用Web组件保存前端页面为PDF

在HarmonyOS鸿蒙Next中使用ArkTS生成PDF文件，主要通过@ohos.file.fs和@ohos.pdf模块实现。首先创建并写入PDF内容，可设置页面大小、添加文本、图片等元素。使用pdf.createPdf初始化文档，通过pdf.PdfPage添加页面，并调用相关API插入内容。最后调用save方法保存文件至指定路径。需注意权限声明，确保应用有文件存储访问权限。