本文介绍在 android 中将超出单页高度的视图（如长列表或报表）智能分割为多个 a4 尺寸 pdf 页面的方法，核心是避免简单裁剪位图，而是通过动态测量与布局重排实现语义合理、可读性强、支持文本缩放的高质量分页 pdf 生成。
本文介绍在 android 中将超出单页高度的视图（如长列表或报表）智能分割为多个 a4 尺寸 pdf 页面的方法，核心是避免简单裁剪位图，而是通过动态测量与布局重排实现语义合理、可读性强、支持文本缩放的高质量分页 pdf 生成。
在 Android 中使用 PdfDocument 生成 PDF 时，若直接将整个 View 渲染为一张超长位图再绘制到 PDF 页面，会导致内容被强行压缩或截断，且生成的 PDF 不可选中文本、无法缩放、文件体积大、打印效果差。真正健壮的解决方案是绕过位图中转，直接将 View 分段绘制到 PDF Canvas 上——即“Draw Direct”策略。
✅ 推荐方案：动态分页布局 + 直接绘制（Draw Direct）
该方法将原始内容拆解为多个独立子 View（如 TextView、LinearLayout 行项等），通过精确测量其高度，按 A4 页面可用高度（约 842 px @ 72 dpi）进行逻辑分页，再逐页重新布局并绘制到 PDF Canvas。
? 关键尺寸说明（标准 A4，72 dpi）
- 宽度：595 px（对应 210 mm × 72 / 25.4 ≈ 595）
- 高度：842 px（对应 297 mm × 72 / 25.4 ≈ 842）
⚠️ 注意：
PdfDocument.PageInfo.Builder的单位是像素（px），非毫米或英寸，必须基于目标 DPI 换算；Android 默认使用 72 dpi，因此 A4 对应595×842。
? 实现步骤（含关键代码）
-
准备可复用的子 View 列表
将待导出的内容组织为List<view></view>（例如每行一个TableRow或自定义CardView），确保每个 View 可独立测量与绘制：List<view> pageItems = new ArrayList(); // 示例：动态构建 10 个 TextView 作为内容项 for (int i = 0; i </view>
-
创建临时 LinearLayout 用于分页布局
此 Layout 不添加到 Activity 视图树，仅用于离屏测量与布局：LinearLayout tempLayout = new LinearLayout(this); tempLayout.setOrientation(LinearLayout.VERTICAL); tempLayout.setLayoutParams(new ViewGroup.LayoutParams( ViewGroup.LayoutParams.WRAP_CONTENT, ViewGroup.LayoutParams.WRAP_CONTENT)); -
逐页填充、测量、绘制
使用累计高度控制分页逻辑，每次只添加不超过A4_HEIGHT的子项：final int A4_WIDTH = 595; final int A4_HEIGHT = 842; int currentPage = 1; int startIndex = 0; while (startIndex A4_HEIGHT) { break; // 超出则停止添加 } } // 将本页子项加入临时布局 for (int i = startIndex; i -
保存 PDF 文件
最后调用document.writeTo(...)并关闭文档：private void createFile() { try { File file = new File(getExternalFilesDir(null), "report.pdf"); FileOutputStream fos = new FileOutputStream(file); document.writeTo(fos); document.close(); fos.close(); Toast.makeText(this, "PDF saved: " + file.getAbsolutePath(), Toast.LENGTH_LONG).show(); } catch (IOException e) { e.printStackTrace(); Toast.makeText(this, "Save failed", Toast.LENGTH_SHORT).show(); } }
⚠️ 注意事项与最佳实践
-
避免
getBitmapFromView()：位图方案会丢失文本矢量信息，导致 PDF 模糊、不可搜索、体积膨胀。 -
字体与样式需显式设置：离屏 View 不继承 Activity 主题，建议统一设置
Typeface、textSize、padding等。 -
处理复杂控件：
RecyclerView、WebView等需先setDrawingCacheEnabled(true)并调用buildDrawingCache()，但更推荐替换为静态 View 列表。 -
DPI 一致性：若需更高精度（如 300 dpi 打印），需同步调整 A4 尺寸（
2480×3508 px）并确保所有measure()使用相同MeasureSpec。 - 内存优化：对超长列表，可分批加载子 View，避免 OOM。
✅ 总结
真正可靠的多页 PDF 生成，不在于“切图”，而在于“分段布局 + 精确测量 + 直接绘制”。通过将内容抽象为可测量的 View 序列，并利用 measure()/layout()/draw() 三步法控制每页渲染范围，既能保证语义完整性（如文本不断行、表格不割裂），又能获得小体积、可搜索、高保真的 PDF 输出。此方案已广泛应用于报表导出、电子发票、课程讲义等生产场景。
