本文详解如何使用 Android 官方 PdfDocument API 将 ListView（或更推荐的 RecyclerView）中的全部数据准确、分页地渲染并保存为标准 PDF 文件，并提供可直接运行的完整实现逻辑与关键注意事项。
本文详解如何使用 android 官方 `pdfdocument` api 将 listview（或更推荐的 recyclerview）中的全部数据准确、分页地渲染并保存为标准 pdf 文件，并提供可直接运行的完整实现逻辑与关键注意事项。
在 Android 开发中，直接将 ListView 内容“保存为 PDF”并非调用某个现成方法即可完成——因为 ListView 本身是 UI 组件，不具备序列化为 PDF 的能力；而您当前代码中尝试用 ObjectOutputStream 序列化列表项到 .txt 文件，本质上生成的是二进制对象流（非人类可读，更非 PDF），这与目标完全偏离。
✅ 正确路径是：将 ListView 中的数据（即 barcodelist）提取出来，使用 android.graphics.pdf.PdfDocument 手动绘制文本内容到 PDF 页面上。Android 自 5.0（API 21）起原生支持 PDF 生成，无需第三方库，安全、轻量、兼容性好。
✅ 推荐做法：基于数据而非视图绘制 PDF
不要试图“截图”或“遍历 ListView 的 View 对象”——这些 View 可能未完全布局、高度不可控，且 PdfDocument 无法直接绘制 View。应直接操作数据源（如您的 barcodelist），逐行绘制文字：
private void saveListViewAsPdf() {
// 1. 创建 PDF 文档
PdfDocument pdfDocument = new PdfDocument();
Paint paint = new Paint();
paint.setTextSize(14f);
int margin = 56; // 左/上边距（单位：px）
int lineHeight = 60; // 行高（px）
// 2. 遍历数据，按页面容量分页
int pageIndex = 0;
int yPos = margin;
for (int i = 0; i 842 - margin) {
if (pageIndex > 0) pdfDocument.finishPage(pdfDocument.getPage(pageIndex - 1));
PdfDocument.PageInfo pageInfo = new PdfDocument.PageInfo.Builder(595, 842, ++pageIndex).create();
PdfDocument.Page page = pdfDocument.startPage(pageInfo);
yPos = margin; // 新页重置 Y 坐标
}
// 在当前页绘制条码文本
page.getCanvas().drawText("Barcode: " + item, margin, yPos, paint);
yPos += lineHeight;
}
// 完成最后一页
if (pageIndex > 0) {
pdfDocument.finishPage(pdfDocument.getPage(pageIndex - 1));
}
// 3. 保存到外部存储（需动态权限）
File file = new File(getExternalFilesDir(null), "barcodes_export.pdf");
try (FileOutputStream fos = new FileOutputStream(file)) {
pdfDocument.writeTo(fos);
Toast.makeText(this, "PDF saved to: " + file.getAbsolutePath(), Toast.LENGTH_LONG).show();
} catch (IOException e) {
Toast.makeText(this, "Save failed: " + e.getMessage(), Toast.LENGTH_SHORT).show();
e.printStackTrace();
} finally {
pdfDocument.close();
}
}
⚠️ 关键注意事项
-
权限要求：Android 10+ 需声明
android.permission.READ_MEDIA_DOCUMENTS或使用getExternalFilesDir()（如上例）避免运行时权限；若存至公共目录（如Environment.getExternalStoragePublicDirectory()），需额外申请WRITE_EXTERNAL_STORAGE（API ≤ 28）或适配分区存储（API ≥ 29）。 -
ListView vs RecyclerView：正如官方建议，
RecyclerView更现代、灵活，支持 ViewHolder 复用与复杂布局；若您后续升级，可复用相同数据源（barcodelist）无缝迁移 PDF 导出逻辑。 -
字体与样式：
PdfDocument.Canvas仅支持基础Paint属性（字号、颜色、粗细），不支持富文本。如需条码图片、表格或中文排版优化，建议集成iText7或Apache PDFBox（需注意许可协议）。 -
性能提示：对超长列表（>1000 条），建议添加进度对话框或后台线程处理（
AsyncTask已弃用，推荐Coroutine或ExecutorService）。
✅ 总结
导出 ListView 数据为 PDF 的本质是「数据驱动绘制」——放弃对 UI 控件的依赖，专注结构化数据（ArrayList<string></string>）的分页计算与 Canvas 文本渲染。以上方案零第三方依赖、符合 Android 最佳实践，且易于扩展（如添加标题、时间戳、页眉页脚）。只需将 saveListViewAsPdf() 方法绑定到您的 btnok.setOnClickListener 中，即可一键生成专业 PDF 报告。
