Skip to content
Demo示例FAQ

PDF 生成模板编辑器

开源可视化 PDF 生成引擎,支持自定义模板,并提供面向开发者的 API,灵活构建文档生成流程。

查看 GitHub
Android Guides Compress

PDF 压缩 ​

ComPDFKit_Tools 的 CPDFCompressDialog 提供文档选择、预设质量、自定义参数、输出目录及压缩进度界面。

显示对话框 ​

对话框会管理传入文档的生命周期,销毁时关闭该文档。使用独立文档实例,避免传入正在阅读或编辑的实例。以下代码在 Activity 中执行,pdfPath 为输入文件路径:

java
CPDFDocument compressionDocument = new CPDFDocument(this);
if (compressionDocument.open(pdfPath)
        == CPDFDocument.PDFDocumentError.PDFDocumentErrorSuccess) {
    CPDFCompressDialog dialog = new CPDFCompressDialog();
    dialog.setDocument(compressionDocument);
    dialog.setCompressDocumentListener((success, path, uri) -> {
        if (success) {
            // 通过输出 path 或 uri 打开结果文件。
        } else {
            // 压缩、保存或取消后未得到成功结果。
        }
    });
    dialog.show(getSupportFragmentManager(), "compress");
} else {
    compressionDocument.close();
}
kotlin
val compressionDocument = CPDFDocument(this)
if (compressionDocument.open(pdfPath) ==
    CPDFDocument.PDFDocumentError.PDFDocumentErrorSuccess) {
    val dialog = CPDFCompressDialog()
    dialog.setDocument(compressionDocument)
    dialog.setCompressDocumentListener { success, path, uri ->
        if (success) {
            // 通过输出 path 或 uri 打开结果文件。
        } else {
            // 处理未成功完成的情况。
        }
    }
    dialog.show(supportFragmentManager, "compress")
} else {
    compressionDocument.close()
}

CPDFCompressDialog 位于 com.compdfkit.tools.compress 包,CPDFDocument 位于 com.compdfkit.core.document 包。

选择压缩参数 ​

预设降采样阈值/目标 PPI图片质量参数
低质量120/9630
标准质量180/15045
高质量220/15075
自定义在自定义选项中设置在自定义选项中设置

预设参数用于控制图片重编码与采样,输出大小取决于源文件。不要将预设名称当作固定的压缩率或画质保证。

选择“自定义”后,可打开 CPDFCustomCompressOptionsDialog 调整图片质量、PPI、嵌入字体及内容清理规则。降采样阈值应大于目标 PPI。

可清理的内容包括表单动作、JavaScript、页面缩略图、书签、注释与表单、附件、文档信息及图层等。移除字体或业务内容可能改变文档显示与功能,保存前应确认选项。

输出与取消 ​

对话框在后台执行优化并显示进度;取消或关闭对话框会请求停止。结果通过 setCompressDocumentListener() 返回:

参数说明
success优化及输出流程是否成功
path成功结果的可打开路径
uri公共目录输出对应的 Uri,按实际返回值使用

仅在 success 为 true 时使用输出路径或 Uri。压缩成功会关闭传入的文档实例,继续操作时重新打开输出文件。失败或取消时,不把未完成的输出作为有效结果。

需要直接配置算法、颜色空间转换或读取详细优化结果,参见 压缩与优化 PDF 文件。