为Xcode 7/Swift 2旧项目添加iPhone X布局适配支持

刚帮朋友搞定过几乎一模一样的场景——Swift 2旧项目依赖多、架构复杂没法升级，在iPhone X上跑上下有黑边。其实不用动Swift版本，从启动资源配置和布局适配两个地方入手就能解决，核心原因是系统没识别到这是新设备，默认按iPhone 6/7/8的尺寸渲染了。

1. 先给项目添加iPhone X的启动资源（关键第一步） #

这是让系统识别设备尺寸的核心，有两种方式选一种就行：

方式一：用静态启动图 #

• 打开项目里的Assets.xcassets，右键新建Launch Image资产目录（如果之前没用到的话）
• 给这个目录添加iPhone X对应的启动图：尺寸是1125×2436像素（@3x），注意是竖屏方向
• 到项目target的General标签页，找到Launch Images Source，下拉选择你刚创建的这个Launch Image

方式二：改用LaunchScreen.storyboard（更推荐，后续适配新设备更省心） #

Xcode 7已经支持LaunchScreen了，比静态启动图灵活：

• 菜单栏选File > New > File，找到Launch Screen模板创建一个新的storyboard
• 在storyboard里给控件加自动布局约束：顶部控件绑定到Top Layout Guide，底部控件绑定到Bottom Layout Guide（Xcode 7里还没有Safe Area，用这个替代就行），背景图可以设置为edges贴紧superview
• 回到target的General标签，把Launch Screen File设置成你刚创建的这个storyboard

2. 调整视图控制器的布局适配 #

启动资源搞定后，还要确保你的页面布局能适配新的屏幕尺寸：

纯代码布局的情况 #

• 绝对不要用硬编码的frame值，比如CGRectMake(0, 20, 320, 548)这种老设备的固定尺寸
• 改用Auto Layout约束，或者用topLayoutGuide.length和bottomLayoutGuide.length计算可用区域：

  // 计算主视图的可用高度（排除状态栏和底部安全区域）
  let availableHeight = view.bounds.height - topLayoutGuide.length - bottomLayoutGuide.length
  // 用这个高度来设置内容视图的frame
  contentView.frame = CGRect(x: 0, y: topLayoutGuide.length, width: view.bounds.width, height: availableHeight)
  

XIB/Storyboard布局的情况 #

• 打开对应的布局文件，检查所有控件的约束：把顶部约束连到Top Layout Guide，底部约束连到Bottom Layout Guide，而不是固定到superview的边缘
• 全屏背景图可以设置为edges贴紧superview，确保铺满整个屏幕，其他交互控件基于布局指南定位，避免被顶部状态栏或底部Home Indicator遮挡

3. 验证适配效果 #

因为Xcode 7没有iPhone X模拟器，你需要用iPhone X真机测试：

• 把项目打包安装到iPhone X上，检查上下黑边是否消失
• 重点测试页面顶部（比如导航栏、状态栏）和底部（比如工具栏、按钮）的布局，确保没有被遮挡或留出过多空白

补充一句：这些操作完全不需要升级Swift版本，都是项目配置和布局层面的调整，不会影响原有代码的逻辑。如果项目里有第三方依赖，只要依赖用的是Auto Layout，基本不用改；少数硬写frame的依赖，可能需要微调一下布局代码，但大部分成熟的Swift 2时期的库已经支持自适应布局了。

内容的提问来源于stack exchange，提问作者ezkeemo