WebView的createPrintDocumentAdapter()是Android上最可靠的HTML转PDF方案，需等待onPageFinished、设置viewport和UTF-8编码；iOS须用WKWebView+UIPrintPageRenderer+UIGraphicsPDFRenderer组合实现。
Android 上用 WebView 打印 HTML 生成 PDF 最可靠
安卓原生不提供直接的 html → pdf 转换 API，但 WebView 的 createPrintDocumentAdapter() 是目前最稳定、无需权限、不依赖网络的方案。它本质是调用系统打印服务，把网页“渲染成 PDF”，兼容 Android 4.4+，且能保留 CSS 样式和基础交互（如折叠/展开）。
常见错误现象：onWrite() 回调里输出空文件、PDF 里文字乱码、图片不显示、页面截断在第一屏。
- 必须等
WebView完全加载完成再调用打印——监听onPageFinished()，别用onPageStarted() - 确保 HTML 中有明确的
<meta name="viewport">，否则移动端缩放错乱，PDF 排版崩溃 - 不要在
WebView外层套ScrollView或自定义缩放逻辑，会干扰打印布局计算 - 中文需在 HTML 中显式声明
<meta charset="UTF-8">，否则部分旧机型导出为方块
iOS 上 WKWebView + UIPrintPageRenderer 是唯一可行路径
iOS 没有公开的 HTML 渲染转 PDF 接口，WKWebView 本身不支持导出，必须走系统打印栈：用 UIPrintPageRenderer 配合 WKWebView 的 scrollView 内容截取，再用 UIGraphicsPDFRenderer 合成。过程绕但可控，不触发 App Store 审核风险。
使用场景：需要离线生成、带页眉页脚、分页控制（比如每章一页）。
立即学习“前端免费学习笔记（深入）”；
-
webView.scrollView.contentSize必须大于 0，否则渲染区域为空——务必等webView didFinishNavigation后再读取 - 不能直接对
webView截图，要通过render(in:)把内容画进 PDF context，否则高清屏下模糊或偏移 - 页边距、页眉高度必须手动算进
paperRect和printableRect，差 1pt 就可能丢内容 - CSS 中的
@page规则（如@page { size: A4; margin: 2cm; }）在 iOS 上基本被忽略，别依赖
第三方库如 wkhtmltopdf 在手机上基本不可用
虽然 wkhtmltopdf 命令行在桌面端成熟，但在移动平台：Android 上需交叉编译 ARM 二进制并打包进 APK，体积暴增 10MB+，且常因 SELinux 策略被拒执行；iOS 更严格，App 不允许 dlopen 动态库或 fork 子进程，直接排除。
替代方案如 android-pdfview 或 PDFKit 只能显示 PDF，不能生成；jsPDF + html2canvas 在手机上性能极差，长页面内存溢出、缩放失真、CSS 支持残缺，仅适合单屏简单卡片。
- 看到 “支持移动端” 的 npm/cocoapods 库，先查它底层是否调用了系统 WebView 或 Print API——没调用的，基本是 demo 级
- 任何声称“一行代码转 PDF”的 SDK，大概率是上传 HTML 到它服务器处理，隐私和网络依赖无法回避
- Flutter 插件如
pdf或printing底层仍是调用原生 WebView 打印，只是封装了桥接，没绕过上述限制
生成 PDF 后的文件路径和权限容易被忽略
Android 输出路径必须是应用私有目录（如 getCacheDir()）或通过 MediaStore 保存到相册，写入 /sdcard/ 直接失败（Android 10+ Scoped Storage）；iOS 必须用 NSTemporaryDirectory() 或 Documents 目录，写入沙盒外路径会静默失败。
- Android 生成后记得调用
MediaScannerConnection.scanFile()，否则文件不会出现在系统文件管理器里 - iOS 上若用
UIDocumentInteractionController预览 PDF，路径必须是file://开头且文件存在，临时路径过期会导致预览空白 - PDF 文件名含中文时，Android 建议用
URLEncoder.encode(name, "UTF-8")编码，iOS 对 UTF-8 文件名支持良好，但避免/ \ : * ? " |
真正难的不是“怎么点一下生成”，而是让 PDF 在不同机型、不同系统版本、不同屏幕密度下都保持样式一致——这取决于你对 WebView 渲染边界和系统打印栈的理解深度，而不是选哪个库。
