Aidoku阅读器双页模式下的页面缩放问题分析与解决

问题现象

在iPad设备上使用Aidoku阅读器的双页模式时，用户发现左右两页的缩放比例不一致。具体表现为：左侧页面通常能够填满其高度空间，而右侧页面则会出现上下留白的"信箱模式"(letterboxed)效果，导致阅读体验不连贯。

技术分析

经过代码审查，发现问题根源在于ReaderDoublePageViewController.swift文件中的UIStackView(页面堆栈视图)配置。原代码使用了.fillProportionally(按比例填充)作为分布方式，这种配置可能导致左右两个ReaderPageView实例被分配略微不同的宽度或高度。

解决方案

将pageStack的distribution属性从.fillProportionally修改为.fillEqually(等比例填充)。这一改动确保了两个页面视图能够获得相等的宽度分配，从而解决了显示不一致的问题。

修改后的关键代码如下：

pageStack.axis = .horizontal
pageStack.distribution = .fillEqually  // 修改此行
pageStack.alignment = .center

实现原理

在iOS开发中，UIStackView的distribution属性控制着其子视图的尺寸分配方式：

1. .fillProportionally：根据子视图的内容尺寸按比例分配空间
2. .fillEqually：强制所有子视图获得相同尺寸

在阅读器场景下，使用.fillEqually更为合适，因为它能保证左右页面获得完全相同的显示空间，符合用户对双页模式的预期。

注意事项

1. 使用.fillEqually后，如果两页合并的宽高比与设备屏幕不完全匹配，仍可能出现一定的信箱效果，这是正常现象
2. 此修改不会影响其他阅读模式的表现
3. 该解决方案已在iPad Pro 12.9"设备上通过实际测试验证

环境信息

• 测试设备：iPad Pro 12.9"
• 系统版本：iPadOS 18.4.1
• Aidoku版本：v0.6.11

这个问题的解决展示了在iOS界面开发中，正确选择容器视图的布局属性对于实现预期UI效果的重要性。通过简单的属性调整，就能显著改善用户体验。