PdfBox-Android 2.0.4版本添加注释无法在多阅读器显示问题求解

问题核心是新增注释未生成外观流（Appearance Stream）：Acrobat Reader会自动为缺失外观流的注释补全渲染逻辑，包括PdfBox自带渲染器在内的其他阅读器仅会读取已存在的外观流完成渲染，因此无法显示你添加的注释。

以下是2.0.4版本可直接落地的两种方案： #

方案1：手动为单个注释生成外观流 #

适合仅使用少量常用注释类型（文本注释、高亮、墨迹、形状注释等）的场景，无需修改库源码。

• 完成注释的所有属性（位置、颜色、内容、边框样式等）配置后，调用注释对象的setAppearance()方法写入手动构造的外观流即可
• 以高亮注释为例，参考代码如下：

// 已完成属性配置的高亮注释对象
PDAnnotationTextMarkup highlightAnnot = ...;
COSDictionary appearanceDict = new COSDictionary();
COSStream appearanceStream = new COSStream();

// 写入外观流内容，示例为黄色半透明高亮效果
try (OutputStream os = appearanceStream.createOutputStream()) {
    String appearanceContent = "q 0.75 0.75 0 rg 0.25 ca 0 0 " + highlightAnnot.getRectangle().getWidth() + " " + highlightAnnot.getRectangle().getHeight() + " re f Q";
    os.write(appearanceContent.getBytes(StandardCharsets.UTF_8));
} catch (IOException e) {
    e.printStackTrace();
}

// 将外观流绑定到注释
appearanceDict.setItem(COSName.N, appearanceStream);
highlightAnnot.setAppearance(appearanceDict);

• 其他类型注释的外观流语法可参考PDF规范对应章节，也可以直接摘抄高版本PdfBox对应注释的外观生成逻辑使用。

方案2：移植高版本外观生成逻辑到项目 #

如果需要支持多类型注释，手动构造外观流成本过高，可以直接把高版本PdfBox的外观生成逻辑抽入本地项目：

• 提取PdfBox 2.0.5及以上版本中org.apache.pdfbox.pdmodel.interactive.annotation包下的所有外观处理器相关类，这些类无额外2.0.4版本以外的依赖，直接复制到你的项目同包路径下即可
• 复制完成后即可直接调用constructAppearances()方法批量生成所有注释的外观流，用法和高版本PdfBox完全一致

额外注意事项 #

• 外观流需要在注释所有属性配置完成后生成，如果后续修改了注释的属性值，需要重新生成外观流才会生效
• 生成外观流后保存文档时，不要使用增量保存模式，否则外观流数据可能不会被完整写入最终文件

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