如何在Android中使用预定义PDF框架及Print-Spooler Api打印PDF文件

1. 使用Android预定义PDF框架完成PDF打印操作 #

Android 系统原生预定义的PDF处理框架为 PdfRenderer（API 21及以上支持），配合系统打印服务即可完成打印操作，步骤如下：

• 权限声明：读取本地PDF需要申请READ_EXTERNAL_STORAGE权限，Android 13及以上版本建议通过存储访问框架（SAF）获取PDF的Uri，避免动态权限适配问题
• 初始化PdfRenderer实例：仅支持处理可seek的文件描述符，代码示例：

// 从Uri获取可读文件描述符
val pdfFd = contentResolver.openFileDescriptor(targetPdfUri, "r") ?: return
val pdfRenderer = PdfRenderer(pdfFd)

• 实现自定义PrintDocumentAdapter：重写onLayout、onWrite方法，在onWrite逻辑中按打印参数的dpi、页面尺寸，逐页使用PdfRenderer渲染PDF内容到输出画布
• 提交打印任务：调用系统PrintManager触发打印流程：

val printManager = getSystemService(Context.PRINT_SERVICE) as PrintManager
printManager.print("PDF打印任务", YourCustomPrintAdapter(pdfRenderer), null)

• 注意：PdfRenderer 同一时间仅允许打开一个PDF页面，任务结束后需要主动关闭实例和文件描述符，避免内存泄漏。

2. 使用Print Spooler API实现PDF打印功能 #

Print Spooler是Android系统内置的打印假脱机服务，API 19及以上支持直接向其提交标准PDF文件完成打印，无需自行渲染PDF内容，步骤如下：

• 确认文件访问权限：保证你持有目标PDF文件的可读权限，优先使用SAF返回的Uri适配不同系统版本
• 实现轻量PrintDocumentAdapter：无需自行渲染PDF，仅需在onWrite方法中把源PDF的内容拷贝到系统提供的输出流即可，核心代码：

override fun onWrite(
    pages: Array<out PageRange>,
    destFd: ParcelFileDescriptor,
    cancelSignal: CancellationSignal,
    callback: WriteResultCallback
) {
    if (cancelSignal.isCanceled) {
        callback.onWriteCancelled()
        return
    }
    // 直接拷贝源PDF内容到打印输出流
    contentResolver.openInputStream(targetPdfUri)?.use { input ->
        FileOutputStream(destFd.fileDescriptor).use { output ->
            input.copyTo(output)
        }
    }
    callback.onWriteFinished(arrayOf(PageRange.ALL_PAGES))
}

• 触发打印任务：调用PrintManager的print方法提交任务后，系统会自动将PDF交给Print Spooler处理，用户可以在系统弹出的打印设置页选择打印机、调整打印参数
• 注意事项：
  • 提交的PDF必须是符合规范的文件，损坏的PDF会被Spooler直接拒绝
  • 部分定制ROM可能修改了Print Spooler的默认逻辑，建议提前做兼容性测试
  • 如需监听打印任务状态，可以注册PrintJobStateChangeListener接收任务成功、失败、取消的回调

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