折叠屏适配,不只是让页面变宽。对即时通信应用来说,真正的挑战是窗口形态变化时,聊天、导航和用户状态能否保持连续。
用户在外屏打开会话并输入消息,展开设备后,界面可能从单列变为会话列表加聊天详情。如果仍按整块屏幕宽度计算聊天区域,气泡、菜单等内容可能失去合适的布局依据;如果切换时销毁并重建页面,草稿、光标、回复对象或阅读位置也可能受到影响。页面变了,用户的任务不应该被迫重来。

布局判断,应该跟随窗口而不是机型
固定机型或整机屏幕尺寸,不能准确代表当前业务页面可用的空间。折叠、展开、旋转以及分屏都会改变窗口形态;进入双栏后,聊天详情也只是窗口的一部分。若各组件继续分别依据整屏宽度计算,消息区域、菜单和键盘避让就可能出现判断不一致。
在网易云信 iOS IMUIKit Swift 的折叠屏适配中,我们以窗口实际尺寸、安全区和 size class 作为布局判断依据,并据此选择 Compact、Medium 或 Expanded 布局。折叠外屏保持单业务页形态;展开后可以呈现会话列表与聊天详情的双栏结构,由右侧导航 rail 承担模块切换。
双栏聊天,统一使用详情容器宽度
双栏界面中,聊天详情并不等于整块设备屏幕。网易云信通过 NEAdaptiveUIKit 的 NEChatViewport 统一提供当前详情内容宽度,使文本、富文本、Markdown、翻译、AI 流式以及图片、文件、语音、回复和 Reaction 等消息类型使用同一宽度依据。这样做的重点是统一布局事实源,减少各类消息组件独立推算所带来的差异。
窗口可以变化,会话状态要接得住
会话可能从列表、联系人、搜索、通知或机器人子会话打开。若每个入口维护各自的跳转流程,同一会话可能被重复创建,切换会话也可能让导航栈不断增长。网易云信的适配方案将会话打开逻辑收敛到统一流程:重复选择当前会话不重建页面;在 A、B 会话间切换时替换详情;若用户停留在设置、媒体等扩展页,再次选择当前会话会先回到聊天根页面。
窗口变化时,方案复用原有控制器并记录必要的展示状态,包括草稿、光标、回复对象、多选状态,以及会话贴底状态或历史消息的可见位置和偏移。折叠、展开或旋转不应因为布局改变而重新拉取历史消息、标记已读或强制滚动到底部。页面结构可以调整,但不应额外触发与用户当前操作无关的业务行为。
接入范围与验证边界
对于已经基于网易云信 IMUIKit Swift 构建的应用,可升级配套 UIKit 组件。接入可以从聊天模块开始,也可以启用完整的自适应外壳;方案支持通过开关回退旧容器结构,无需数据迁移。这些接入方式和低改动路径针对现有云信 UIKit 集成,不代表任意 iOS 应用都能不经改造直接获得折叠屏适配能力。
当前方案的测试包括 Duo 模拟器 XCTest 24 项通过、macOS 纯策略测试 18 项通过;Demo 覆盖 Normal 和 Fun 两套皮肤,并完成会话、通讯录、我的接入及横屏配置验证。这些数字描述的是相应模拟器、策略测试和 Demo 验证范围,不等于真实设备全场景覆盖,也不能据此推导性能提升或稳定性收益。具体项目仍需结合自身页面、业务状态和目标设备完成验证。
把连续体验作为适配验收条件
落地折叠屏适配时,建议先明确窗口变化中的业务不变量:哪些状态必须保留,哪些导航动作不能重复触发,聊天内容宽度由哪个容器提供,键盘和安全区由哪一层协调。然后围绕单栏、双栏、横屏,以及窗口折叠和展开的往返过程,逐项检查会话切换、阅读位置、输入状态与返回行为。
网易云信 IMUIKit Swift 的适配实践,将窗口作为布局判断依据,并通过统一的聊天容器宽度、会话打开流程和展示状态延续,处理折叠屏下布局与导航的连续性。组件机制提供基础,最终体验仍取决于应用自身的业务状态设计与完整验证。对 IM 应用而言,适配是否成功,不只看界面能否切换,更要看用户展开或折叠设备后,能否继续刚才的会话。