打开一个PDF,翻两页,看看对不对,改一行代码,再打开一次。这个循环在开发MihirakiPDFViewer时成了日常——这是一款用来读自己扫描书籍的iPad PDF阅读器。
![]()
此前的工作集中在页间距、从右到左阅读和搜索高亮对齐上。问题在于,用随手正在读的那本书来验证修复有个硬伤:输入一直在变。下一次代码改动到底有没有保住刚检查过的行为,很难说清。
他需要的是设置已知、结果可预期的测试PDF。
文中记录的自动化测试结果,是在2026年8月到9月间用一台运行iOS 26.5的iPad(A16)模拟器跑出来的,与他在实体iPad上的日常测试是两回事。
先做一个能分享出去的文件
自己扫描的书适合在正常阅读中发现问题,却不适合跟源码一起发布、让别人复现同样的检查。他在Google Docs里做样张文档,导出成PDF,再用脚本设置不同的阅读方向和页面布局。
目标是让错误一眼可见。页码清晰编号,能暴露左右页对调;内容相同、阅读方向设置不同的文件,方便对比应用的行为。准备测试数据,本身成了开发的一部分。
阅读器靠PDF内部的信息判断阅读方向和页面布局,相关设置叫Direction和PageLayout。一个叫“right-to-left.pdf”的文件名,并不能证明文件里真的存了预期值。
于是检查被拆成三层:
- PDF里是否包含想要的设置?
- 应用是否正确识别了这些设置?
- 屏幕上最终的页面排列是否正确?
这三个问题答案各不相同。识别出从右到左的元数据,本身并不能证明阅读器打开在正确页码、或把每一页放在正确一侧。
测试文件覆盖两种阅读方向和六种布局设置,共12种组合;另有文件覆盖带独立封面与不带独立封面的页面配对。封面样例假定应用的封面设置为STANDARD——应用配置和文件本身同样重要。
还有一条边界要划清:在PDF里识别出连续布局设置,不等于应用复现了那种连续阅读模式。元数据识别的测试,就只能叫元数据识别的测试。
给搜索一个已知答案
找到几个结果,不足以验证搜索。读一本书时,他通常不知道某个词出现了多少次,一个看起来合理的计数可能掩盖漏匹配或重复匹配。
他准备了日文和英文的搜索PDF,里面词的已知出现次数是确定的,两个文件都是30页。准备原始开发文章时,他还核对了从PDF提取文本中的出现次数。
这样搜索就有了具体的比对对象:不问搜索是否找到了“很多”结果,而问它是否找到了预期的数量。这些检查用的是含可搜索文本的PDF,纯图像扫描是另一种输入,不能等同对待。
他还想测日常阅读中不太会遇到的状况。早前一份工作让他明白负载测试的分量,这次他让AI生成一个超过100MB、超过1000页的PDF。生成的文件实际为1100页、约153MB。
打开只是开始,还要看能不能持续翻页而不崩溃、不明显卡顿。搜索文件和这个大PDF对阅读器提出的要求不同:一个测大量搜索结果的处理,一个测大文档的打开与导航。
把请求写得足够具体
PDF备好后,他让AI添加测试或检查应用行为。开发记录里包含点名文件、描述预期输出的请求。对一个带独立封面的从右到左PDF,他指定了第一页以及后续跨页的左右排列。
两类测试分工不同:单元测试检查识别出的设置、搜索计数这类结果;UI测试操作应用并检查其最终状态。大PDF的UI测试检查文件大小和页数,打开它,然后连续滑动30次。搜索测试则检查预期匹配数,并在翻页时反复输入搜索词。
复查这些测试时冒出一个有用的细节:测试自身的检查也需要改进。反复搜索的UI测试被加强,用来确认页码指示器确实变了——发出翻页动作不够,测试需要导航确实发生的证据。
现在再做类似请求,他会先写下三件事:测试用哪个文件?它该做什么?什么可观察的结果算通过?这个结构在让AI写测试时有用,也让结果事后更容易解读。
通过的测试,范围有限
有些检查通过了,有些没有拿到确认的通过结果。30次滑动测试成功后,他进一步查了滑块能否在1100页的PDF里准确跳到某一页。这项工作涉及更多测试改动,包括处理跨页索引与PDF页数之间的差异、解析带千位分隔符的数字。后续运行没有得出最终通过的记录。
仅凭记录的退出码,并不能认定是应用本身出了问题。用同一个文件,不代表这些是同一个测试——翻页成功,不能证明滑块导航准确。
搜索结果也有边界。核对匹配数和页码变化,不能证明高亮对齐到了像素级;没有做逐像素的图像比对,大PDF检查也不包含数值化的内存测量。
通过的测试让人安心,但他也想说清这份安心建立在什么之上。测试从打开自己的书、感受应用开始;准备可分享的PDF,给了他一條更可重复的路径去检查具体行为。
有用的组合是:一个条件已知的小输入,一个动作和一个预期结果,一份包含仍未验证事项的结果记录。几页编号清晰的页面,能让布局问题更容易讨论;一个出现次数已知的搜索词,能把模糊印象变成可核对的结果。
AI帮忙造了数据和测试代码。哪些条件重要、什么算成功、结果能支撑多远的结论,仍然得由他来决定。
特别声明:以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布,本平台仅提供信息存储服务。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.