Objective-C老旧项目适配iOS 11、iPhone X及Storyboard重构咨询

嘿，我刚好处理过类似的老Objective-C项目迁移，给你梳理一套实操性强的步骤，帮你平稳完成iOS 11/iPhone X适配+Storyboard迁移的任务：

别着急直接动Storyboard——先让现有纯代码布局在新系统上跑顺，后续迁移才不会乱：

• 适配iPhone X安全区域：原来的topLayoutGuide/bottomLayoutGuide在iOS 11里被safeAreaLayoutGuide替代了。如果用Auto Layout，把原来关联导航栏/底部的约束改成关联view.safeAreaLayoutGuide的对应锚点，比如：

  // 旧代码（iOS 10及以下）
  [NSLayoutConstraint constraintWithItem:myButton 
                               attribute:NSLayoutAttributeTop 
                               relatedBy:NSLayoutRelationEqual 
                                  toItem:self.topLayoutGuide 
                               attribute:NSLayoutAttributeBottom 
                              multiplier:1.0 
                                constant:16.0];
  
  // 适配iOS 11+的新写法
  [NSLayoutConstraint constraintWithItem:myButton 
                               attribute:NSLayoutAttributeTop 
                               relatedBy:NSLayoutRelationEqual 
                                  toItem:self.view.safeAreaLayoutGuide 
                               attribute:NSLayoutAttributeTop 
                              multiplier:1.0 
                                constant:16.0];
  

  如果是用frame布局，要手动获取安全区域内边距调整控件位置：

  UIEdgeInsets safeInsets = self.view.safeAreaInsets;
  myButton.frame = CGRectMake(16, safeInsets.top + 16, self.view.bounds.size.width - 32, 44);
  

• 修复iOS 11的ScrollView/TableView布局问题：iOS 11后UIScrollView的contentInsetAdjustmentBehavior默认是automatic，如果原来代码手动调整过contentInset，大概率会出现内容偏移。可以在初始化时设置：

  self.tableView.contentInsetAdjustmentBehavior = UIScrollViewContentInsetAdjustmentNever;
  

• 全设备测试：在iPhone X、iPhone 8、iPad等模拟器上跑现有代码，修复所有控件遮挡、布局错位的问题，确保基础功能正常。

一次性把所有控制器换成Storyboard很容易出乱子，建议逐个迁移：

• 搭建基础Storyboard框架：
  1. 新建Main.storyboard，默认Size Class选Any/Any（后续针对iPad调整）。
  2. 在Info.plist里把Main storyboard file base name改成新建的Storyboard，设置它为项目入口。
  3. 添加初始ViewController，关联到你原来的根控制器类（比如HomeViewController）。
• 单个控制器迁移流程：
  1. 挑一个简单的控制器（比如设置页、列表页），在Storyboard里拖一个对应的ViewController，设置好Storyboard ID（比如SettingsVC），并指定类名和原来的Objective-C类一致。
  2. 把原来代码里创建子视图、设置布局的逻辑，搬到Storyboard里：拖入对应控件，添加Auto Layout约束（完全对应原来代码里的布局逻辑）。如果原来用frame，要转换成Auto Layout约束，确保在不同设备上自适应。
  3. 迁移导航逻辑：原来的[self.navigationController pushViewController:vc animated:YES]可以改成Storyboard Segue（直接拖线关联两个控制器，设置Segue类型），或者用代码从Storyboard获取控制器：

     UIStoryboard *mainSB = [UIStoryboard storyboardWithName:@"Main" bundle:nil];
     SettingsViewController *vc = [mainSB instantiateViewControllerWithIdentifier:@"SettingsVC"];
     [self.navigationController pushViewController:vc animated:YES];
     

  4. 测试迁移后的控制器：确保功能、布局和原来完全一致，再继续下一个。
• iPad适配优化：利用Size Classes，在Storyboard里切换到Regular Width/Regular Height（iPad的尺寸类），调整控件的大小、位置或者stack view的轴方向，比如把iPhone上的垂直stack改成iPad上的水平stack，保证iPad布局合理。

• 清理冗余代码：当一个控制器完全迁移到Storyboard后，删除原来代码里创建视图、设置布局的代码，只保留业务逻辑（比如网络请求、数据处理、事件响应）。
• 统一Storyboard管理：所有控制器迁移完成后，检查所有Segue的跳转逻辑、ViewController的类名和Storyboard ID是否匹配，清理Storyboard里无用的控件和约束。
• 全面回归测试：在iOS 11及以上的iPhone（含iPhone X）、iPad模拟器/真机上测试所有功能，确保布局正常、无崩溃、逻辑正确。

• Objective-C与Storyboard完美兼容：Xcode 9.3对Objective-C和Storyboard的配合支持很完善，拖线关联IBOutlet/IBAction时，确保类文件是.h和.m，关联后会自动生成代码。
• Storyboard里的安全区域设置：给控件加约束时，选择相对于Safe Area的约束，而不是Superview，这样自动适配iPhone X的安全区域。
• 版本控制很重要：用Git分支管理迁移过程，或者定期备份项目，避免修改出错无法回滚。

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