Flutter PDF项目：Pdftron/PSPDF注释无法在其他应用显示的问题排查

针对Pdftron包的解决方案 #

• 确保注释嵌入PDF文件：Pdftron默认可能将注释存储在独立的XFDF文件中，而非直接嵌入PDF本体。其他PDF应用通常只会读取PDF内部的注释，因此需要调用API将注释合并到PDF中：

  // 保存文档时包含注释
  await PdftronFlutter.saveDocument(
    document: _currentDocument,
    includeAnnotations: true,
  );
  

  如果之前是单独导出XFDF，需要手动将XFDF合并到PDF：

  // 导出标准XFDF
  String xfdf = await PdftronFlutter.exportAnnotations();
  // 将XFDF合并到PDF
  await PdftronFlutter.importAnnotations(xfdf, document: _currentDocument);
  await PdftronFlutter.saveDocument(document: _currentDocument);
  

• 导出标准XFDF格式：避免使用Pdftron自定义扩展的XFDF属性，确保导出的是符合ISO标准的XFDF。调用exportAnnotations时可指定参数禁用自定义属性：

  String standardXfdf = await PdftronFlutter.exportAnnotations(
    options: ExportAnnotationOptions(includeCustomProperties: false),
  );
  

针对PSPDFKit包的解决方案 #

• 嵌入注释到PDF：PSPDFKit同样可能默认将注释存在独立存储（如JSON或私有XFDF），需确保保存时将注释写入PDF：

  // 保存文档并嵌入注释
  await Pspdfkit.saveDocument(_documentPath, saveAnnotations: true);
  

• 检查注释存储模式：在初始化PSPDFKit时，设置注释存储为嵌入模式而非外部文件：

  await Pspdfkit.initialize(
    configuration: PspdfkitConfiguration(
      annotationStorageMode: AnnotationStorageMode.embedded,
    ),
  );
  

高亮注释仅部分显示的排查要点 #

• 验证坐标系统转换：PDF的坐标原点为左下角，而Flutter的坐标原点为左上角，添加注释时需正确转换Rect参数。例如：

  // 转换Flutter坐标到PDF坐标
  Rect pdfRect = Rect.fromLTWH(
    flutterRect.left,
    pdfPageHeight - flutterRect.bottom,
    flutterRect.width,
    flutterRect.height,
  );
  // 使用转换后的坐标添加高亮注释
  await PdftronFlutter.addHighlightAnnotation(pdfRect);
  

• 检查注释的边界框有效性：确保高亮注释的Rect完全覆盖目标文本段落，避免因边界框过小或偏移导致其他应用无法识别。

内容的提问来源于stack exchange，提问作者Abrar